L'action OpenAI : action Exécuter l'assistant
- Dernière mise à jour2024/07/31
L'action OpenAI : action Exécuter l'assistant
L'action OpenAI : L'action Exécuter l'assistant utilise l'API Assistant d'OpenAI (v2) pour créer des assistants IA dans vos propres applications. Un assistant dispose d'instructions et peut faire appel à des modèles, des outils et des connaissances pour répondre aux demandes des utilisateurs. La v2 de l'API Assistants prend actuellement en charge trois types d'outils : Interprète de code, recherche de fichiers et appel de fonction.
Prérequis
- Vous devez avoir le rôle de Créateur de robots pour utiliser l'action Exécuter l'assistant d'OpenAI dans une automatisation.
- Assurez-vous de disposer des informations d'identification nécessaires pour envoyer une demande et d'inclure L'action OpenAI : Action Authentifier avant d'appeler toute action OpenAI.
- Comprendre les limites de l'assistant : Connaître les options et les limites de l'assistant vous permet de définir des attentes réalistes.
Cet exemple montre comment charger un assistant existant dans l'action Exécuter l'assistant OpenAI et obtenir une réponse appropriée. Pour apprendre à créer votre propre assistant, voir OpenAI Create Assistant.
Procédure
-
Renseignez ou sélectionnez les champs suivants :
-
Cliquez sur Charger les assistants pour sélectionner un assistant existant. Vous devez vous authentifier (voir L'action OpenAI : Action Authentifier) avec la clé API.
- Se connecter à Open AI s'affiche. Vous pouvez saisir la clé API par le biais d'un identifiant enregistré dans l'onglet Information d'identification ou sélectionner l'onglet Chaîne non sécurisée pour coller directement la clé API.
- L'identifiant de l'assistant sélectionné s'affiche dans le champ Identifiant de l'assistant.
Remarque : Il est essentiel de comprendre les limites d'un assistant avant de le sélectionner pour offrir à l'utilisateur une expérience la plus conviviale possible. Imaginez que vous sollicitiez une réservation de vol et que vous découvriez que l'assistant ne peut pas accéder aux systèmes de réservation. En vous familiarisant au préalable avec les fonctionnalités de l'assistant, vous pouvez éviter ce type de scénario désagréable.
-
Cliquez sur Charger les assistants pour sélectionner un assistant existant. Vous devez vous authentifier (voir L'action OpenAI : Action Authentifier) avec la clé API.
L'exemple suivant montre comment utiliser l'assistant avec l'interpréteur de code activé pour générer les huit premiers termes de la séquence Fibonacci.
La réponse à l'automatisation ci-dessus est la suivante :
{
"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"
}L'exemple suivant montre comment utiliser l'assistant lorsque la Recherche de fichiers est activée. Dans ce scénario, l'assistant lit le fichier joint pour générer la réponse.
La réponse à l'automatisation ci-dessus est la suivante :
{
"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"
}- pour charger plusieurs fichiers, vous pouvez ajouter une liste d'ID de fichiers. Ces ID de fichiers sont des identifiants uniques attribués aux chargés à l'aide de OpenAI. Pour en savoir plus sur le chargement et la récupération de fichiers dans un assistant, voir OpenAI Files Operations
- Les fichiers ou les fichiers de bureau de la Control Room chargés sur OpenAI peuvent être trouvés sur le stockage de OpenAI.
L'exemple suivant montre comment utiliser l'assistant avec une fonction. Dans ce scénario, imaginez que vous souhaitiez que votre assistant récupère des informations météorologiques. En y intégrant une nouvelle fonction nommée get_weather (accompagnée d'une description et de paramètres), vous dotez l'assistant de cette nouvelle fonctionnalité.
{
"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"
]
}
}La sortie JSON après l'image ci-dessous indique que le statut de l'assistant est requires_action. Cela indique que l'assistant attend vos instructions sur la manière de procéder. Vous pouvez maintenant bénéficier de l'Action OpenAI : action Exécuter la fonction d'assistant pour indiquer à l'assistant comment utiliser la fonction get_weather nouvellement introduite et formuler une réponse appropriée sur la base des données extraites.
La réponse à l'automatisation ci-dessus est la suivante :
{
"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"
}