コネクターの概要
コネクターは、すでに使っているサービスとエージェントをつなぎます。endue は30を超えるサービスのコネクターを提供しています。利用できるコネクターを参照してください。自分で運用しているサーバーには、直接接続を追加します。
接続と紐付け
Section titled “接続と紐付け”正しく理解しておきたい考え方は、これ1つです。エージェントの手が届く範囲を予測可能に保っているのが、この区別だからです。
-
接続を認可します。Google、Slack、Notion などのプロバイダーでログインするか、API トークンを貼り付けます。こうしてできた接続は、あなたのアカウントに属します。
-
接続を特定のエージェントに紐付けます。その接続を使えるのは、紐付けたエージェントだけです。
Gmail を接続しても、持っているすべてのエージェントに受信トレイが渡されるわけではありません。メールを読む必要のないエージェントには、紐付けないでください。問題が起こりうる範囲が狭まり、エージェントの判断も予測しやすくなります。
コネクターの場所
Section titled “コネクターの場所”左サイドバーから開くリソース › コネクターには、3つのタブがあります。
| タブ | 内容 |
|---|---|
| 探す | カタログにあるすべてのコネクター |
| 接続済み | 自分のアカウントにある接続 |
| 直接接続 | 自分で運用している MCP サーバーと HTTP API。直接接続を参照してください。 |
サービスを接続する
Section titled “サービスを接続する”-
エージェントビルダーで、エージェントのリソースセクションにあるコネクターを開き、サービスを選びます。
-
認可します。
ほとんどのサービスでは、プロバイダーの画面に移動してログインし、アクセスを許可します。endue が受け取るのは、その同意画面に表示された権限だけです。ほかのサービスでは、プロバイダーの設定で作成した API トークンを求められ、場合によっては自分で設置したサービスのアドレスも入力します。
-
このエージェントに紐付けます。そのサービス用のツールは、エージェントの次の実行から使えるようになります。
接続後にエージェントができること
Section titled “接続後にエージェントができること”各コネクターは一連の操作を提供し、すべての操作はその内容によって、読み取り、書き込み、送信、破壊的操作に分類されています。送信と破壊的操作は、実行前に必ず承認を求めて停止します。その際、使われる引数がそのまま表示されます。
つまり Gmail を接続すると、エージェントは自由に検索して読み取り、確認なしで下書きを作成できますが、送信はあなたが許可したときだけです。
接続は、どちらの側からでも解除できます。
- endue では、接続を削除します。それに紐付いていたすべてのエージェントから、そのツールがすぐに使えなくなります。
- プロバイダーでは、Google、Slack、Notion のアカウント設定で endue のアクセスを取り消すか、API トークンを削除します。
プロバイダー側で取り消すと、endue の接続は、削除するか再認可するまで壊れた状態のまま残ります。接続のトラブルシューティングを参照してください。
- 1つのサービスにつき、1つの接続で扱えるアカウントは1つです。2つの Google アカウントを使うには、接続を2つ認可してください。
- 接続はエージェントごとに紐付けます。「すべてのエージェント」というオプションはありません。
- コネクターが提供する操作は決まっています。汎用の API クライアントではないため、エージェントがプロバイダーの任意のエンドポイントを呼び出すことはできません。自分の API をエージェントに使わせるには、直接接続を使います。
- endue ができるのは、プロバイダーの認可で許された範囲のことだけです。許可されていないスコープの操作は、黙って無視されるのではなく、プロバイダー側で失敗します。