# TDX コマンド（サーバーサイド CLI）

ターミナルは不要です。フル機能の tdx CLI が Studio のサーバーサイドサンドボックス内で動作するため、チャットを離れることなく、ローカルで使い慣れたコマンドでデータベースのクエリ、セグメントの管理、設定の検証が行えます。

注意
TDX コマンドは、お使いのローカルマシンではなく、隔離されたサンドボックス実行環境で実行されます。Treasure AI の認証情報はサーバーサイドで管理され、ブラウザには保存されません。ネットワークアクセスは Treasure AI API および認可済みエンドポイントに制限されています。

## 目的

AI を通じて tdx CLI コマンドを実行し、Treasure AI リソースを正確かつオンデマンドで制御します。これにより、AI の自律的なマルチステップワークフローを補完します。

## 前提条件

- Treasure AI Studio にサインイン済みであること（[はじめに](/ja/products/ai-studio/getting-started)）
- **Web または Desktop のみ** — TDX コマンドはモバイルでは利用できません


## TDX コマンドの実行

AI に任意の tdx コマンドの実行を依頼してください。コマンドはサーバーサイドサンドボックスで実行され、出力はツールコール結果としてチャット内にインラインで表示されます。


```
ユーザー: tdx databases を実行して利用可能なものを表示してください

AI: [サンドボックスで tdx databases を実行]
    データベースが 12 件あります。最近更新されたものは以下のとおりです...
```

### 直接コマンドを使用する場面

- **クイックルックアップ。** AI に `tdx databases` や `tdx tables mydb` の実行を依頼して、利用可能なデータを確認します。
- **精密な制御。** 実行するコマンドが明確な場合は、AI に直接実行を指示します。推論フェーズをスキップして即座に実行されます。
- **検証。** AI に `tdx sg validate segment.yaml` や `tdx journey validate journey.yaml` の実行を依頼して、設定を検証します。
- **デバッグ。** AI に `tdx api --type td /v3/job/list` の実行を依頼して、生の API レスポンスを確認します。


### AI にコマンドを選択させる場面

「カスタマーデータベースを調査し、最も有用なテーブルを見つけて、高価値ユーザーのオーディエンスセグメントを構築する」といったマルチステップワークフローの場合は、AI にコマンドを任せてください。AI が適切な一連のコールをチェーンし、結果を解釈して作業を継続します。

## 利用可能な TDX コマンド

フル機能の tdx CLI がサンドボックスで利用できます。よく使用されるコマンドグループを以下に示します。

### データコマンド

| コマンド | 説明 | 例 |
|  --- | --- | --- |
| `tdx databases` | すべてのデータベースを一覧表示 | `tdx databases` |
| `tdx tables <db>` | データベース内のテーブルを一覧表示 | `tdx tables mydb` |
| `tdx describe <db.table>` | テーブルスキーマ（カラムと型）を表示 | `tdx describe mydb.users` |
| `tdx show <db.table>` | テーブルの内容をプレビュー（制限付き SELECT *） | `tdx show mydb.users` |
| `tdx query "<sql>"` | Trino SQL クエリを実行 | `tdx query "SELECT * FROM mydb.users LIMIT 10"` |
| `tdx job list` | 最近のクエリジョブを一覧表示 | `tdx job list` |


### CDP コマンド

| コマンド | 説明 | 例 |
|  --- | --- | --- |
| `tdx segment list` | CDP オーディエンスセグメントを一覧表示 | `tdx segment list` |
| `tdx sg validate <file>` | セグメント YAML ファイルを検証 | `tdx sg validate segment.yaml` |
| `tdx parent-segment list` | 親セグメントを一覧表示 | `tdx parent-segment list` |
| `tdx journey list` | ジャーニーを一覧表示 | `tdx journey list` |
| `tdx journey validate <file>` | ジャーニー YAML ファイルを検証 | `tdx journey validate journey.yaml` |
| `tdx activations <segment>` | セグメントのアクティベーションを一覧表示 | `tdx activations parent/child` |


### AI コマンド

