実際の仕事を一つ選ぶ
Codeer を最も早く理解する方法は、繰り返し発生し、結果の判断に詳しい人が必要な状況を一つ持ち込むことです。
最初からすべての機能を設定しないでください。まず短い仕事の説明を書きます。
- 状況：何が起き、誰が助けを必要としているか
- 結果：Agent はその人の何を完了させるのか
- 品質：どのような結果なら正しく有用か
- 境界：何を避け、確認し、いつ人に戻すべきか
たとえば、承認済みの講座情報への回答、教師が次に試す行動の整理、専門基準に沿った草案レビューなどです。実際の仕事で見たことのある状況を一つ選びます。
このガイドで完了すること
このガイドを終えると、次の状態になります。
- 定義した仕事に対応する Agent の初版がある
- 仕事を代表する実際のシナリオと、いくつかの隣接する境界がある
- 確認可能な条件を持ち、再実行できる must-pass case がある
- 制御された範囲を公開するか、改善を続けるかを判断できる
- 公開後の新しい会話に対応し、そこから学ぶ方法がある
一つのテストに合格しても、事業、サービス、学習の成果が証明されたことにはなりません。確認した Agent の動作についての証拠になります。
公開 gate はチームが管理します
Test Suite は case と評価結果を保存し、Agent version history は作業版を保存します。ただし、必要な case が失敗した時に公開を自動で止めたり、承認者と停止条件を公開記録として保存したりはしません。公開前に、チームが must-pass set を選び、証拠を確認し、検証済みの範囲だけを公開に沿って判断を記録します。
誰が何を決めるか
| 役割 | このガイドでの主な判断 |
|---|---|
| 専門家／責任者 | 良い結果、安全でない結果、公開できる範囲 |
| 運用担当者 | 今対応する会話、新しい case として残す状況 |
| 管理者／実装担当者 | Agent が使う workspace、情報源、チャネル、権限、ツール |
一人が複数の役割を担うこともあります。同じ人でも、判断の種類は分けて考えてください。
最初に進める流れ
ステップ1：workspace と仕事を選ぶ
Agent が同じ顧客、ナレッジ、運用担当者、memory scope を共有する場合は、既存の workspace を使います。これらの境界を分離する必要がある場合は、新しい workspace を作ります。
Agent Editor を開く前に仕事の説明を書きます。結果や境界をまだ説明できない場合は、実際の状況を一つ使って具体化します。
ステップ2：初版を作る
workspace で AIエージェント を開き、新規作成 をクリックします。
- 仕事に合う Template がある場合は
Template を使うを選びます。設定の質問に答えて draft を生成し、Agent 作成前にすべての項目を確認します。 - 合う Template がない場合は
空白から始めるを選びます。仕事、品質条件、境界を自然な言葉で説明し、必要に応じて Copilot で初版に整理します。
どちらも同じ Agent Editor に戻り、その後は同じ検証手順を使います。
ステップ3：実際の状況を試す
Live Test で仕事の説明に使った状況を実行します。次に、情報不足、範囲外の依頼、危険な約束、人が引き継ぐべき場面など、いくつかの隣接する境界を試します。
この段階では最初の動作を確認します。すべての利用者に対応できると証明する段階ではありません。
ステップ4：must-pass 動作を残す
今後も必ず正しく動くべき状況を、Test Suite で再実行できる case として保存します。別の reviewer が推測せず判断できる Standard を設定します。
最初の確認では、実際の状況一つと、いくつかの隣接する境界で設計上の問題を見つけられます。制御された pilot の前に、頻度、失敗時の影響、ツール利用、handoff risk に応じて case set を増やします。すべての Agent に共通する固定件数はありません。
→ 検証済みシナリオ
ステップ5：制御された範囲を公開する
専門家または責任者が must-pass 動作と、未検証の仕事に対する fallback を確認してから公開します。最初の利用者は、運用担当者が観察して対応できる範囲に絞ります。
ステップ6：対応し、学び、再検証する
会話 で実際に起きたことを確認します。人が必要なら先に対応し、残すべき新しい判断を case にし、必要な箇所だけ変更して、次の version を公開する前に影響する case を再実行します。
→ 会話に返信