dot

dot — AI データアナリスト CLI

dot を使うと、AI データアナリストの Dot を通じて自社のデータベースにクエリを実行できます。 Dot は SQL を作成してクエリを実行し、グラフを生成して、結果を説明します。

セットアップ

dot がインストールされていない場合、または PATH から見つからない場合：

• macOS/Linux： curl -fsSL https://app.getdot.ai/install.sh | sh
• Windows： irm https://app.getdot.ai/install.ps1 | iex

インストール後、dot login で認証します（ブラウザーが開きます）。

使用するタイミング

次のような依頼には dot を使用します：

• データに関する質問：「先月の売上はいくらでしたか？」「上位の顧客を表示して」
• 指標と KPI：「解約率はいくらですか？」「地域別の収益」
• SQL クエリ：「…を見つけるクエリを書いて」「データベースを調べて…」
• レポート：「…の概要を作成して」「…を詳しく分類して」
• 「dot に聞いて」「数値を確認して」「データにクエリして」と言われたとき

判断：カタログか質問か

• 利用可能なデータについて尋ねられた場合は、dot catalog を実行します
• 質問が曖昧な場合（具体的な指標、テーブル、期間が指定されていない場合）は、まず dot catalog を実行して利用可能なデータを把握し、その後、対象を絞った質問をします
• 具体的なデータについて尋ねられた場合は、直接 dot "..." を実行します

使用方法

まず利用可能なデータを確認する

質問する前に、dot catalog を実行して利用可能なデータを確認します：

dot catalog

これは即座に返され（LLM 呼び出しはありません）、次の情報が表示されます：

• 利用可能な機能（SQL、ビジュアライゼーション、スケジュール済みレポート、テキスト分析）
• 組織に設定されたカスタムスキル
• データソース接続とテーブル数
• 使用頻度順に並べた上位 50 テーブル（説明、列数、行数を含む）
• 外部アセット（Looker ダッシュボードなど）

質問する

質問を引用符で囲み、Bash 経由で dot を実行します。Dot は完全な AI 分析パイプライン（SQL 生成、実行、ビジュアライゼーション）を実行するため、15～60 秒、複雑なクエリでは最大 2 分かかることもあります。十分なタイムアウトを設定してください：

dot "What were total sales last month?"

追加の質問

各応答にはチャット ID が含まれています。--chat を使って会話を続けます：

dot "Now break down by region" --chat cli-m1abc2d-x4y5z6

キャッシュを回避する場合

応答は永久にキャッシュされます。次の場合は --no-cache を使用します：

• 質問に「今日」「今すぐ」「最新」「現在」が含まれる場合
• ユーザーが「更新」「アップデート」「再実行」と言った場合
• ユーザーが前の回答に満足していないように見える場合

dot "What are today's sales numbers?" --no-cache

応答を受け取った後

1. 出力テキストを解析し、説明をユーザーに提示します
2. グラフの PNG ファイルパス（「Chart saved to: /tmp/dot/...png」）が表示された場合は、PNG ファイルを読み込みます。マルチモーダル機能を使って、グラフが示す内容を説明できます
3. CSV ファイルパスが表示され、ユーザーが詳細な分析を必要としている場合は、CSV データを読み込んで分析します
4. ユーザーの目的に関連する場合は、追加の質問候補を提示します
5. ユーザーが続けたい場合は、出力に記載されたチャット ID とともに --chat を使用します

出力形式

出力には次の内容が含まれます：

• テキストによる説明 — 質問への自然言語での回答
• SQL クエリ — 実行された正確な SQL
• データプレビュー — 列の統計情報を含む、CSV 形式の先頭行
• グラフ — /tmp/dot/<chat-id>/ に PNG として保存されます（読み込んでください。マルチモーダル機能を利用できます）
• CSV データ — 追加の分析用にローカルに保存されます
• Dot URL — ブラウザーでインタラクティブな分析全体を開くリンク
• 追加の質問候補 — 関連する場合は積極的に利用します

複数ステップの分析

複数ステップにわたるデータ分析を実行できます：

1. dot catalog を実行して利用可能なデータを把握します
2. dot "..." で最初の質問をします
3. CSV 出力を読み込み、さらに分析したり、独自の計算を行ったりします
4. --chat を使って追加の質問をし、結果を絞り込みます
5. 複数のクエリの結果を比較します

キャッシュ

• dot "question" — --clear-cache を実行するまで永久にキャッシュされます
• --chat を使った追加の質問はキャッシュされません（常に最新の結果が返されます）
• dot catalog はキャッシュされません（すでに高速で、LLM も使用しません）

新しいリクエストを強制するには --no-cache を使用し、キャッシュされたデータをすべて消去するには --clear-cache を使用します。

適切な質問をするためのヒント

• まず dot catalog を実行して、利用可能なテーブルとデータを確認します
• 具体的に質問します。指標名、期間、フィルターを含めてください
• 質問は一度に1つにすると、最もうまくいきます
• 複数の質問をまとめるのではなく、追加質問（--chat）で内容を絞り込みます
• グラフが必要な場合は、「…のグラフを表示して」や「…を可視化して」と伝えます

エラー：コマンドが見つかりません

dot が見つからない場合は、インストールするようユーザーに伝えます。

curl -fsSL https://app.getdot.ai/install.sh | sh
dot login

エラー：認証されていません

「Not authenticated」と表示された場合は、ユーザーにログインしてもらう必要があります。

dot login

dot login が機能しない場合（例：ブラウザーを利用できない、SSO の問題がある場合）は、ユーザーが API トークンを手動で作成できます。

1. ブラウザーで Dot ダッシュボードを開きます（例：https://app.getdot.ai または会社の Dot URL）
2. Settings > Users > API Tokens に移動します
3. ユーザーにスコープを設定した新しいトークンを作成します
4. 次のコマンドで使用します：dot login --token <TOKEN> --server <SERVER_URL>

エラー：認証に失敗しました

「Authentication failed」と表示された場合は、トークンの有効期限が切れている可能性があります。ユーザーに再ログインしてもらう必要があります。

dot login

エラー：接続に失敗しました

dot がサーバーに接続できない場合は、インターネット接続を確認するようユーザーに伝えます。 カスタムサーバーを使用している場合は、dot status で URL を確認します。

デバッグ

dot status を実行して、ログイン中のユーザー、設定されているサーバー、トークンの有効期限が切れているかどうかを確認します。

例

# See what data is available
dot catalog

# Simple question
dot "What were total sales last month?"

# With follow-up
dot "Compare to the same period last year" --chat cli-m1abc2d-x4y5z6

# Chart request
dot "Show me a chart of monthly revenue trend for the past 12 months"

# Specific filters
dot "Top 10 customers by order count in Q4 2025, US only"

# Force fresh answer (bypass cache)
dot "What were total sales last month?" --no-cache