| コマンド | 説明 | 例 |
|  --- | --- | --- |
| `tdx agents` | 現在のプロジェクトのエージェントを一覧表示 | `tdx agents` |
| `tdx llm projects` | LLM プロジェクトを一覧表示 | `tdx llm projects` |


### コンテキスト＆ユーティリティコマンド

| コマンド | 説明 | 例 |
|  --- | --- | --- |
| `tdx status` | 認証ステータスと現在のコンテキストを表示 | `tdx status` |
| `tdx use database <db>` | セッションのアクティブなデータベースを設定 | `tdx use database mydb` |
| `tdx api <endpoint>` | 生の API リクエストを実行 | `tdx api --type td /v3/job/list` |


プロのヒント
リストコマンドのエイリアスとして複数形を使用できます：`tdx databases` = `tdx database list`、`tdx tables mydb` = `tdx table list mydb`、`tdx segments` = `tdx segment list`。

## 出力フォーマット

デフォルトでは、tdx は人間が読みやすいテーブル形式で結果を出力します。フラグを使用して出力フォーマットを制御できます。

| フラグ | フォーマット | ユースケース |
|  --- | --- | --- |
| `--table` | テーブル（デフォルト） | 人間が読みやすい表示 |
| `--json` | JSON | AI 処理向けの構造化データ |
| `--jsonl` | JSON Lines | ストリーミング／行ごとの処理 |
| `--tsv` | TSV | スプレッドシートインポート向けのタブ区切り |


AI が代わりに tdx コマンドを実行する場合、プログラム的に処理しやすい構造化出力を取得するために `--json` を使用することがあります。

## サーバーサイド実行環境

すべての tdx コマンドは、お使いのローカルマシンではなく、隔離されたサーバーサイドサンドボックスで実行されます。これは以下を意味します。

- **Treasure AI の認証情報**はサーバーサイドで管理され、ブラウザには保存されません
- **ネットワークアクセス**は Treasure AI API および認可済みエンドポイントに制限されています
- **ファイルシステムのスコープ**はチャットセッションの作業ディレクトリに限定されます
- **ローカルへの副作用なし** — お使いのコンピューターへのインストールや読み取りは行われません


サンドボックス実行環境の詳細については、[セキュリティ＆パーミッション](/ja/products/ai-studio/security)をご覧ください。

## Treasure Studio Labs との違い

| 機能 | Treasure Studio Labs | Treasure AI Studio |
|  --- | --- | --- |
| **実行環境** | ローカルマシン（お使いのターミナル） | サーバーサイドサンドボックス |
| **コマンドパレット** | アクション用 `Cmd+Shift+P` | GA では利用不可 |
| **MCP ツール** | ローカル MCP サーバー経由で接続 | GA では利用不可（MCP は GA 後） |


技術的な注意事項
Treasure Studio Labs では、tdx コマンドはローカルの tdx インストールを使用してローカルマシン上で直接実行されていました。Treasure AI Studio では、同じコマンドがマネージドの tdx インストールを使用してサーバーサイドサンドボックスで実行されます。コマンドの構文は同一ですが、実行環境が変わっています。

## 確認

- [ ] AI に `tdx status` の実行を依頼して、認証ステータスとリージョンを確認する
- [ ] AI に `tdx databases` の実行を依頼して、Treasure AI データベースの一覧を確認する
- [ ] ツールコールを展開して、完全なコマンドと生の出力を確認する


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

| 問題 | 解決策 |
|  --- | --- |
| コマンドが「not found」または空の出力を返す | Treasure AI アカウントに期待するデータベースとリソースがあることを確認してください。AI に `tdx status` の実行を依頼して、認証とリージョンが正しいことを確認してください |
| 出力が切り捨てられる | 大きな出力はチャットに収まるようにトリミングされます。AI に `--format json` フラグ付きでコマンドを実行するよう依頼するか、結果の要約を求めてください |


## 次のステップ

- [クエリ実行](/ja/products/ai-studio/query/query-execution) — AI を通じた Trino クエリの実行
- [クエリ結果テーブル](/ja/products/ai-studio/query/query-results) — クエリ結果の表示について
- [スキル＆マーケットプレイス](/ja/products/ai-studio/skills/skills) — SQL、セグメントなど向けのプリビルトスキル