Studio Web user guide

Prerequisites​

1. Create an API workflow.
2. Define workflow inputs. Open Data manager and add a new Inputs parameter with the following configuration:
   • Name—Question
   • Type—String
   • Leave the Required checkbox empty.
3. Add a HTTP activity and configure it as follows:
   • Method—POST
   • Request URL—Provide the Cortex Agent run endpoint, specific to your Snowflake account and agent, for example "https://{your_snowflake_env}/api/v2/databases/SNOWFLAKE_INTELLIGENCE/schemas/AGENTS/agents/ORDERS_AGENT:run"
   • Headers—
     assignment

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

   • Request body—
     assignment

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

4. Add a Response activity and leave it as is. This captures and returns the output from the Cortex agent as a JSON.
5. Run the integration. Once deployed, you can invoke the workflow with any natural language query. The workflow passes the question to the Cortex Agent, receives the streaming output, and returns a structured JSON response that can be used in downstream automations.

• Streaming is seamless – Although Cortex API is streaming-only, the API workflow built-in support meant no additional coding was required to parse and collect results.
• Consistent API contract – All Cortex Agents share the same request/response shape. Your integration does not need to change as your agents become more advanced.
• Rapid prototyping – From setup to working integration took minutes. This speed allows teams to quickly validate use cases and iterate.