composio

適用する場合

• 外部アプリ（Gmail、Slack、GitHub、Notion など）にアクセスしたり、操作したりしたい場合
• 外部サービスを使ってタスクを自動化したい場合（メールの送信、課題の作成、メッセージの投稿など）
• 外部ツールと連携する AI エージェントやアプリを構築する場合
• 外部サービスへのユーザーごとの接続が必要なマルチユーザーアプリを構築する場合

セットアップ

CLI がインストールされているか確認し、インストールされていない場合はインストールします。

curl -fsSL https://composio.dev/install | bash

インストール後、ターミナルを再起動するか、シェル設定を読み込んでから認証します。

composio login       # OAuth; interactive org/project picker (use -y to skip)
composio whoami      # verify org_id, project_id, user_id

ブラウザーに直接アクセスできないエージェントの場合：composio login --no-wait | jq で URL／キーを取得し、ユーザーに URL を共有します。ユーザーがログインを完了したら、composio login --key <cli_key> --no-wait を実行します。

---

1. Composio CLI でアプリを使う

次の場合に使用します： ユーザーがコードを記述せずに外部アプリを直接操作したい場合。エージェントは CLI を使って、ユーザーに代わってツールを検索、接続、実行します。

主なコマンド（新しいトップレベルエイリアス）：

• composio search "<query>" — ユースケースに合ったツールを検索します
• composio execute "<TOOL_SLUG>" -d '{...<input params>}' — ツールを実行します
• composio link [toolkit] — ユーザーアカウントをアプリに接続します（エージェントの場合、非対話モードでは常に --no-wait を使用します）
• composio listen — リアルタイムのトリガーイベントを待ち受けます

一般的なワークフロー：検索 → 接続（必要な場合）→ 実行

詳細なリファレンス：Composio CLI ガイド

---

2. Composio でアプリとエージェントを構築する

次の場合に使用します： Composio SDK を介して外部ツールと連携する AI エージェント、アプリ、バックエンドサービスのコードを記述する場合。

API キーを設定するため、プロジェクトディレクトリ内で最初に次を実行します。

composio init

詳細なリファレンス：Composio を使った構築