adk-integrations

ADK 統合の管理

ADK プロジェクトで Botpress の統合を見つけ、追加、設定、使用する方法をユーザーに案内するときに、このスキルを使用します。

このスキルを使用する場面

次の場合にこのスキルを有効にします。

• 統合について質問された場合（「Slack を追加するにはどうすればよいですか？」「どのような統合が利用できますか？」）
• 外部サービス（Slack、WhatsApp、Linear など）に接続したい場合
• adk add、adk search、adk info、adk list について言及された場合
• agent.config.ts の依存関係や dependencies.integrations ブロックについて質問された場合
• 統合の設定（OAuth、API キー、Dev Console）についてサポートが必要な場合
• コード内で統合アクション（actions.slack.* など）を呼び出す方法について質問された場合
• エージェントに連携させたい特定のプラットフォームやサービスについて言及された場合
• 統合の登録や設定に関するエラーが発生した場合

利用可能なドキュメント

ファイル	説明
references/discovery.md	統合を見つける方法：adk search、adk list、adk info とすべてのフラグ
references/lifecycle.md	最初から最後までの手順：検索、追加、設定、コードでの使用
references/configuration.md	設定の種類：設定不要、任意、OAuth、API キー、サンドボックス
references/common-integrations.md	chat、webchat、browser、slack、whatsapp、linear、webhook のクイックリファレンス

回答方法

1. まず CLI コマンドを使用します — 提案の前に、adk search、adk info、adk list を使って最新の情報を取得します。Bash ツールから実行してください。
2. adk add の実行前に確認します — プロジェクトに統合を追加する前に、必ずユーザーに確認してください。
3. 必ずバージョンを指定します — adk add <name> だけでなく、adk add <name>@<version> を使用します。
4. 設定要件を説明します — 追加後、adk info --format json の出力に基づいて、必要な設定（OAuth リンク、API キーなど）をユーザーに伝えます。
5. Dev Console を案内します — OAuth フローと認証情報の入力はコードではなく、Botpress Dev Console で行います。

CLI クイックリファレンス

コマンド	説明	主なフラグ
adk search <query>	キーワードで統合を検索	--format json、--limit <number>（デフォルト：20）
adk list --available	Hub のすべての統合を閲覧	--format json、--limit <number>（デフォルト：50）
adk list	インストール済みの依存関係を表示	--format json、--limit <number>（デフォルト：50）
adk info <name>	統合の詳細情報（統合のみ。プラグインは対象外）	--actions、--channels、--events、--full、--format json
adk add <name>@<version>	プロジェクトに統合を追加	--alias <name>、--format json
adk add plugin:<name>@<version>	プロジェクトにプラグインを追加	--alias <name>、--format json
adk remove <name>	統合、プラグイン、またはインターフェースを削除	--format json
adk upgrade [name]	依存関係をアップグレード（または対話形式ですべてをアップグレード）	--format json

CLI の情報を確認するには、--format json を使用します。

重要なパターン

常に CLI を使用する

# CORRECT - Use adk add
adk add [email protected]
adk add plugin:[email protected]
adk add interface:[email protected]

# WRONG - Never manually edit agent.config.ts dependencies
# Don't hand-write entries in the dependencies block

バージョンを固定する

# CORRECT - Pin to specific version
adk add [email protected]

# RISKY - Resolves to latest, may change unexpectedly
adk add browser

統合アクションへのアクセス

// CORRECT - Import from @botpress/runtime, use alias from agent.config.ts
import { actions } from '@botpress/runtime'
await actions.slack.sendMessage({ channel: '#general', text: 'Hello' })

// The alias in agent.config.ts determines the accessor name
// { browser: { version: '[email protected]', enabled: true } }
await actions.browser.webSearch({ query: 'search term' })

設定要件を確認する

# Use --format json to check what configuration an integration needs
adk info slack --format json

# Look at configuration.schema for required fields
# Look at configuration.identifier for OAuth
# Look at configurations for alternative config modes

このスキルで回答できる質問の例

初級

• 「どのような統合が利用できますか？」
• 「エージェントに Slack を追加するにはどうすればよいですか？」
• 「browser 統合とは何ですか？」

中級

• 「WhatsApp をサンドボックスモードで設定するにはどうすればよいですか？」
• 「webchat 統合ではどのようなアクションを利用できますか？」
• 「ワークフローから Linear のアクションを呼び出すにはどうすればよいですか？」
• 「chat と webchat の違いは何ですか？」

上級

• 「プライベートワークスペースの統合を使用するにはどうすればよいですか？」
• 「registration_pending ステータスは何を意味しますか？」
• 「コードをすっきりさせるために統合にエイリアスを設定するにはどうすればよいですか？」
• 「統合の設定スキーマをプログラムから確認するにはどうすればよいですか？」