AIエージェント開発の前に、作業とその境界を設定する

タスクがエージェントの形態を決める

AIエージェント開発とは、モデル、承認された情報、選択されたツールを使用して定義されたタスクを完了するシステムを設計することです。最初の判断は、その作業に、運用ステップを持つエージェント、会話型インターフェース、または焦点を絞ったモニタリングワークフローのどれが必要かということです。明確なタスクがあれば、好みのテクノロジーから始めるよりも、その区別が容易になります。

会話型の体験は、AIチャットボット開発として構成した方が良い場合があり、製品にまたがるタスクは、より広範なWeb3開発に含まれる場合があります。初回の協議では、繰り返し発生するタスク1つ、その現在の担当者、有用な結果の例を1つお持ちください。そうすれば、システムが何を準備すべきか、何を行ってよいか、どこで人間が引き継ぐかを合意できます。

一元的な窓口が決定を統括する

単一の指名された担当窓口が、タスク定義から引き継ぎまで作業スレッドを保持します。その人物がお客様の決定を集約し、許可されたアクションを記録し、実装開始前に承認を得るために提案されたワークフローを提示します。これにより、承認が一箇所に集約され、複数のチームメンバーが同じ質問を個別に解決する必要がなくなります。

プロジェクト資料は、作業協議内で機密扱いで取り扱われます。この開発サービスの一環として、公開向けエージェントとして提示されたり、公開されたりすることはありません。どの例、内部ソース、アクセス詳細を共有するのが適切か、また、それらを承認できる自社側の担当者を、お客様が決定します。

実用的な承認のタイミングは2つあります。最初はワークフローとアクセス境界の確認、次にデプロイ前の評価された動作のレビューです。各時点での書面による承認により、チームは合意内容の明確な記録を得られます。ワークフローとサンプル動作のドラフトは非公開で提示されるため、実際に使用する前に熟考した変更を加えることができます。担当窓口がそれらの修正を調整し、次の決定を可視化します。

実装前に何を確定すべきか？

有用なスコープは、作業がどのように開始され、どのような情報が必要で、満足のいく結果がどのようなものかを説明します。また、エージェントが人間のために一時停止しなければならない箇所も記録します。これらの詳細により、構築は「自動化したい」という漠然とした野心ではなく、運用プロセスに従って進められます。

タスクとその担当者

繰り返し可能なジョブ1つ、現在誰がそれを担当しているか、そして最後に何が必要かを説明してください。例としては、サポートトリアージ、調査とレポート作成、コンテンツ運用、コミュニティアシスタンス、オンチェーンモニタリングなどが考えられます。それぞれについて、典型的な入力と、お客様のチームが受け入れ可能な結果を記載してください。

ツールとソース資料

ワークフローが使用する可能性のあるシステムと情報、およびアクセスを承認できる担当者をリストアップしてください。ナレッジベースが必要な場合は、その資料とそれを管理する担当者を特定してください。製品内のインターフェースの場合は、エージェントを関連するdApp開発作業と連携させてください。Telegramベースの体験の場合は、エージェントとは別に製品実装が必要になる場合があります。

人間に残す判断

承認が必要なアクション、エスカレーションすべきケース、情報が不足している場合の対処法を指定してください。契約関連情報を含むワークフローの場合は、スマートコントラクト開発と併せてエージェントの役割を定義してください。短く書かれた境界は、エージェントがすべてのケースを処理すべきという想定よりも有用です。

構築物は、チームに運用資料を残す

納品物は、合意されたタスクについて、ワークフロー定義からデプロイ支援、引き継ぎまでをカバーします。正確な内容は、お客様が承認した統合とソース資料に従い、運用境界はエージェントを監督する担当者向けに文書化されます。

• ワークフローマップ: タスク入力、許可アクション、レビューポイント、フォールバック経路。
• 統合: 定義されたタスクに必要な承認済みツールとデータソース。
• ナレッジベース: 必要な場合、ワークフロー用に整理されたソース資料。
• 評価セット: 期待される動作を確認するための代表的な例。
• 引き継ぎ資料: 運用ガイダンス、モニタリング考慮事項、運用担当メモ。

