Action OpenAI : action Exécuter l'assistant

L'action OpenAI : L'action Exécuter l'assistant utilise l'API Assistant d'OpenAI 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. L'API Assistants prend actuellement en charge trois types d'outils : Interpréteur de code, Récupération 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 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 Assistant de création OpenAI.

Procédure

  1. Dans la Automation Anywhere Control Room, accédez au volet Actions, sélectionnez IA générative > OpenAI, puis faites glisser l'action OpenAI : Exécuter l'assistant et placez-la dans le canevas.
  2. Renseignez ou sélectionnez les champs suivants :

    Action OpenAI : Exécuter l'assistant

    1. Cliquez sur Charger les assistants pour sélectionner un assistant existant. Vous devez vous authentifier (voir Action Authentifier) avec la clé API.Open AI : Se connecter
      1. 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.
      2. 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.
    2. Saisissez un message que le modèle va utiliser pour générer une réponse.
      Remarque :

      L'action Run Assistant conserve les résultats de l'action précédente dans la même session. En appelant plusieurs actions Run Assistant consécutives, l'assistant mémorise le contexte de la conversation au sein du même fil de discussion et peut ainsi associer les messages suivants aux précédents. L'historique de cette conversation est toutefois effacé une fois la session terminée. Un nouveau fil de discussion est créé pour chaque nouvelle session.

    3. Saisissez Par défaut comme nom de session pour vous limiter à la session en cours.
    4. Pour gérer les paramètres facultatifs, sélectionnez Oui sous Afficher plus d'options afin d'ajouter des paramètres supplémentaires tels que : Modèle, Instructions, Instructions supplémentaires, Fichiers et Métadonnées. Vous pouvez également activer les options Interpréteur de code, Récupération ou Fonction pour étendre les fonctionnalités de votre assistant et lui permettre d'effectuer des tâches plus complexes. Pour plus d'informations sur ces paramètres facultatifs, voir Exécution de la création OpenAI.
      Remarque : En sélectionnant ces paramètres facultatifs, pour définir Modèle, Instructions et ainsi de suite, vous pouvez affiner le comportement de l'assistant en remplaçant ses paramètres par défaut.
      • Interpréteur de code : permet aux assistants d'exécuter un code Python personnalisé de manière à faciliter la manipulation des données, l'intégration logique et les tâches d'automatisation. Par exemple
      • Récupération : permet aux assistants de rechercher et de traiter des informations provenant de sources externes, d'enrichir les conversations et de fournir des réponses adaptées au contexte.
      • Fonction : permet aux assistants de rechercher et de traiter des informations provenant de sources externes, d'enrichir les conversations et de fournir des réponses adaptées au contexte.
    5. Enregistrez la réponse dans une variable. Dans cet exemple, la réponse est enregistrée dans une variable de chaîne str_asst_Response. La sortie est un fichier JSON ; voici un exemple de sortie de l'exécution ci-dessus :
      {
         "metadata":{
            
         },
         "data":[
            {
               "role":"assistant",
               "content":[
                  {
                     "type":"text",
                     "text":{
                        "value":"New York is a bustling metropolis known as \"The Big Apple,\" renowned for its iconic skyline, cultural diversity, and status as a major global financial, entertainment, and cultural center.",
                        "annotations":[
                           
                        ]
                     }
                  }
               ]
            }
         ],
         "status":"completed"
      }
Interpréteur de code :

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.

OpenAI : Exécuter l'assistant - Interpréteur de code

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: 0, 1, 1, 2, 3, 5, 8, 13.",
                  "annotations":[
                     
                  ]
               }
            }
         ]
      }
   ],
   "status":"completed"
}
Récupération :

L'exemple suivant montre comment utiliser l'assistant lorsque la récupération est activée. Dans ce scénario, l'assistant lit le fichier joint pour générer la réponse.

OpenAI : Exécuter l'assistant - Récupération de code

La réponse à l'automatisation ci-dessus est la suivante :

{
   "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"
}
Remarque : pour charger plusieurs fichiers, vous pouvez ajouter une liste d'ID de fichiers. Ces ID de fichiers sont des identifiants uniques attribués aux fichiers téléchargés à l'aide de l'API de l'OpenAI. Pour en savoir plus sur le chargement et la récupération de fichiers dans un assistant, voir Opérations sur les fichiers OpenAI.

OpenAI : Exécuter l'assistant - ID de fichiers multiples

Fonction :

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.

Open AI : Exécuter la fonction d'assistant

La réponse à l'automatisation ci-dessus est la suivante :

{
   "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"
}
Vous pouvez utiliser l'ID de thread, l'ID d'appel et l'ID d'exécution du JSON pour appeler l'Action OpenAI : action Exécuter la fonction d'assistant.