OpenAI: Run Assistant“
- Zuletzt aktualisiert2024/10/31
OpenAI: Run Assistant“
Die OpenAI: Run Assistant-Aktion nutzt die Assistants-API (v2) von OpenAI, damit Sie KI-Assistenten in Ihren eigenen Anwendungen erstellen können. Ein Assistent verfügt über Anweisungen und kann Modelle, Tools und Wissen nutzen, um Nutzeranfragen zu beantworten. Die Assistants-API v2 unterstützt derzeit drei Arten von Werkzeugen: Codedolmetscher, Dateisuche und Funktionsaufruf.
Vorbereitungen
- Sie benötigen die Bot Creator-Rolle, um die Aktion „OpenAI Run Assistant“ in einer Automatisierung zu verwenden.
- Vergewissern Sie sich, dass Sie über die erforderlichen Anmeldedaten zum Senden einer Anfrage verfügen und OpenAI: Aktion „Authentifizieren“ eingeschlossen haben, bevor Sie eine OpenAI-Aktion aufrufen.
- Verständnis der Einschränkungen des Assistenten: Wenn Sie die Fähigkeiten und Grenzen des Assistenten kennen, können Sie realistische Erwartungen stellen.
Dieses Beispiel zeigt, wie Sie einen vorhandenen Assistenten in die Aktion „OpenAI Run Assistant“ laden und eine entsprechende Antwort erhalten. Wenn Sie wissen möchten, wie Sie Ihren eigenen Assistenten erstellen können, lesen Sie OpenAI Create Assistant.
Prozedur
-
Geben Sie die folgenden Felder ein oder wählen Sie sie aus:
-
Klicken Sie auf Assistenten laden, um einen vorhandenen Assistenten auszuwählen. Sie müssen sich mit dem API-Schlüssel authentifizieren (siehe OpenAI: Aktion „Authentifizieren“).
- Mit Open AI verbinden wird angezeigt. Sie können den API-Schlüssel entweder über einen gespeicherten Berechtigungsnachweis auf der Registerkarte Anmeldedaten eingeben oder die Registerkarte Unsichere Zeichenfolge wählen, um den API-Schlüssel direkt einzufügen.
- Die Assistenten-ID des ausgewählten Assistenten wird im Feld Assistenten-ID angezeigt.
Anmerkung: Die Grenzen eines Assistenten zu kennen, bevor Sie ihn auswählen, ist entscheidend für ein reibungsloses Nutzererlebnis. Stellen Sie sich vor, Sie bitten um eine Flugreservierung und müssen feststellen, dass der Assistent keinen Zugang zu den Buchungssystemen hat. Wenn Sie sich im Vorfeld mit den Fähigkeiten des Assistenten vertraut machen, können Sie solche frustrierenden Szenarien vermeiden.
-
Klicken Sie auf Assistenten laden, um einen vorhandenen Assistenten auszuwählen. Sie müssen sich mit dem API-Schlüssel authentifizieren (siehe OpenAI: Aktion „Authentifizieren“).
Das folgende Beispiel zeigt, wie Sie einen Assistenten mit aktiviertem Codedolmetscher verwenden, um die ersten acht Elemente der Fibonacci-Folge zu erzeugen.
Die Antwort auf die oben genannte Automatisierung lautet wie folgt:
{
"metadata": {},
"data": [
{
"role": "assistant",
"content": [
{
"type": "text",
"text": {
"value": "The first 8 terms of the Fibonacci sequence are: \n\n\\[0, 1, 1, 2, 3, 5, 8, 13\\]",
"annotations": []
}
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": {
"value": "The Fibonacci sequence is a series of numbers where each number is the sum of the two preceding ones, starting from 0 and 1. Let's generate the first 8 terms of the Fibonacci sequence.",
"annotations": []
}
}
]
}
],
"status": "completed"
}Das folgende Beispiel zeigt, wie Sie den Assistenten bei aktivierter Dateisuche verwenden können. In diesem Szenario liest der Assistent die angehängte Datei, um die Antwort zu erzeugen.
Die Antwort auf die oben genannte Automatisierung lautet wie folgt:
{
"metadata": {},
"data": [
{
"role": "assistant",
"content": [
{
"type": "text",
"text": {
"value": "Here are the holidays listed in the attached file:\n\n1. New Year's Day\n2. Martin Luther King Jr. Day\n3. Presidents' Day\n4. Memorial Day\n5. Independence Day\n6. Labor Day\n7. Columbus Day\n8. Veterans Day\n9. Thanksgiving Day\n10. Christmas Day\n\nThese holidays were found within the attached document .",
"annotations": []
}
}
]
}
],
"status": "completed"
}- Um mehrere Dateien hochzuladen, können Sie eine Liste von Datei-IDs hinzufügen. Diese Datei-IDs sind eindeutige Kennungen, die den über OpenAI hochgeladenen Dateien zugewiesen werden. Weitere Informationen zum Hochladen und Abrufen von Dateien in einem Assistenten finden Sie unter OpenAI Files Operations.
- Die Control Room-Dateien oder Desktop-Dateien, die in OpenAI hochgeladen wurden, befinden sich im OpenAI-Speicher.
Das folgende Beispiel zeigt, wie Sie den Assistenten mit einer Funktion verwenden können. In diesem Szenario möchten Sie, dass Ihr Assistent Wetterinformationen abruft. Indem Sie ihm eine neue Funktion mit dem Namen get_weather (zusammen mit einer Beschreibung und Parametern) bereitstellen, statten Sie den Assistenten mit dieser neuen Fähigkeit aus.
{
"name": "get_weather",
"description": "Determine weather in my location",
"parameters":
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state e.g. San Francisco, CA"
},
"unit": {
"type": "string",
"enum": [
"c",
"f"
]
}
},
"required": [
"location"
]
}
}Die JSON-Ausgabe nach dem Bild unten zeigt den Status des Assistenten als requires_action. Das gibt an, dass der Assistent auf Ihre Eingabe wartet, um fortzufahren. Sie können nun „OpenAI: Run Assistant Function“ nutzen, um den Assistenten anzuweisen, die neu eingeführte Funktion get_weather zu verwenden und auf Grundlage der abgerufenen Daten eine angemessene Antwort zu formulieren.
Die Antwort auf die oben genannte Automatisierung lautet wie folgt:
{
"data":{
"thread_id":"thread_Sizn8HNIKH5NzDYXQ61n05RC",
"tool_calls":[
{
"id":"call_wCWp3g9fdWLszmSvUMqglyW5",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_MBq3pioUk9K0NaREPOIY4qFG"
},
"status":"requires_action"
}