Intégration de l'API Snowflake Cortex avec les workflows d'API

Les agents Snowflake Cortex permettent une interaction en langage naturel avec vos données, en vous aidant à interroger, analyser et agir au niveau des ensembles de données d’entreprise.

Ce workflow sert d'intermédiaire pour exécuter « ORDERS_AGENT » dans Snowflake. Il prend une question comme entrée, l’envoie à l’API de l’agent Snowflake Cortex, puis renvoie la réponse de l’API directement en tant que sortie du workflow.

Prérequis

Tout d'abord, vous devez configurer un agent Corx dans votre compte Snowflake.

1. Créez un workflow d’API.
2. Définissez les entrées de workflow. Ouvrez le gestionnaire de données et ajoutez un nouveau paramètre Entrées avec la configuration suivante :
   • Nom—Question
   • Type—String
   • Laissez la case Obligatoire vide.
3. Ajoutez une activité HTTP et configurez-la comme suit :
   • Méthode—PUBLIER
   • URL de la demande : fournissez le point de terminaison d’exécution de l’agent Cortext, spécifique à votre compte Snowflake et à votre agent, par exemple "https://{your_snowflake_env}/api/v2/databases/SNOWFLAKE_INTELLIGENCE/schemas/AGENTS/agents/ORDERS_AGENT:run"
   • En-têtes—

     {
       "Content-Type": "application/json",
       "Accept": "application/json",
       "Authorization": "Bearer <Add your snowflake_token here>"
     }
     

   • Corps de la requête—

     {
         "messages": [
             {
                 "role": "user",
                 "content": [
                     {
                         "type": "text",
                         "text": $workflow.input.Question
                     }
                 ]
             }
         ],
         "toolChoice": {
             "type": "auto"
         }
     }
     

4. Ajoutez une activité Réponse et laissez-la telle quelle. Cela capture et renvoie la sortie de l'agent Corex sous la forme d'un fichier JSON.
5. Exécutez l'intégration. Une fois déployé, vous pouvez invoquer le workflow avec n’importe quelle requête en langage naturel. Le workflow transmet la question à l'agent Cor sur, reçoit la sortie de la diffusion et renvoie une réponse JSON structurée qui peut être utilisée dans des automatisations en aval.

Points à retenir :

• Le flux est fluide : Bien que l'API Cortor soit uniquement capable de diffuser, la prise en charge intégrée du workflow de l'API signifie qu'aucun codage supplémentaire n'est nécessaire pour analyser et collecter les résultats.
• Contrat d’API cohérent : tous les agents Corex partagent la même forme de demande/réponse. Votre intégration n’a pas besoin de changer lorsque vos agents deviennent plus avancés.
• Prototypage rapide : de la configuration à l'intégration opérationnelle a pris quelques minutes. Cette vitesse permet aux équipes de valider rapidement les cas d’utilisation et d’itérer.