A Letaido / docs
DOCUMENTATION

コネクター

サードパーティ統合の仕組みと、現在接続されているもの。

Agent-A---Connectors.gif

コネクタとは

コネクタは、サードパーティ API のタイプセーフなラッパーです。AI エージェントがあなたのトークンを使って生の HTTP 呼び出しを自由に行う代わりに、すべての統合は以下のような小規模で監査済みのインターフェースを経由します:

  • 認証情報を別の、スコープ化されたシークレットストアに保持します。
  • スキーマに対して入力と出力を検証します。
  • 新しいサーフェス(チャット、Console、公開サイト)が初めて使用しようとする際に、承認カードを表示します。
  • すべての呼び出しをログに記録します。

つまり、Console ページが Slack を呼び出すことと、チャットエージェントが Slack を呼び出すことは、基盤となる Token を共有できるとしても、それぞれ別個に承認される異なるものであることを意味します。

現在利用可能なもの

人々が通常それぞれで構築するものごとにグループ化されています。

SEO とコンテンツ(Ahrefs)

サイトエクスプローラー、キーワードエクスプローラー、コンテンツエクスプローラー、ランクトラッカー、サイト監査、ブランドレーダー、GSC 統合、ウェブアナリティクス、競合分析、ローカル SEO、レポートビルダー、アラート、バッチ分析、AI コンテンツヘルパー、ソーシャルメディア管理、ダッシュボード。Ahrefs の全機能が統合されています。

典型的な依頼: - 「competitor.com の上位 50 件のオーガニックキーワードを取得して、親トピックごとにグループ化してください。」 - 「優先度の高い 10 件のプロンプトに対して、毎日のブランドレーダーチェックを設定し、変更があれば Slack で通知してください。」

コミュニケーションと運用

  • Slack。 メッセージ、DM、チャンネルの閲覧、リアクション、ファイルアップロード。2つのトークン(ボット、ユーザー)により、エージェントはユースケースに応じてボットとして、またはあなたとして投稿できます。
  • Notion。 ページ、データベース、検索、コメントスレッド。
  • Linear。 課題、プロジェクト、コメント、状態変更時のトリガー。
  • GitHub。 リポジトリ、PR、課題、リリース、Webhook トリガー。

CRM と収益

  • HubSpot. コンタクト、企業、取引、チケット、リスト、ワークフロー、プロパティ。
  • Stripe. 顧客、サブスクリプション、請求書、課金、イベント。
  • Gong. 通話、文字起こし、スニペット、スコアカード。
  • Fathom. 会議録画、要約、アクションアイテム。

マーケティングとメール

  • Mailchimp。 キャンペーン、リスト、セグメント、オートメーション、レポート。
  • Resend。 トランザクションメール送信、テンプレート、オーディエンス。
  • Airtable。 ベース、テーブル、レコード、スキーマ。

ウェブとデータ

  • WordPress。 投稿、ページ、メディア、タクソノミー(読み取りと書き込み)。
  • Apify。 ビルディングブロックとして任意のスクレイパーを実行します。
  • Firehose。 内部イベントストリーム。

ワークスペースに新しいコネクタを追加する方法

リストにないものをリクエストした場合、パスは次のとおりです:

  1. エージェントは、適合する既存のコネクタがあるかどうかを確認します。
  2. ない場合は、サポートチームに連絡して新しいコネクタをリクエストしてください。すべての新しいコネクタは、Letaido に追加される前にレビューおよび承認されるため、新しい統合は生の HTTP ラッパーとしてではなく、検証済みのパスに追加されます。
  3. 待っている間、エージェントは通常、読み取り専用作業のために汎用 API キーと送信ドメイン許可リストにフォールバックできますが、適切なコネクタが常に推奨されます(型付き入力、ログ記録、スコープ付き認証情報、およびサーフェスごとの承認が標準で提供されます)。

X がコネクタとして利用可能かどうかを尋ねることもでき、作業範囲を決定する前に確認してくれます。

承認:オーナーと管理者への注意事項

2026-05-25_14-09-08.png

承認カードが表示されます:

  • 新しい認証情報の追加(Slack ワークスペース、HubSpot ポータル、Ahrefs アカウント)。
  • その認証情報を新しいサーフェスに付与(チャットエージェント、Console ページ、公開サイト)。
  • 新しいドメインへのアウトバウンド HTTPS を許可。
  • 新しい Python パッケージのインストール。
  • 定期ジョブのスケジュール設定。

パターンは常に同じです。ツールがカードを表示し、一度クリックすると、エージェントが再試行します。カードは自動的に期限切れにならないため、エージェントを停止させることなく、1日かけて確認することができます。

内部の仕組み。 コネクタはバージョン管理されており、明示的なスコープリストを持っています。Agent A が Slack トークンを要求する際、現在計画されているすべての用途で必要となる可能性のあるすべてのスコープを一度に要求するため、承認カードが小出しに表示されることはありません。トークンは型付きシークレットストアに保存され、Agent A は名前を参照できますが、直接読み取ることはできません。

Last updated 2026-07-15