„OpenAI: Run Assistant“
- Aktualisiert: 2024/04/18
„OpenAI: Run Assistant“
Die Aktion „OpenAI: Run Assistant“ nutzt die OpenAI Assistant API, um KI-Assistenten in Ihren eigenen Anwendungen zu erstellen. Ein Assistent verfügt über Anweisungen und kann Modelle, Tools und Wissen nutzen, um Nutzeranfragen zu beantworten. Die Assistenten-API unterstützt derzeit drei Arten von Werkzeugen: Codedolmetscher, Abruf 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 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 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 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: 0, 1, 1, 2, 3, 5, 8, 13.",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}Das folgende Beispiel zeigt, wie Sie den Assistenten bei aktiviertem Abruf 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":"The holidays listed in the 2024 USA holiday schedule are as follows:\n\n1. New Year\u0027s Day: January 1, Monday\n2. MLK Day: January 15, Monday\n3. President\u0027s Day: February 19, Monday\n4. Memorial Day: May 27, Monday\n5. Juneteenth: June 19, Wednesday\n6. Independence Day: July 4, Thursday\n7. Labor Day: September 2, Monday\n8. Thanksgiving Day: November 28, Thursday\n9. Day after Thanksgiving: November 29, Friday\n10. Christmas Eve: December 24, Tuesday\n11. Christmas Day: December 25, Wednesday\n12. New Year\u0027s Eve: December 31, Tuesday",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}
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_Aq8I25CKOFAZ50GkVDH4gZXw",
"tool_calls":[
{
"id":"call_zkehFEVLaXyuEND9kSRgq4O1",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_s3jWsc8H2xaGV6E28CevuXsG"
},
"status":"requires_action"
}