Skip to content
AI Studio
/
/
TDX Commands
Last updated

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

WebDesktop

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

注意

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

目的

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

前提条件

  • Treasure AI Studio にサインイン済みであること（はじめに）
  • 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 listCDP オーディエンスセグメントを一覧表示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 projectsLLM プロジェクトを一覧表示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テーブル（デフォルト）人間が読みやすい表示
--jsonJSONAI 処理向けの構造化データ
--jsonlJSON Linesストリーミング／行ごとの処理
--tsvTSVスプレッドシートインポート向けのタブ区切り

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

サーバーサイド実行環境

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

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

サンドボックス実行環境の詳細については、セキュリティ＆パーミッションをご覧ください。

Treasure Studio Labs との違い

機能Treasure Studio LabsTreasure AI Studio
実行環境ローカルマシン（お使いのターミナル）サーバーサイドサンドボックス
コマンドパレットアクション用 Cmd+Shift+PGA では利用不可
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 フラグ付きでコマンドを実行するよう依頼するか、結果の要約を求めてください

次のステップ

Query Result Tables

File Upload & Download