ガイド

自分のエージェントを持ち込む

LangGraph、CrewAI、Mastra など AG-UI に対応したフレームワークで作り、すでに運用しているエージェントを、ワークスペースで一緒に働くコワーカーとして接続する方法です。

4 分で読めます

仕組みこのセクションへのリンクをコピー

AG-UI はエージェントと対話するためのオープンなプロトコルです。ワークスペースが会話を 1 回のリクエストで送り、エージェントはイベントのストリームで答えます。ワークスペースは実行のたびにエージェントのアドレスへ接続するため、エージェントは今ある場所で、自身のコード・モデル・ツールのまま動き続けます。

  • ほかのコワーカーと同じように見つけてチャンネルを始められ、公開範囲も同じです(自分だけの非公開、またはワークスペース全員への公開)。
  • コワーカーの名前・肩書き・役割は、実行のたびに最初のシステムメッセージとしてエージェントに届き、その後にチャンネルのメッセージが続きます。エージェントは自分がどのコワーカーなのかを知ることができます。
  • モデルはワークスペースではなく、エージェント側が選びます。
  • エージェントが自分の側で実行するツールは、ワークスペースの承認や境界ルールではなく、あなたのサービス側で管理されます。どのサービスにも与えるのと同じ範囲のアクセスだけを与えてください。

エージェントを AG-UI で公開するこのセクションへのリンクをコピー

LangGraph、CrewAI、Mastra にはそれぞれ、エージェントをウェブのアドレスで公開する AG-UI 連携があります。ほかのフレームワークでも、同じリクエストに自分で応答できます。どれを使う場合も、そのアドレスは次の条件を満たす必要があります。

  • JSON 本文の POST を受け付け、サーバー送信イベント(SSE)のストリーム(text/event-stream)で応答すること。
  • インターネット経由でワークスペースから到達できること。お手元のコンピューターで動くエージェントにはトンネルか公開アドレスが必要です。プライベートや社内ネットワークのアドレスは拒否されます。
  • キーを設定する場合はそれを確認すること。ワークスペースは実行のたびに、キーを Authorization ヘッダーとして送ります。

コワーカーとして追加するこのセクションへのリンクをコピー

  1. 新しいコワーカーを作り、名前・肩書き・役割を入力します。役割はエージェントに伝わる「何のための存在か」なので、ほかのコワーカーと同じように書いてください。
  2. どこで動かしますか? で 外部エージェント を選び、エージェントのアドレスを エージェントのエンドポイント に入力します。
  3. エージェントがキーを確認する場合は、エージェントの認証キー(任意) に、ヘッダーに入れる形のまま入力します(例:Bearer のあとにトークン)。キーは認証情報保管庫に保存され、変更や削除は次の実行から反映されます。
  4. 接続テスト を選び、下の表のとおり結果を確認してから、コワーカーを作成します。

自分で作成 で作るコワーカーでも同じことができます。独自のエージェントを接続(任意) で 自分のAG-UIエンドポイントで動かす をオンにします。

署名付きの実行とその結果このセクションへのリンクをコピー

コワーカーの稼働状況タブで、エージェントへ送る実行への署名をオンにします。シークレットは一度しか表示されないので、そのときにエージェントへコピーしてください。作り直すと新しいシークレットになり、古いものは一致しなくなります。

  • 各実行には Synthia-Signature: t=<UNIX秒>,v=<シークレットのバージョン>,v1=<16進> が付きます。16進の値は、秒数・ドット・リクエスト本文そのものをつなげたものに対する、シークレットによる HMAC-SHA256 です。
  • 署名が一致しない実行や、時刻があなたの時計と5分以上ずれている実行は拒否してください。本文を JSON として読む前に署名を確かめてください。
  • 同じタブで、直近1日と1週間にエージェントへ送った実行の結果(応答した数、応答が始まるまでの時間、最後の失敗の理由)を確認できます。管理者は、管理 › Bot一覧でこうしたコワーカーをまとめて確認できます。

接続テストこのセクションへのリンクをコピー

接続テストは、短い自動メッセージで実際の実行を 1 回、ワークスペース自身のサーバー(すべての実行の送信元)からエージェントに送り、最大 15 秒待ちます。応答の冒頭だけを読んで接続を切るため、長い返答でフォームが待たされることはありません。

表示意味
応答がありました(イベントの一覧つき)エージェントに到達でき、AG-UI で話せます。イベントは返ってきた種類です。
エージェントがこのリクエストを拒否しました401 または 403 が返りました。キーが必要か、別のキーが必要です。
エージェントが別のステータスで応答しましたそのアドレスには何かがありますが、実行を受け付けませんでした。エージェントの AG-UI のパスかどうか確認してください。
応答はあったが AG-UI のイベントではないアドレスがページなど別の内容を返しました。エージェントのパスではなく、サーバーのトップページであることがよくあります。
エージェントが時間内に応答しませんでした起動中か、ワークスペースからそのアドレスに到達できません。
アドレスに到達できない、または許可されていないワークスペース側から何も応答がなかったか、プライベートなアドレスです。トンネルか公開アドレスを使ってください。

最終更新日