評価は、お客様が承認した例に基づいて行われます。レビュー担当者は、出力が要求された形式に従っているか、意図された資料を使用しているか、欠落しているコンテキストを特定しているか、例外を適切にルーティングしているかを確認できます。チームは、何がテストされたか、どこで人間が介入すべきかの説明を受け取ります。

引き継ぎ前に、指名された運用担当者を特定する必要があります。その担当者は、ソース資料の維持、アクセス変更の監督、例外の処理方法の決定を行うことができます。エージェントが既存の製品インターフェースに依存している場合、該当するインターフェースの所有者も関連する決定に参加する必要があります。

評価がリリースの境界を設定する

エージェントが使用可能となるのは、その許可された作業と停止ポイントが、それを監督する人々にとって明確になった時です。

お客様のレビュー担当者が承認した例から評価セットを準備し、通常のリクエスト、不明瞭な入力、人間に回すべきケースを検証します。その結果に基づき、デプロイ前にワークフロー、応答形式、エスカレーションルールを修正します。お客様のレビュー担当者はサンプル動作を確認し、合意されたリリース前に書面による承認を行います。

コミュニティアシスタントの場合、これは許可トピックとチームメンバーが必要な状況を記録することを意味します。調査やレポート作成の場合、レビュー担当者はソースの使用状況や不足情報のフラグ方法を確認できます。オンチェーンモニタリングの場合、チームはどの情報が重要か、どのように受信または評価されるべきかを定義します。

サードパーティAPIは利用可能性が変更される可能性があり、上流ソースが特定のタスクに必要な情報を省略する場合があります。合意された接続をテストし、フォールバック経路を文書化します。一方、お客様のチームは、エージェントが処理を続行できない場合にレビューまたは引き継ぐ方法を保持します。

次の決定は、持ち寄るタスクである

納品は、実装前とデプロイ前にレビューポイントを設けた、測定された順序で進みます。スケジュールは、タスク、統合、ソース資料、レビュー担当者の可用性が理解された後に設定されます。準備された資料を持つコンテナ化されたワークフローは、複数のシステムにまたがるものとは異なる依存関係を持ちます。

より広範な製品の場合、エージェントはWeb3開発やWeb3ウェブサイトと連携させることができ、それらの作業ストリームが関連する場合に有効です。初回の協議の前に、現在のタスクの簡単な説明があれば、作業のスコープ定義の準備ができているかどうかを判断するのに十分です。指名された担当窓口が次の決定を明確にし、非公開のワークフロー協議を手配します。お客様のタスク詳細は、そのプロジェクト協議内で機密扱いのままです。タスクの簡単な説明は、静かに始める場所です。指名された担当窓口が、次の会話を慎重に手配します。

作業の順序は以下の通りです。

1. タスク、その担当者、許容可能な成果を定義します。
2. アクセス、許可アクション、人間による承認をマッピングします。
3. 合意されたワークフロー、統合、必要に応じてナレッジベースを構築します。
4. お客様のレビュー担当者と共に代表的なタスクを評価します。
5. デプロイし、運用を文書化し、チームに引き継ぎます。

仕組み

1. 1. タスクを定義するワークフロー、その担当者、有用な結果の例を共有します。エージェントが処理できる内容と、お客様のチームに残る内容を明確にします。
2. 2. アクセスとレビューをマッピングする必要なツールと情報、許可アクション、承認ポイント、フォールバック経路を実装前に特定します。
3. 3. 合意されたワークフローを構築するエージェント、承認済み統合、必要に応じてナレッジベースを設定し、代表的な評価タスクを準備します。
4. 4. 動作を評価するお客様のレビュー担当者が、合意された基準に基づいてサンプル出力を評価します。デプロイ前にワークフローとガードレールを調整します。
5. 5. デプロイして引き継ぐデプロイを支援し、構築後のエージェントの運用、モニタリング、レビュー方法を説明します。