Agents ガイド

最終更新日時 2025年8月25日

効果的なエージェントツールを構築する

エージェントは、次のようにツールを使用します。

ツールの選択: エージェントは、システムプロンプトで入力された名前、説明、コンテキストに基づいてツールを選択します。
ツールの実行: エージェントは、ツールで定義された入力スキーマとプロンプト内の使用例を使用して形式と値を推測し、入力引数を指定します。
出力の解釈: 実行後、エージェントはプロンプトのコンテキストと例を使用して出力を解釈します。

十分なコンテキストが提供されていないと、エージェントはツールへの引数の指定方法やツールからの結果の解釈方法を誤って推測する可能性があります。ツールの設定、使用例、ガードレールにわたる複数の設計方法を適用することで、信頼性を向上できます。

既存のオートメーションを変換してツールとして使用する

既存のワークフローをプロセスとしてパブリッシュするか、Studio Web ソリューションにインポートすることで、ワークフローをツールとして使用できます。入力引数と出力引数を確認して、サポートされている型が使用されていることを確認します。引数の型がサポートされていないと、エージェントがプロセスを呼び出せなくなる可能性があります。

効果的なツール説明を記述する

ツールの説明に以下の詳細を含めると、エージェントの開発者とその他の開発者の双方が、エージェンティックプロセスでツールを効果的に使用できるようになります。

何をするツールか?
ツールにはどのような副作用があるか?
ツールは環境を変更するか?
ツールは、記録システムに対して破壊的な更新を実行する可能性があるか?
ツールを繰り返し呼び出した場合、追加の効果はあるか?
ツールを呼び出すと、エージェントは構造化されていない方法で他のエージェント、ユーザー、またはシステムと対話できるか? この場合、さらなるリスクが生じる恐れがあり、相応の監視を強化する必要が生じる可能性があります。

説明は簡潔でありながら有益で、エージェントの推論をサポートする平易な言葉で記述されている必要があります。

システムプロンプトで使用例を指定する

ツールの使用方法とその出力の解釈方法を示す例をシステムプロンプトに含めると、ツールの精度を大幅に向上させることができます。

たとえば、エージェントが RPA ワークフローを使用して、内部システムで請求書のステータスを確認するとします。エージェントのシステムプロンプトで、次の使用例を指定できます。

Example Usage of ValidateInvoiceStatus Tool

Input:
{
  "InvoiceNumber": "INV-2024-1837" // the unique invoice identifier
}

Output:
{
  "IsValid": true, // boolean indicating if the invoice exists
  "PaymentStatus": "Paid", // payment status of the invoice
  "DueDate": "2025-06-30" // when payment is due (if unpaid)
}

Interpreting the Results:
Result Condition	Agent Interpretation
IsValid = true, PaymentStatus = Paid	"Invoice INV-2024-1837 is valid and has already been paid."
IsValid = true, PaymentStatus = Unpaid	"Invoice INV-2024-1837 is valid but unpaid. It is due by June 30, 2025."
IsValid = false	"There's not a valid invoice with number INV-2024-1837 in the system."Example Usage of ValidateInvoiceStatus Tool

Input:
{
  "InvoiceNumber": "INV-2024-1837" // the unique invoice identifier
}

Output:
{
  "IsValid": true, // boolean indicating if the invoice exists
  "PaymentStatus": "Paid", // payment status of the invoice
  "DueDate": "2025-06-30" // when payment is due (if unpaid)
}

Interpreting the Results:
Result Condition	Agent Interpretation
IsValid = true, PaymentStatus = Paid	"Invoice INV-2024-1837 is valid and has already been paid."
IsValid = true, PaymentStatus = Unpaid	"Invoice INV-2024-1837 is valid but unpaid. It is due by June 30, 2025."
IsValid = false	"There's not a valid invoice with number INV-2024-1837 in the system."