Snowflake AI Connector Setup Guide

For an overview of how AI connectors work and guidance on when to use an AI connector or Tealium functions, see AI connectors and Tealium functions.

Configuration

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

After adding the connector, configure the following settings:

Snowflake Account Identifier: The Snowflake account identifier is used to construct your account URL in the following format: {account_identifier}.snowflakecomputing.com.
User Name: The Snowflake account user name. We recommend using a Snowflake service user.
Private Key: Private key for the user.
Private Key Passphrase: (Optional) Provide the encrypted private key passphrase if the private key is encrypted. Do not assign a value if the private key is unencrypted.
User Role: (Optional) Specify the Snowflake role to use for authentication and model endpoint access. If left blank, the user’s default role is used. The selected role must be granted to the configured user and have permission to access Snowflake Cortex APIs and any deployed model endpoints.

Actions

Action Name	AudienceStream	EventStream
Send Prompt to Snowflake Cortex	✓	✓
Invoke Model Endpoint	✓	✓

Send Prompt to Snowflake Cortex

Parameters

Parameter Description

Model Enter the Snowflake Cortex model to use for this request.
Provide the exact model name (for example, llama3.1-8b). Model availability depends on your Snowflake region and configuration, and invalid model names will result in an error.
You can also enter a fully-qualified fine-tuned model name (DATABASE.SCHEMA.MODEL) if configured in Snowflake.
For information on model availability, see Snowflake: Model availability.

Parameter	Description
Model	Enter the Snowflake Cortex model to use for this request. Provide the exact model name (for example, `llama3.1-8b`). Model availability depends on your Snowflake region and configuration, and invalid model names will result in an error. You can also enter a fully-qualified fine-tuned model name (`DATABASE.SCHEMA.MODEL`) if configured in Snowflake. For information on model availability, see Snowflake: Model availability.

Tealium Context

The connector automatically passes tealium_account, tealium_profile, and tealium_visitor_id from the current event. Overwrite these with mapped values if needed.

Parameter	Description
Tealium Event	(Required) Enter the `tealium_event` value to include in the AI response.
Tealium Datasource	Enter the datasource key supplied after creating a Cortex datasource.
Prompt Parameters	Map Tealium attributes to placeholder names used in your prompt template (for example, `product_id`, `event_value`).
Include Visitor Profile	(Available for audience actions) When enabled, the full visitor profile is made available to the prompt as `{{visitor_profile}}`.
Include Current Visit	(Available for audience actions) When enabled, current visit attributes are added to the `{{visitor_profile}}` object (keyed by attribute name).
Include Event Payload	(Available for event actions) When enabled, the current event data is made available to the prompt as `{{event_payload}}`.
Prompt	Enter the prompt that will be sent to the selected Snowflake Cortex model. Use double curly braces for mapped parameters, for example: `{{product_id}}`, `{{event_value}}`. Reference `{{visitor_profile}}` (audience actions) or `{{event_payload}}` (event actions) after enabling the corresponding option. Describe how the model should determine and set each output field. Do not include JSON formatting instructions. The connector enforces the JSON structure automatically via structured output mapping.

Advanced model settings

Parameter	Description
`temperature`	Controls randomness and creativity. A lower value means the model is more deterministic.
`max_completion_tokens`	Maximum number of tokens the model can generate. The default is 512.
`top_p`	Controls diversity by sampling only from the top-p probability mass.

Structured Output

Parameter	Description
Attribute name	Name of the returned field.
Data type	Data type of the field (string, integer, number, boolean).
Debug Mode	When enabled, the connector does not send responses to Tealium Collect. Use Trace to inspect the raw Snowflake response and validate that it is valid JSON before enabling full processing.

Invoke Model Endpoint

Parameters

Parameter	Description
Endpoint URL	Enter the URL of your deployed public endpoint generated by Snowflake Model Registry/Snowpark Container Services. For example, `https://<service-id>.snowflakecomputing.app/predict`. This URL is used to invoke the model and to generate the OAuth scope required for authentication. The endpoint must be publicly accessible and configured for real-time inference. Your Snowflake user or role must have permission to invoke the endpoint.
Input Data	Map Tealium event or visitor attributes to the input fields expected by your deployed model. Input field names must exactly match the feature names required by your model. At least one mapping is required.
Response Path	Optional path to the JSON object in the model response whose fields will be sent to Tealium Collect as attributes. Use dot notation and array indexes, for example: `data[0][1].PREDICTION` or `predictions[0]`. If the value at the path is a JSON string, it will be parsed automatically. If left blank, the root of the response is used as the JSON object. Nested objects and arrays are serialized as JSON strings.
Debug Mode	When enabled, the connector does not send responses to Tealium Collect. Use Trace to inspect the raw Snowflake response and validate that it is valid JSON before enabling full processing.