「売上15%減」の背景にある、
「数字の読み方」をエージェントへ。

go install github.com/na0fu3y/ochakai/cmd/ochakai@latest
ochakai use https://demo.ochak.ai
ochakai search "なぜ売上が落ちている?"   # 問いに関連するナレッジを検索
ochakai get insights/reading-revenue  # ナレッジの詳細と関連リンクを取得

Web UI をブラウザで確認できます。次のコマンドを実行して http://127.0.0.1:8098 を開くと、レビュー画面が表示されます。

ochakai ui --url https://demo.ochak.ai

# 以下は Apple Silicon Mac の例です。Intel Mac は darwin_amd64、Linux は linux_amd64 / linux_arm64、
# Windows は windows_amd64.zip をご利用ください（すべて同じリリースページにあります）
curl -LO https://github.com/na0fu3y/ochakai/releases/download/v0.28.2/ochakai_0.28.2_darwin_arm64.tar.gz
tar xzf ochakai_0.28.2_darwin_arm64.tar.gz
sudo mv ochakai /usr/local/bin/
ochakai use https://demo.ochak.ai
ochakai search "なぜ売上が落ちている?"

構築 Terraform で Cloud Run + Cloud SQL をデプロイ

git clone https://github.com/na0fu3y/ochakai && cd ochakai/deploy/terraform
cp terraform.tfvars.example terraform.tfvars   # project・region・invokers を設定
terraform init
terraform apply    # Cloud SQL の作成に 10〜15 分ほどかかります

# 初回のみの手作業: スキーマの初期化（流し込む SQL は terraform output が表示）
gcloud sql users set-password postgres --instance=ochakai --prompt-for-password
cloud-sql-proxy "$(terraform output -raw sql_connection_name)" --port 55432 &
psql "host=localhost port=55432 dbname=ochakai user=postgres"
# psql の中で「terraform output -raw database_bootstrap_sql」の出力を実行すれば完了

terraform output -raw use_command   # チームメンバーに共有する ochakai use コマンドを表示

Terraform を利用しない場合は、gcloud コマンドだけで構築する手順もガイドに掲載しています。

ナレッジ登録 自組織のデータを登録する

# テーブル定義を取得して投影。ochakai がデータウェアハウスに直接アクセスすることはありません
# ※ --max_rows を指定して全カラムを取得（省略時は先頭 100 行のみの出力になるため注意）
bq query --max_rows=100000 --format=json --nouse_legacy_sql \
  'SELECT table_schema, table_name, column_name, data_type, is_nullable, description
     FROM `your-project.your_dataset.INFORMATION_SCHEMA.COLUMNS`
    ORDER BY ordinal_position' \
  | ochakai seed - | ochakai import -

上記は BigQuery の例です。seed コマンドは INFORMATION_SCHEMA.COLUMNS 形式の JSON を読み込みます。Snowflake や PostgreSQL などでも同様に取り込み可能です。

インポートしたドキュメントは、最初はすべて draft（下書き）として登録されます。そこに人間やエージェントが現場の「読み方・注意点」を書き足すことで、実用的なナレッジへと育ちます。対象範囲の絞り方や記述の進め方は「ナレッジ作成ガイド」、ナレッジを最新に保つ運用サイクルは「運用サイクルガイド」をご覧ください。

claude mcp add ochakai -- ochakai mcp-stdio

{
  "mcpServers": {
    "ochakai": { "command": "ochakai", "args": ["mcp-stdio"] }
  }
}