コンテンツにスキップ

コネクターの概要

Markdown で表示

コネクターは、すでに使っているサービスとエージェントをつなぎます。endue は30を超えるサービスのコネクターを提供しています。利用できるコネクターを参照してください。自分で運用しているサーバーには、直接接続を追加します。

正しく理解しておきたい考え方は、これ1つです。エージェントの手が届く範囲を予測可能に保っているのが、この区別だからです。

  1. 接続を認可します。Google、Slack、Notion などのプロバイダーでログインするか、API トークンを貼り付けます。こうしてできた接続は、あなたのアカウントに属します。

  2. 接続を特定のエージェントに紐付けます。その接続を使えるのは、紐付けたエージェントだけです。

Gmail を接続しても、持っているすべてのエージェントに受信トレイが渡されるわけではありません。メールを読む必要のないエージェントには、紐付けないでください。問題が起こりうる範囲が狭まり、エージェントの判断も予測しやすくなります。

左サイドバーから開くリソース › コネクターには、3つのタブがあります。

タブ内容
探すカタログにあるすべてのコネクター
接続済み自分のアカウントにある接続
直接接続自分で運用している MCP サーバーと HTTP API。直接接続を参照してください。
  1. エージェントビルダーで、エージェントのリソースセクションにあるコネクターを開き、サービスを選びます。

  2. 認可します。

    ほとんどのサービスでは、プロバイダーの画面に移動してログインし、アクセスを許可します。endue が受け取るのは、その同意画面に表示された権限だけです。ほかのサービスでは、プロバイダーの設定で作成した API トークンを求められ、場合によっては自分で設置したサービスのアドレスも入力します。

  3. このエージェントに紐付けます。そのサービス用のツールは、エージェントの次の実行から使えるようになります。

接続後にエージェントができること

Section titled “接続後にエージェントができること”

各コネクターは一連の操作を提供し、すべての操作はその内容によって、読み取り、書き込み、送信、破壊的操作に分類されています。送信と破壊的操作は、実行前に必ず承認を求めて停止します。その際、使われる引数がそのまま表示されます。

つまり Gmail を接続すると、エージェントは自由に検索して読み取り、確認なしで下書きを作成できますが、送信はあなたが許可したときだけです。

接続は、どちらの側からでも解除できます。

  • endue では、接続を削除します。それに紐付いていたすべてのエージェントから、そのツールがすぐに使えなくなります。
  • プロバイダーでは、Google、Slack、Notion のアカウント設定で endue のアクセスを取り消すか、API トークンを削除します。

プロバイダー側で取り消すと、endue の接続は、削除するか再認可するまで壊れた状態のまま残ります。接続のトラブルシューティングを参照してください。

  • 1つのサービスにつき、1つの接続で扱えるアカウントは1つです。2つの Google アカウントを使うには、接続を2つ認可してください。
  • 接続はエージェントごとに紐付けます。「すべてのエージェント」というオプションはありません。
  • コネクターが提供する操作は決まっています。汎用の API クライアントではないため、エージェントがプロバイダーの任意のエンドポイントを呼び出すことはできません。自分の API をエージェントに使わせるには、直接接続を使います。
  • endue ができるのは、プロバイダーの認可で許された範囲のことだけです。許可されていないスコープの操作は、黙って無視されるのではなく、プロバイダー側で失敗します。