Integrar la API de Snowflake Cortex con los flujos de trabajo de la API

Los agentes de Snowflake Cortex desbloquean la interacción del lenguaje natural con tus datos, ayudándote a consultar, analizar y actuar sobre conjuntos de datos empresariales.

Este flujo de trabajo actúa como intermediario para ejecutar un "ORDERS_AGENT" en Snowflake. Toma una pregunta como entrada, la envía a la API del agente de Snowflake Cortex y luego devuelve la respuesta de la API directamente como salida del flujo de trabajo.

Requisitos previos

En primer lugar, debes tener un agente de Cortex configurado en tu cuenta de Snowflake.

1. Crea un flujo de trabajo de API.
2. Define las entradas del flujo de trabajo. Abre Data Manager y añade un nuevo parámetro de Entradas con la siguiente configuración:
   • Nombre : pregunta
   • Tipo:cadena
   • Deja la casilla de verificación Requerido vacía.
3. Añade una actividad HTTP y configúrala de la siguiente manera:
   • Método : POST
   • URL de solicitud : proporciona el punto final de ejecución del agente de Cortex, específico para tu cuenta y agente de Snowflake, por ejemplo "https://{your_snowflake_env}/api/v2/databases/SNOWFLAKE_INTELLIGENCE/schemas/AGENTS/agents/ORDERS_AGENT:run"
   • Encabezados :

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

   • Cuerpo de la solicitud :

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

4. Añade una actividad de Respuesta y déjala como está. Esto captura y devuelve la salida del agente de Cortex como un JSON.
5. Ejecuta la integración. Una vez implementado, puedes invocar el flujo de trabajo con cualquier consulta de lenguaje natural. El flujo de trabajo pasa la pregunta al agente de Cortex, recibe la salida de transmisión y devuelve una respuesta JSON estructurada que puede utilizarse en automatizaciones posteriores.

Conclusiones clave:

• La transmisión es fluida : aunque la API de Cortex es solo de transmisión, el soporte integrado del flujo de trabajo de la API significaba que no se requería codificación adicional para analizar y recopilar resultados.
• Contrato de API coherente : todos los agentes de Cortex comparten la misma forma de solicitud/respuesta. No es necesario que tu integración cambie a medida que tus agentes sean más avanzados.
• Creación rápida de prototipos : desde la configuración hasta la integración funcional en cuestión de minutos. Esta velocidad permite a los equipos validar rápidamente los casos de uso e iterar.