第5章

チャネルとコネクタ

エージェントは、届く場所の分だけしか役に立ちません。この章では、四種類のつながりを扱います。メッセージングチャネル、接続済みアカウント、MCPサーバー、そしてWebhookです。

全章

四種類のつながり

  • メッセージングチャネル 。人々がエージェントに届く方法です。エージェントごとに、その Connectors タブで設定します。
  • Connected accounts 。エージェントがあなたの業務ツールに届く方法です。環境全体で、あるいはエージェントごとに、 接続 セクションで設定します。
  • MCPサーバー 。外部サービスが公開する追加のツールで、エージェントの MCP タブで設定します。
  • Webhook 。双方向のマシン間イベントで、エージェントの Webhook タブで設定します。

メッセージングチャネル

Olano は15以上のメッセージングチャネルに対応します。コネクタの選択画面には、確認済みのものが並びます。Telegram、WhatsApp、Discord、Slack、Signal、Twilio経由のSMS、DingTalk、Feishu/Lark、WeCom、Weixin、QQ Bot、DeBoxです。そのどれもが、案内付きの型指定フォームと、その横に置かれたセットアップガイドを通じて追加されます。チャネルを追加するのに、生の設定を編集することは決してありません。

  1. エージェントを開き、Connectors タブへ進み、Add を押します。 プラットフォームを選びます。表示されるフォームは、そのプラットフォームに必要なものだけを尋ねます。どの項目にも、それが何をするか、受け付ける形式、そして空欄のままにした場合どうなるかを説明するヒントが付いています。
  2. 認証情報を入力します。 Telegram は @BotFather から取得するボットトークンを求めます。Slack はボットトークンとアプリトークンを求めます。Discord はボットアプリケーションを求めます。項目にはその認証情報の正確な名前がラベルとして付き、値はエージェントの設定にではなく、あなたの暗号化されたボールトに保存されます。
  3. ペアリング。ペアリングが仕組みである場合。 WhatsApp はフォーム内の Pair / Connect ボタンです。Signal には案内付きのウィザードがあります。番号を登録し、キャプチャを解き、コードを確認し、プロフィール名を設定します。WeChat はQRコードを表示し、それをスキャンして確認すると、スキャンしたアカウントがそのエージェントに固定されます。
  4. 誰が話しかけてよいかを決めます。 ほとんどのコネクタには許可リストがあります。Telegram、WhatsApp、DeBox、DingTalk では、これが厳格な関門です。リストにある送信者だけが入り、それ以外は入れません。Slack、メール、SMS、Matrix、Mattermost では、同じ項目が trusted users(信頼済みユーザー) を示すだけです。ほかの誰もブロックすることなく、所有者としての権限を与えます。
  5. 保存してエージェントを再起動します。 チャネルの認証情報は、エージェントが起動するときに読み込まれます。したがって、新しいトークンや変更したトークンを反映させるには再起動が必要です。

コネクタの各行には、状態と診断結果が表示され、シークレットらしき値はマスクされます。行の下には、実際にどの認証情報が使われているかを示す注記があります。このエージェント用に設定されている、共有された値を使っている、あるいはまったく設定されていない、のいずれかです。

注意

二つのエージェントが一つのボットトークンを共有すると、そのうちの一方しかメッセージを受け取れません。プラットフォームは各メッセージを一度しか配送しないからです。すべてのエージェントに、それぞれ専用のボットと専用のトークンを与えてください。ダッシュボードは、衝突を検知すると警告します。

注記

認証情報が足りないと、その一つのコネクタだけが飛ばされ、エージェント全体が壊れることはありません。エージェントはそれでも起動し、ダッシュボードでの応答も続けます。Overview の通知が、足りないキーの名前を示し、それを直せるコネクタパネルへのリンクを張ります。

エージェントはチャットの中でどう振る舞うか

スラッシュコマンドは、ダッシュボードだけでなく、すべてのメッセージングプラットフォームで動きます。受信したテキストは、モデルに届く前にコマンド一覧と照合されます。そのため、 /help/new/context/tools/skills などはすべて、質問として答えられるのではなく、実行されます。エージェントがどのコマンドを公開するかは、エージェントごとに、その Commands タブで設定されます。機密性の高いものは既定でオフになっており、独自のショートカットも定義できます。

エージェントの作業がチャットにどれだけ表示されるかは、会話ごとに、 /quiet/normal/verbose。通常は、エージェントが作業しているあいだライブのチェックリストとツール呼び出し1件につき1行を表示し、その後で答えに置き換えます。静音は答えだけを表示します。これは顧客と接するボットに向いた選択であり、エージェントの既定として設定すれば最初のメッセージから適用されます。

