接続のトラブルシューティング

昨日まで動いていたコネクターが今日失敗するなら、原因はたいてい5つのうちのどれかです。このページでは、その候補を起こりやすい順にまとめています。

まずここから

エージェントビルダーで、そのエージェントのコネクターを開きます。対応が必要な接続にはそこで印が付いていて、ほとんどの場合、解決方法は再認可です。

再認可しても紐付けは維持されます。同じサービスを同じアカウントで接続すると、2つ目の接続が作られるのではなく、既存の接続が再認可されます。そのため、あとからエージェントごとに紐付け直す必要はありません。

プロバイダーは、一定の期間が過ぎるとアクセスを失効させます。すぐに失効するものもあれば、数か月後に失効するものもあります。接続には再認可が必要だという印が付き、そのサービス用のエージェントのツールは動かなくなります。

解決方法：同じアカウントで接続し直します。

誰かが Google アカウントの設定で endue を削除した、Slack アプリをアンインストールした、または API トークンを削除した場合です。endue は、実際に呼び出してみるまで、これを期限切れと区別できません。

解決方法：再認可するか、新しいトークンを作成して接続し直します。意図的な取り消しだった場合は、endue でも接続を削除して、表示と実態が食い違わないようにしてください。

よくあるのは、仕事用のコネクターを許可したときに、個人の Google アカウントでログインしていたケースです。エラーは出ません。エージェントは間違った受信トレイを見ているので、何も見つからないだけです。

解決方法：プロバイダーで誤ったアカウントからログアウトするか、プライベートウィンドウを使って、意図したアカウントで接続し直します。許可する前に、同意画面に表示されたアカウントを確認してください。

接続自体は正常で、そのリソースが共有されていない状態です。

サービス	症状	解決方法
Slack	履歴を読むときに「チャンネルに参加していない」と表示される	Slack でそのチャンネルにアプリを招待する
Notion	自分には見えているページが、検索で見つからない	Notion からそのページをインテグレーションと共有する
GitLab	プロジェクトやイシューが見つからないと報告される	トークンのユーザーにアクセス権がない可能性がある。スペルではなく権限を確認する
Google	ファイルが見つからない	接続したアカウントに、そのファイルへのアクセス権がない可能性がある

アドレスを入力するコネクター（GitLab、Jenkins、Discourse、WordPress、Mattermost、Grafana、Elasticsearch）では、そのアドレスにインターネットからアクセスできる必要があります。

解決方法：アドレスが正しく、インターネットから公開アクセスできることを確認してから、接続し直します。VPN の内側にあるサービスにはアクセスできません。

その操作が存在しない。各コネクターが提供する操作は決まっています。利用できるコネクターを確認してください。endue が提供していないプロバイダー API の機能は、エージェントから使えません。
接続がこのエージェントに紐付けられていない。接続はアカウント単位、使用はエージェント単位です。
ツールグループがオフになっている。足りない機能がコネクターではなく、メモリ、アウトプット、ルーティン、Web 取得である場合は、エージェントの組み込みツールを確認してください。
操作が承認ゲートで拒否された。無人の実行だったために、自動で拒否された場合も含みます。

endue で接続を削除すると、それに紐付いていたすべてのエージェントから、そのツールがすぐに外れます。既存の会話の履歴は残りますが、エージェントはそれらの呼び出しを行えなくなります。

endue で接続を削除しても、プロバイダー側にある endue のアクセスは取り消されません。完全に断ち切るには、両方で操作してください。