Guilduo Agents：登録・接続リンク・Quest担当とHandoff

役割と必要な権限を登録する

1. https://app.guilduo.com/へログインし、PartyのAgent登録を開きます。
2. 表示名、Provider、役割、作業指示を設定します。例：表示名「実装担当」、指示「変更前に対象を読み、検証結果をレビューへ返す」。
3. 必要なallowedScopesを選びます。Questを扱うならquests:read、更新を任せるならquests:writeも検討します。
4. 保存後、登録されたAgent IDとactive状態を確認します。モデルAPIキーや実行URLは登録しません。

MCP接続を登録Agentへリンクする

公開ツールにはget_agent_link、link_agent、unlink_agentもあります。link_agentはOAuthのagents:writeを必要としますが、Agent登録やAgentの許可範囲拡張を行うツールではありません。

1. MCP接続ガイドに沿って、同じアカウントでOAuth接続を完了します。
2. Connectionsで対象Clientを意図したAgentへリンクします。
3. get_current_agent_contextでAgent IDとeffectiveExecutionScopesを確認します。OAuth認可とAgent許可の共通部分が実行権限です。

Quest担当をプレビューして保存する

list_registered_agentsで実際のAgent IDを取得し、get_questで対象の担当とupdatedAtを読みます。次のJSONはassign_quest_to_agentのプレビュー入力です。プレースホルダーを取得した値へ置き換えます。

1. プレビューで対象Quest、Agent、変更後のHandoffを確認します。readyは作業準備が整った場合に使います。
2. 許可された範囲内で、同じ入力に最新expectedUpdatedAtを付け、dryRunをfalseにして保存します。
3. get_questで再取得し、担当とHandoffが保存されたことを確認します。

{
  "questId": "REPLACE_WITH_QUEST_ID",
  "agentId": "replace-with-agent-id",
  "handoffState": "ready",
  "note": "Improve one help message and return a review summary.",
  "dryRun": true
}

Handoffを進めて成果を返す

遷移はtransition_quest_handoffでプレビューし、保存時はexpectedStateに読み取った現在状態を渡します。古い状態のまま上書きしません。

readyは自動配信やAgent起動の証明ではありません。実際の作業はCodexやClaudeなどの接続元で行います。

Agentの問題を切り分ける

• Agentが一覧にない：ログインアカウント、登録状態、activeかどうかを確認します。古い自由入力担当名は登録Agentと同じではありません。
• 割り当てで競合：対象Questを再取得してupdatedAtを更新し、再プレビューします。
• 読めるが書けない：OAuthとAgentの両方に必要な書き込みスコープがあるか確認します。
• リンク先が違う：意図したAgent IDを確認し、ユーザーの許可範囲でリンクを変更してcontextを再取得します。