グループでの振る舞いはプラットフォームごとに違うので、確認しておく価値があります。WhatsAppは既定ではグループのすべてのメッセージを処理します。これを グループ受信設定 を「@メンションのみ」に切り替えてください。積極的すぎる場合はそうします。あるいは、聴くだけモードを使えば、エージェントは一切返信せずにグループを見守るだけになります。Telegramにはグループポリシーの設定があり、名簿にないメンバーがグループ内で発言できるかどうかを決められます。一方でダイレクトメッセージは引き続き制限されます。

業務アカウントを接続する

その 接続 セクションには、サインインする外部サービスごとにカードが1枚ずつ並びます。Google(Gmail、Calendar、Drive、Docs、Sheets)、Microsoft 365、Salesforce、QuickBooks、X、FacebookとInstagram向けのMeta、LinkedIn、Reddit、Fitbit、Shopify、Buffer、DocuSign、GitHub、GitHub CLIです。各カードにはその状態と、それが何を可能にするかが示されます。

接続はリンクをコピーする流れで行います。パネルには 認可ページを開く ボタンと リンクをコピー ボタンです。どの端末でも構いません。ノートパソコンでもスマートフォンでも開いて、そこで承認すると、パネルは自動で 接続済み 。認可する前に、パネルはプロバイダーのコンソールに登録すべき正確なリダイレクトURIをコピーボタン付きで表示します。表示どおりに正確に登録してください。そうしないとプロバイダーが認可を拒否します。

スコープは2種類あります。 System は、すべてのエージェントが使う一つの接続を意味します。 エージェントごと は、その一体のエージェントだけに専用アカウントを与えます。任意の共有トグルもあり、オンにすれば他のエージェントもそれに頼れます。接続すれば、ツールはそれ以上の設定なしに認証情報を取り込み、プロバイダーが対応していればトークンは自動で更新されます。

これらのアカウント、組み込みのツールキット、そしてプラットフォーム自身のユーティリティが合わさって、エージェントは75以上の組み込み統合にまたがる450以上のコネクタツールにアクセスできます。とはいえ第2章で述べたとおり、エージェントは自分の仕事に必要なものだけを持つべきです。

ヒント

サインインが必要な人がダッシュボードの前にいない場合、管理者は短命でPINによって守られたマジックリンクを発行できます。発行元は Config → マジックリンク。それは実際のサインインを行う小さな1ページを開き、完了すると元のチャットに結果を報告します。リンクとPINは一度だけ表示され、あとから見返すことはできません。

MCPサーバー

MCPサーバーは、エージェントが呼び出せるツールを公開する外部サービスです。ディレクトリには200以上のMCPサーバーが載っており、エージェントの MCP タブが、それらを追加する場所です。

ガイド付きフォームは、まず サービスを接続 検証済みプロバイダーを網羅したプリセット選択で始まります。Stripe、HubSpot、Notion、GitHub、Linear、Sentry、Canvaなどです。アドレスをあらかじめ埋め、そのプロバイダーに必要な項目だけを表示します。トランスポートの詳細、ヘッダー、スコープは Advanced の開閉パネルにまとまり、そして Custom オプションが、一覧にないものすべてに対応するフルフォームを残しておきます。

接続 を押すと、段階的なログでサーバーを調べ、何が必要かを割り出し、サインインが要る場合はあなたに代わって認可の流れを始めます。承認はプロバイダー自身のページで行い、リダイレクトでハンドシェイクが完了します。その後、サーバーごとのピルが接続の健全性とサインイン状態を示します。期限切れを検知するトークンピルもあり、それは 再認可 ボタンを添えます。期限切れのトークンを平気なふりで放置することはありません。

日々役に立つ工夫が二つあります。サーバーが公開する個々のツールを有効・無効にできるので、40個のツールを提供するサーバーからでも欲しい3個だけを取り込めます。そして エージェントを再読み込み ボタンが、再起動なしで稼働中のエージェントに新しいツールを差し替えます。そのため、新しく認可されたサーバーはすぐに使えるようになります。

Webhook

その Webhook タブは、両方向を扱います。

アウトバウンド は、選んだURLへエージェントのイベントを送信します。名前、ペイロードURL、送るイベントを指定し、任意で署名シークレットを設定すれば、受信側は配信を検証できます。レート制限、再試行、タイムアウト、TLS検証はすべて設定可能で、各行が成功と失敗の件数をリアルタイムで示します。

インバウンド は、より面白いほうの半分です。外部システムがエージェントにペイロードを渡せるようにします。あなたは 処理用プロンプト を書いて、そのWebhookが何であり、どう処理すべきかを説明します。送信者が投稿するフィールドはすべて自動的に追記されます。そしてエージェントが送信者に同期的に返信するかどうか、ペイロードが一つの会話にたまっていくのか、それとも毎回まっさらに始まるのかを選びます。保存すると、その行には自己認証型の受信URLがコピーボタン付きで表示されます。それを送信する側に渡してください。

どちらの種類にも テスト ボタンがあり、サンプルを送って結果を表示します。そして 履歴 過去の配信を見るビューです。編集はその場で反映されます。