--- title: Snowflake AIコネクタ構成ガイド description: Tealiumのイベントデータと訪問データをSnowflake Cortexモデルまたはデプロイされたモデルエンドポイントにリアルタイムで送信するためのSnowflake AIコネクタを構成します。 url: https://docs.tealium.com/ja/server-side-connectors/snowflake-ai-connector/ ---
AIコネクタの動作概要とAIコネクタまたはTealium機能をいつ使用するかについてのガイダンスについては、[AIコネクタとTealium機能](https://docs.tealium.com/ai-connectors-and-functions/)を参照してください。
## 構成 コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、以下の構成を構成します： * **Snowflakeアカウント識別子**：Snowflakeアカウント識別子は、次の形式でアカウントURLを構築するために使用されます：`{account_identifier}.snowflakecomputing.com`。 * **ユーザー名**：Snowflakeアカウントのユーザー名。Snowflakeサービスユーザーの使用を推奨します。 * **プライベートキー**：ユーザーのプライベートキー。 * **プライベートキーパスフレーズ**：（オプション）プライベートキーが暗号化されている場合は、暗号化されたプライベートキーパスフレーズを提供します。プライベートキーが暗号化されていない場合は値を割り当てないでください。 * **ユーザーロール**：（オプション）認証およびモデルエンドポイントへのアクセスに使用するSnowflakeロールを指定します。空白のままにすると、ユーザーのデフォルトロールが使用されます。選択したロールは、構成されたユーザーに付与され、Snowflake Cortex APIおよびデプロイされたモデルエンドポイントへのアクセス権を持っている必要があります。 ## アクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | Snowflake Cortexへのプロンプト送信 | ✓ | ✓ | | モデルエンドポイントの呼び出し | ✓ | ✓ | ### Snowflake Cortexへのプロンプト送信 #### パラメータ | パラメータ | 説明 | | --- | --- | | モデル | このリクエストに使用するSnowflake Cortexモデルを入力します。
正確なモデル名を提供してください（例：`llama3.1-8b`）。モデルの可用性は、あなたのSnowflakeリージョンと構成に依存し、無効なモデル名はエラーを引き起こします。
Snowflakeで構成されている場合は、完全修飾の微調整モデル名（`DATABASE.SCHEMA.MODEL`）も入力できます。
モデルの可用性については、[Snowflake: モデルの可用性](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-rest-api#model-availability)を参照してください。 | #### Tealiumコンテキスト コネクタは、現在のイベントから`tealium_account`、`tealium_profile`、および`tealium_visitor_id`を自動的に渡します。必要に応じてマップされた値でこれらを上書きします。 | パラメータ | 説明 | | --- | --- | | Tealiumイベント | （必須）AIレスポンスに含める`tealium_event`値を入力します。 | | Tealiumデータソース | Cortexデータソースを作成した後に提供されるデータソースキーを入力します。 | | プロンプトパラメータ | Tealium属性をプロンプトテンプレートで使用されるプレースホルダー名にマップします（例：`product_id`、`event_value`）。 | | 訪問プロファイルを含む | （オーディエンスアクションで利用可能）有効にすると、完全な訪問プロファイルがプロンプトに`{{visitor_profile}}`として利用可能になります。 | | 現在の訪問を含む | （オーディエンスアクションで利用可能）有効にすると、現在の訪問属性が`{{visitor_profile}}`オブジェクトに属性名で追加されます。 | | イベントペイロードを含む | （イベントアクションで利用可能）有効にすると、現在のイベントデータがプロンプトに`{{event_payload}}`として利用可能になります。 | | プロンプト | 選択したSnowflake Cortexモデルに送信されるプロンプトを入力します。
マップされたパラメータには二重波括弧を使用します。例：`{{product_id}}`、`{{event_value}}`。
対応するオプションを有効にした後、`{{visitor_profile}}`（オーディエンスアクション）または`{{event_payload}}`（イベントアクション）を参照します。
モデルが各出力フィールドをどのように決定し構成するかを説明します。
JSONフォーマット指示を含めないでください。コネクタは構造化された出力マッピングを通じて自動的にJSON構造を強制します。 | #### 高度なモデル構成 | パラメータ | 説明 | | --- | --- | | `temperature` | ランダム性と創造性を制御します。値が低いほど、モデルはより決定論的です。 | | `max_completion_tokens` | モデルが生成できるトークンの最大数。デフォルトは512です。 | | `top_p` | 上位p確率質量からのみサンプリングすることで多様性を制御します。 | #### 構造化出力 | パラメータ | 説明 | | --- | --- | | 属性名 | 返されるフィールドの名前。 | | データタイプ | フィールドのデータタイプ（文字列、整数、数値、ブール）。 | | デバッグモード | 有効にすると、コネクタはTealium Collectにレスポンスを送信しません。Traceを使用して生のSnowflakeレスポンスを検査し、完全な処理を有効にする前に有効なJSONであることを確認します。 | ### モデルエンドポイントの呼び出し #### パラメータ | パラメータ | 説明 | | --- | --- | | エンドポイントURL | Snowflakeモデルレジストリ/Snowparkコンテナサービスによって生成されたデプロイされた公開エンドポイントのURLを入力します。例：`https://.snowflakecomputing.app/predict`。
このURLはモデルを呼び出し、認証に必要なOAuthスコープを生成するために使用されます。
エンドポイントは公開アクセス可能でリアルタイム推論用に構成されている必要があります。
あなたのSnowflakeユーザーまたはロールはエンドポイントを呼び出す権限を持っている必要があります。 | | 入力データ | Tealiumのイベントまたは訪問属性を、デプロイされたモデルが期待する入力フィールドにマップします。
入力フィールド名はモデルが要求する特徴名と正確に一致する必要があります。
少なくとも1つのマッピングが必要です。 | | レスポンスパス | モデルレスポンスのJSONオブジェクトのパスをオプションで指定し、そのフィールドがTealium Collectに属性として送信されます。
ドット表記と配列インデックスを使用します。例：`data[0][1].PREDICTION`または`predictions[0]`。パスの値がJSON文字列の場合、自動的に解析されます。
空白のままにすると、レスポンスのルートがJSONオブジェクトとして使用されます。
ネストされたオブジェクトと配列はJSON文字列としてシリアライズされます。 | | デバッグモード | 有効にすると、コネクタはTealium Collectにレスポンスを送信しません。Traceを使用して生のSnowflakeレスポンスを検査し、完全な処理を有効にする前に有効なJSONであることを確認します。 |