# Databricks Genie AgentsをTreasure AI CDPに接続する

[Databricks Genie Agents](https://docs.databricks.com/aws/en/genie-agents/)を使用すると、ビジネスユーザーはDatabricks内のデータについて自然言語で質問できます。Unity Catalogの関数を介してGenie AgentをTreasure AI CDP APIに接続することで、ビジネスユーザーはDatabricksを離れたりTreasure AI APIキーを目にしたりすることなく、Databricksから直接、親セグメント、子セグメント、およびジャーニーを確認できます。

この連携パターンでは、モデル、APIキー、すべてのAPI呼び出しがDatabricks内にとどまります。GenieのAI利用とSQLウェアハウスの実行時間はDatabricksによって課金されます。Treasure AI側は通常のCDP REST API呼び出しを処理するだけであるため、Treasure AI Creditsは使用されません。

このガイドは、エージェントを設定するDatabricksの管理者を対象としています。ビジネスユーザーからTreasure AI Studioのエージェントやアクションを使う場合は、[Databricks Genie One を Treasure AI Studio に接続する](/products/headless/databricks-genie-one)を参照してください。

## 連携の仕組み

ビジネスユーザーがGenie Agentで質問すると、Genieはビュー`td_parent_segments_v`に対するSQLを書くか、`td_*`テーブル関数のいずれかを呼び出します。各テーブル関数は、エージェントのサーバーレスSQLウェアハウス上でPython関数`td_cdp_fetch`を実行します。`td_cdp_fetch`はTreasure AI APIキーを使ってTreasure AI CDP APIにHTTPSの`GET`リクエストを送信してJSONを返し、テーブル関数がそれを行に変換します。その後、Genieが回答を作成します。

| Databricksオブジェクト  | 名前  | 用途  |
|  --- | --- | --- |
| **ワークスペースのプレビュー** | Enable networking for isolated workloads in serverless SQL warehouses | サーバーレスSQLウェアハウス上のPython関数がアウトバウンドのHTTPS呼び出しを行えるようにします |
| **カタログ** | `treasure_ai` | 下記の2つのスキーマを格納します |
| **スキーマ** | `treasure_ai.genie` | Genieユーザーが実行できる関数とビューを格納します |
| **スキーマ** | `treasure_ai.secrets` | APIキーのみを格納します。Genieユーザーにはアクセス権を付与しません |
| **シークレット** | `treasure_ai.secrets.td_api_key` | ユーザーから見えないようにTreasure AI APIキーを保存します |
| **Python関数** | `td_cdp_fetch` | CDP APIを呼び出し、JSON配列を返します |
| **SQLテーブル関数** | `td_parent_segments`、`td_segments`、`td_journeys` | JSONを、Genieが絞り込み、並べ替え、グラフ化できる行に変換します |
| **ビュー** | `td_parent_segments_v` | Genie Agentのテーブルソースです。クエリのたびにTreasure AIをその場で呼び出します |
| **アカウントグループ** | `GENIE_USERS`（任意のグループ名） | エージェントを使用できるビジネスユーザーです |
| **Genie Agent** | `Treasure AI CDP` | ビジネスユーザーがチャットするエージェントです |


## 前提条件

- **Databricksワークスペース**: Unity Catalog、Genie Agents、サーバーレスSQLウェアハウス。このガイドでは`EMEA Starter Warehouse`を使用していますが、ご自身のウェアハウスを使用してください。
- **Databricksの権限**: メタストアに対する`CREATE CATALOG`と、フェーズ1のステップ2でワークスペースのプレビューを有効化できるワークスペース管理者。
- **専用のTreasure AIユーザー**: Genie Agentに回答させる親セグメントのみを閲覧できるTreasure AIユーザー。すべてのGenieユーザーは、この1人のユーザーとして動作します。
- **アカウントグループ**: エージェントを使用するビジネスユーザーを含むDatabricksのアカウントグループ。このガイドでは`GENIE_USERS`と呼びます。
- **リージョン別のCDP APIホスト**: ご利用のTreasure AIリージョンに対応するCDP APIホスト。


| リージョン  | `CDP_HOST` URL  |
|  --- | --- |
| **US (AWS us-east-1)** | `https://api-cdp.treasuredata.com` |
| **EU (eu01)** | `https://api-cdp.eu01.treasuredata.com` |
| **日本 (ap01)** | `https://api-cdp.treasuredata.co.jp` |
| **アジア太平洋 (ap02)** | `https://api-cdp.ap02.treasuredata.com` |


## フェーズ1：DatabricksでTreasure AI APIアクセスを設定する

このフェーズでは、Treasure AI APIキーを発行してUnity Catalogのシークレットに保存し、CDP APIを呼び出す関数とビューを作成します。ステップ4〜9のSQLは、1つのSQLワークシートで実行してください。

### ステップ1：Treasure AI Master APIキーを発行する

1. 専用のTreasure AIユーザーとして[Treasure AI Console](/tools/td-console/log-in-to-td-console)にサインインします。
2. **My Settings → API Keys**へ移動し、**Add API Key**を選択します（[APIキーの取得](/products/my-settings/getting-your-api-keys)を参照）。
3. キーの種類として**Master Key**を選択し、保存して値（`<account_id>/<hex_secret>`）をコピーします。


専用ユーザーの権限を絞り、定期的にキーをローテーションしてください
Treasure AI CDP APIで親セグメント、セグメント、ジャーニーを読み取るには、Master Keyが必要です。Write-Onlyキーではデータを読み取れません。Master Keyは、そのユーザーに許可されたすべての操作を実行できるため、必ずGenie Agentに回答させる親セグメントのみにアクセスを絞った専用のTreasure AIユーザーで発行してください。キーはUnity Catalogのシークレット内にのみ保存し、定期的にローテーションしてください。

### ステップ2：サーバーレスSQLウェアハウスからのアウトバウンド通信を許可する

サーバーレスSQLウェアハウス上のPython関数は、ワークスペース管理者がプレビューを有効にするまでインターネットにアクセスできません。反映まで最大15分かかることがあるため、最初に有効にしてください。

1. 右上のユーザーメニューを開き、**Previews**を選択します。
2. **Enable networking for isolated workloads in serverless SQL warehouses**を探します。初期状態ではオフです。
3. **On**に切り替えます。プレビューが有効になったことを示す確認が表示されます。


このプレビューを有効にすると、サーバーレスSQLウェアハウス上の関数は任意のホストを呼び出せるようになります。ワークスペースにサーバーレスのエグレスポリシーがある場合は、ご利用リージョンのCDP APIホストを許可する必要があります。

### ステップ3：SQLワークシートを開く

**+ New → Query**を選択して、新しいSQLエディタのタブを開きます。ウェアハウスの選択欄で、`EMEA Starter Warehouse`などのサーバーレスSQLウェアハウスを選びます。

### ステップ4：カタログとスキーマを作成する

ワークシートで次を実行します。

```sql
-- メタストアに対する CREATE CATALOG が必要です。メタストアにデフォルトの
-- ストレージがない場合は、MANAGED LOCATION 's3://<bucket>/<path>' を追加します
CREATE CATALOG IF NOT EXISTS treasure_ai;

-- Genie ユーザーが実行できる関数とビューを格納します。
CREATE SCHEMA IF NOT EXISTS treasure_ai.genie;

-- API キーのみを格納します。このスキーマには Genie ユーザーに何も付与しないでください。
CREATE SCHEMA IF NOT EXISTS treasure_ai.secrets;
```

**Catalog**に`treasure_ai`カタログが表示され、その中に`genie`と`secrets`のスキーマが作成されます。

### ステップ5：APIキーをUnity Catalogのシークレットとして保存する

キーがSQLやクエリ履歴に残らないように、シークレットは画面から作成します。

1. **Catalog**で`treasure_ai` → `secrets`を開き、**Create → Secret**を選択します。
2. **Secret name**に`td_api_key`を入力し、**Secret value**にステップ1のMaster APIキーを貼り付けます。
3. **Choose catalog and schema**で`treasure_ai`と`secrets`を選択し、**Create**を選択します。


### ステップ6：Treasure AIを呼び出す関数を作成する

`td_cdp_fetch`は、読み取り専用の3つのアクションを持つPython関数です。

| アクション  | 入力  | Treasure AI APIの呼び出し  |
|  --- | --- | --- |
| `list_parent_segments` | なし | `GET /entities/parent_segments` |
| `list_segments` | `parent_segment_id` | `GET /audiences/{id}/segments` |
| `list_journeys` | `parent_segment_id` | `GET /audiences/{id}/folders`の後、フォルダごとに`GET /entities/journeys?folder_id=…` |


Treasure AIではジャーニーがフォルダごとに一覧されるため、`list_journeys`は最初に親セグメントのフォルダを読み取り、ジャーニーIDで重複を取り除きます。

CDP APIが受け付けるのは`Authorization: TD1 <key>`ヘッダーのみです。Unity CatalogのHTTP接続と`http_request()`は`Bearer <token>`を送信し、CDP APIはこれをHTTP `401`で拒否するため、この関数ではPythonでヘッダーを組み立てます。`SECRETS`句により、関数は所有者の権限でキーを読み取れます。呼び出し側に必要なのは`EXECUTE`だけで、キーを目にすることはありません。関数の所有者には、シークレットに対する`READ SECRET`が必要です。

ステートメントを実行する前に、`CDP_HOST`を[前提条件](#%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6)にあるご利用リージョンのCDP APIホストに設定してください。

```sql
CREATE OR REPLACE FUNCTION treasure_ai.genie.td_cdp_fetch(
  action STRING,
  parent_segment_id STRING
)
RETURNS STRING
COMMENT 'Read-only call to the Treasure AI CDP API. Returns a JSON array. Used by the td_* table functions.'
LANGUAGE PYTHON
HANDLER 'main'
SECRETS (treasure_ai.secrets.td_api_key)
ENVIRONMENT (environment_version = '6')
AS $$
import json
import re
import urllib.error
import urllib.request

from databricks.secrets import get

CDP_HOST = "https://api-cdp.treasuredata.com"
TIMEOUT_SECONDS = 30

HTTP_HINTS = {
    401: "API key rejected (wrong key, wrong region, or a write-only key)",
    403: "the Treasure user behind the API key lacks permission",
    404: "not found (check the parent segment id)",
}


def _get(path):
    key = get(catalog="treasure_ai", schema="secrets", key="td_api_key")
    req = urllib.request.Request(
        CDP_HOST + path,
        headers={"Authorization": "TD1 " + key, "Accept": "application/json"},
    )
    try:
        with urllib.request.urlopen(req, timeout=TIMEOUT_SECONDS) as resp:
            return json.load(resp)
    except urllib.error.HTTPError as e:
        raise RuntimeError(
            f"Treasure API HTTP {e.code}: {HTTP_HINTS.get(e.code, 'request failed')}"
        ) from None


def _parent_id(parent_segment_id):
    pid = (parent_segment_id or "").strip()
    if not re.fullmatch(r"\d+", pid):
        raise ValueError("parent_segment_id must be a number. Look it up in td_parent_segments_v first.")
    return pid


def _list_parent_segments(_parent_segment_id):
    return [
        {
            "parent_segment_id": str(r.get("id")),
            "name": a.get("name"),
            "description": a.get("description"),
            "population": a.get("population"),
            "updated_at": a.get("updatedAt"),
        }
        for r in _get("/entities/parent_segments").get("data") or []
        for a in [r.get("attributes") or {}]
    ]


def _list_segments(parent_segment_id):
    pid = _parent_id(parent_segment_id)
    return [
        {
            "segment_id": str(r.get("id")),
            "name": r.get("name"),
            "description": r.get("description"),
            "population": r.get("population"),
            "kind": r.get("kind"),
            "updated_at": r.get("updatedAt"),
        }
        for r in _get("/audiences/" + pid + "/segments")
    ]


def _list_journeys(parent_segment_id):
    pid = _parent_id(parent_segment_id)
    results = {}
    for folder in _get("/audiences/" + pid + "/folders"):
        body = _get("/entities/journeys?folder_id=" + str(folder.get("id")))
        for item in body.get("data") or []:
            a = item.get("attributes") or {}
            results[item.get("id")] = {
                "journey_id": item.get("id"),
                "name": a.get("name"),
                "state": a.get("state"),
                "paused": a.get("paused"),
                "parent_segment_id": a.get("audienceId"),
                "launched_at": a.get("launchedAt"),
                "updated_at": a.get("updatedAt"),
            }
    return list(results.values())


ACTIONS = {
    "list_parent_segments": _list_parent_segments,
    "list_segments": _list_segments,
    "list_journeys": _list_journeys,
}


def main(action, parent_segment_id):
    action = (action or "").strip().lower()
    if action not in ACTIONS:
        raise ValueError("Unknown action. Use one of: " + ", ".join(ACTIONS))
    return json.dumps(ACTIONS[action](parent_segment_id))
$$;
```

### ステップ7：テーブル関数とビューを作成する

Python関数は1つの値しか返さないため、次のSQLテーブル関数でJSONを行に変換します。Genie Agentsにはソースとして少なくとも1つのテーブルまたはビューが必要なため、ビューで親セグメントの一覧をラップします。ビューへのクエリのたびにTreasure AIをその場で呼び出し、Databricksにデータはコピーされません。

```sql
CREATE OR REPLACE FUNCTION treasure_ai.genie.td_parent_segments()
RETURNS TABLE (
  parent_segment_id STRING,
  name STRING,
  description STRING,
  population BIGINT COMMENT 'Number of customer profiles. NULL means the size has not been calculated yet.',
  updated_at TIMESTAMP
)
COMMENT 'Live list of Treasure AI parent segments (audiences).'
RETURN
  SELECT p.parent_segment_id, p.name, p.description, p.population,
         try_cast(p.updated_at AS TIMESTAMP) AS updated_at
  FROM (
    SELECT explode(from_json(
      treasure_ai.genie.td_cdp_fetch('list_parent_segments', NULL),
      'ARRAY<STRUCT<parent_segment_id: STRING, name: STRING, description: STRING, population: BIGINT, updated_at: STRING>>'
    )) AS p
  );

CREATE OR REPLACE FUNCTION treasure_ai.genie.td_segments(
  parent_segment_id STRING COMMENT 'Numeric parent_segment_id from td_parent_segments_v'
)
RETURNS TABLE (
  segment_id STRING,
  name STRING,
  description STRING,
  population BIGINT COMMENT 'Number of customer profiles. NULL means the size has not been calculated yet.',
  kind INT,
  updated_at TIMESTAMP
)
COMMENT 'Live list of the segments inside one Treasure AI parent segment.'
RETURN
  SELECT s.segment_id, s.name, s.description, s.population, s.kind,
         try_cast(s.updated_at AS TIMESTAMP) AS updated_at
  FROM (
    SELECT explode(from_json(
      treasure_ai.genie.td_cdp_fetch('list_segments', td_segments.parent_segment_id),
      'ARRAY<STRUCT<segment_id: STRING, name: STRING, description: STRING, population: BIGINT, kind: INT, updated_at: STRING>>'
    )) AS s
  );

CREATE OR REPLACE FUNCTION treasure_ai.genie.td_journeys(
  parent_segment_id STRING COMMENT 'Numeric parent_segment_id from td_parent_segments_v'
)
RETURNS TABLE (
  journey_id STRING,
  name STRING,
  state STRING,
  paused BOOLEAN,
  parent_segment_id STRING,
  launched_at TIMESTAMP,
  updated_at TIMESTAMP
)
COMMENT 'Live list of the journeys built on one Treasure AI parent segment.'
RETURN
  SELECT j.journey_id, j.name, j.state, j.paused, j.parent_segment_id,
         try_cast(j.launched_at AS TIMESTAMP) AS launched_at,
         try_cast(j.updated_at AS TIMESTAMP) AS updated_at
  FROM (
    SELECT explode(from_json(
      treasure_ai.genie.td_cdp_fetch('list_journeys', td_journeys.parent_segment_id),
      'ARRAY<STRUCT<journey_id: STRING, name: STRING, state: STRING, paused: BOOLEAN, parent_segment_id: STRING, launched_at: STRING, updated_at: STRING>>'
    )) AS j
  );

CREATE OR REPLACE VIEW treasure_ai.genie.td_parent_segments_v
COMMENT 'Live list of Treasure AI parent segments (audiences). population = number of customer profiles.'
AS SELECT * FROM treasure_ai.genie.td_parent_segments();
```

### ステップ8：関数をテストする

各クエリを個別に実行します。2つ目と3つ目のクエリでは、1つ目の結果の`parent_segment_id`を使用してください。

```sql
SELECT * FROM treasure_ai.genie.td_parent_segments_v ORDER BY population DESC NULLS LAST LIMIT 10;

SELECT * FROM treasure_ai.genie.td_segments('<parent_segment_id>');
SELECT * FROM treasure_ai.genie.td_journeys('<parent_segment_id>');
```

各クエリは、Treasure AIからその場で取得した行を返します。ジャーニーのクエリはフォルダごとに1回APIを呼び出すため、数秒かかることがあります。

### ステップ9：ユーザーにアクセス権を付与する

`GENIE_USERS`をユーザーのアカウントグループに置き換えてください。`treasure_ai.secrets`には何も付与しないため、ユーザーはキーを読み取れません。

```sql
GRANT USE CATALOG ON CATALOG treasure_ai TO `GENIE_USERS`;
GRANT USE SCHEMA, EXECUTE, SELECT ON SCHEMA treasure_ai.genie TO `GENIE_USERS`;
```

ユーザーには、エージェントのSQLウェアハウスに対する**CAN USE**も必要です。

## フェーズ2：Genie Agentを作成・設定する

### ステップ1：Genie Agentを作成する

1. ナビゲーションメニューで**Genie Agents**を選択し、**+ New**を選択します。**+ New → Genie Agent**からも作成できます。
2. **What should your Genie agent do?**と表示されたら、`Treasure AI CDP`のような短い説明を入力し、**+ Select tables manually**を選択します。
3. **Connect your data**で`treasure_ai` → `genie`を開き、`td_parent_segments_v`を選択して、**Create manually**を選択します。


1. エージェントが開き、自動生成された名前と、**About**タブの**Genie Suggested Description**が表示されます。**Accept**を選択するか、**Edit**で先に編集します。説明はエージェント名の下に表示され、ユーザーがエージェントを開いたときに確認できます。


### ステップ2：SQL関数を追加する

1. **Configure → Sources**を開きます。ビュー`td_parent_segments_v`はすでに一覧にあります。
2. **Add → SQL function**を選択します。


1. **Add SQL Functions**で、カタログ`treasure_ai`とスキーマ`genie`を選び、関数を選択して**Save**を選択します。下表の4つの関数それぞれについて繰り返します。


| 関数  | Genieでの用途  |
|  --- | --- |
| `td_journeys` | 1つの親セグメントのジャーニー |
| `td_segments` | 1つの親セグメント内のセグメント |
| `td_parent_segments` | その場で取得する親セグメントの一覧 |
| `td_cdp_fetch` | 3つのテーブル関数が呼び出す関数です。ソースに追加しないと、エージェントは基になるデータ関数にアクセスできないと回答します |


### ステップ3：指示を追加する

**Configure → Instructions**を開き、次のテキストを**General Instructions**に貼り付けて、**Save**を選択します。

```text
Answer questions about Treasure AI parent segments
(also called audiences), the segments inside them, and journeys.
- Parent segments are in td_parent_segments_v.
- For the segments inside a parent segment, first look up its
  parent_segment_id in td_parent_segments_v by name, then call
  td_segments(parent_segment_id).
- For journeys, look up the parent_segment_id the same way, then call
  td_journeys(parent_segment_id).
- population is the number of customer profiles. Show it with
  thousands separators. NULL means the size hasn't been calculated yet.
- Never guess ids or numbers. If a name matches more than one parent
  segment, ask the user which one they mean.
```

### ステップ4：サンプルクエリを追加する（任意）

**Configure → Examples**を開き、SQLクエリのサンプルを追加して、質問`Which parent segments are the largest?`と次のSQLを入力します。

```sql
SELECT name, population
FROM treasure_ai.genie.td_parent_segments_v
ORDER BY population DESC NULLS LAST
```

**Preview**で結果を確認し、**Save**を選択します。

### ステップ5：名前とウェアハウスを設定する

**About**タブで、**About this agent**の横にある鉛筆アイコンを選択します。**Edit agent details**で、**Name**を`Treasure AI CDP`に、**Default warehouse**をフェーズ1のステップ8でテストしたサーバーレスSQLウェアハウスに設定します。Genieはすべてのクエリと、すべてのTreasure AI API呼び出しを、このウェアハウスで実行します。

### ステップ6：エージェントを共有する

1. 右上の**Share**を選択します。**Sharing: Treasure AI CDP**で、フェーズ1のステップ9でアクセス権を付与したアカウントグループを入力します。
2. 権限の初期値は**Can Manage**です。ユーザーがエージェントとチャットはできても変更はできないように**Can Run**に変更し、**Add**を選択します。


## フェーズ3：Genie AgentからTreasure AIに質問する

ビジネスユーザーは**Genie Agents**を開いて**Treasure AI CDP**を選択し、質問欄の下で**Agent**を選択したまま、たとえば*Show me the journeys for the [SC Demo] Retail - 2026 parent segment*のように質問します。回答を確認するには、IDと母集団をフェーズ1のステップ8の結果と比べます。**Thought process**には、回答の基になったSQLと関数の呼び出しが表示されます。

これらの質問には**Agent**モードを使ってください。`td_cdp_fetch`はテーブル関数ではないため、**Chat**モードでは呼び出せません。

## セキュリティ、コスト、および制限事項

- **課金とクレジット消費**: GenieのAI利用はDatabricksによって課金されます。質問のたびに、SQLとすべてのTreasure AI API呼び出しがエージェントのデフォルトのSQLウェアハウスで実行されます。自動停止までの時間を短く設定した小さなサーバーレスウェアハウスを使うと、コストを抑えられます。Treasure AI側は通常のCDP API呼び出しを処理するだけであるため、Treasure AI Creditsは使用されません。
- **認証情報の分離**: Treasure AI APIキーは、専用のスキーマにあるUnity Catalogのシークレットに保存されます。キーを読み取るのは`SECRETS`句を持つ`td_cdp_fetch`だけで、ユーザーにはそのスキーマへの権限を付与しません。キーをローテーションするには、**Catalog → treasure_ai → secrets → td_api_key**でシークレットの値を更新します。
- **共有のTreasure AIアイデンティティ**: すべてのGenieユーザーは、キーの持ち主である1人のTreasure AIユーザーとして動作します。このユーザーのアクセス権は狭く保ってください。
- **アウトバウンドのネットワークアクセス**: フェーズ1のステップ2のプレビューは、サーバーレスSQLウェアハウスのワークロードからのアウトバウンドアクセスを開放します。可能な場合は、CDP APIホストのみを許可するサーバーレスのエグレスポリシーを使用してください。
- **読み取り専用のメタデータ範囲**: 関数は3つのアクションについて、固定のパスに`GET`リクエストのみを送信するため、GenieがTreasure AIの内容を変更することはできません。返すのはID、名前、母集団、日時などの概要メタデータです。個々の顧客プロファイルの照会、オーディエンスのルールの変更、ジャーニーの起動は行いません。
- **件数の上限やページングなし**: 各アクションは、APIが1回の応答で返すすべての項目を返します。非常に大きなアカウントでは、本番利用の前にページングや絞り込みが必要になる場合があります。
- **HTTPのタイムアウト**: Treasure AI APIの各呼び出しには30秒のタイムアウト（`TIMEOUT_SECONDS = 30`）があります。`list_journeys`はフォルダごとに1回呼び出すため、フォルダが多い親セグメントでは時間がかかります。


## トラブルシューティング

| 症状  | 主な原因  | 対処方法  |
|  --- | --- | --- |
| `Treasure API HTTP 401` | APIキーの誤り、リージョンホストの誤り、またはWrite-Only APIキーが使用された | **Master Key**を使用し（[APIキーの取得](/products/my-settings/getting-your-api-keys)を参照）、`CDP_HOST`がご利用リージョンと一致していることを確認します |
| `Treasure API HTTP 403` | 専用のTreasure AIユーザーに権限がない | 専用のTreasure AIユーザーに親セグメントへのアクセス権を付与します |
| フェーズ1のステップ8での接続またはDNSのエラー | アウトバウンド通信がオフ、またはブロックされている | フェーズ1のステップ2のプレビューを有効にして最大15分待ちます。サーバーレスのエグレスポリシーがCDP APIホストを許可していることを確認します |
| `td_cdp_fetch`の作成時にシークレットに関するエラーが出る | 関数の所有者がシークレットを読み取れない | 所有者に`treasure_ai.secrets.td_api_key`の`READ SECRET`を付与します |
| エージェントが、基になるデータ関数にアクセスできないと回答する | `td_cdp_fetch`がエージェントのソースに含まれていない | フェーズ2のステップ2で`td_cdp_fetch`を追加します |
| ユーザーに権限エラーが表示される | グループへの権限付与が不足している | フェーズ1のステップ9の権限付与を再実行し、ウェアハウスの**CAN USE**を確認します |
| ユーザーがエージェントを見つけられない | エージェントがユーザーに共有されていない | フェーズ2のステップ6のとおり共有します |
| エージェントが関数を呼び出さずに回答する | 指示があいまい、または**Chat**モードが選択されている | フェーズ2のステップ3の指示を具体的にし、**Agent**モードで質問します |
| `population`が空になっている | Treasure AIがそのセグメントのサイズをまだ計算していない | Treasure AIでセグメントの実行を待ちます |


## 次のステップ

- [Databricks Genie One を Treasure AI Studio に接続する](/products/headless/databricks-genie-one) — 各ユーザー自身のStudio権限で、Genie OneからTreasure AI Studioのエージェントやアクションを実行する
- [Databricks Genie Code](/getting-started/ai/databricks-genie-code) — Databricks Genie Code CLIをTreasure AIに接続する
- [Snowflake CoWork](/getting-started/ai/snowflake-cowork) — Snowflake CoWorkで同じ読み取り専用のCDP連携を構成する
- [Databricks上のComposable Audience Studio](/products/customer-data-platform/composable-cdp/audience-studio/databricks) — Zero-CopyでDatabricksテーブル上に直接セグメントを構築する
- [Databricks向けOpen Catalog Access](/products/customer-data-platform/open-catalog-access/databricks-integration) — DatabricksからApache Iceberg形式のCDPテーブルをクエリする