エージェントへの指示の追加
AIエージェントは、ユーザーの入力にどのように反応し、タスクを実行し、異なるチャネル間でどのように相互作用するかを定義する一連の行動命令に基づいて動作する。 これらの指示はエージェントの内部ガイドラインとして機能し、さまざまなシナリオで一貫した効果的な行動をとるのに役立つ。
これらの指示を構成することにより、エージェントが組織のトーン、ビジネス目標、およびユーザの期待に沿うようにすることができます。 エージェントが質問に答えるにせよ、ツールを起動するにせよ、他のエージェントと共同作業をするにせよ、これらのルールはシームレスでプロフェッショナルな体験を維持するのに役立ちます。
指示は Agent Builder のビヘイビアセクションに追加される。 一度追加されると、すべてのチャネルとタスクにグローバルに適用される。
指示とは
命令は、エージェントの行動を形作る設定可能なルールである。 エージェントがどのように反応するか、いつツールを起動するか、他のエージェントとどのように協力するかを決定する。 指示は、 Agent Builder の行動セクションに追加され、すべてのチャンネルとタスクにグローバルに適用されます。
使用上の注意
使いたいときに使いなさい：
- エージェントのトーンをあなたのブランドと合わせる。
- エージェントが特定のシナリオをどのように処理するかを制御します。
- チャネルやタスク間で一貫性のある行動をとる。
- ツールや他のエージェントとのコラボレーションを可能にする。
開始前に
エージェントに指示を追加する前に、それがどのように機能し、どのような影響を与えるのかを理解することが重要です：
指示は既存のものを上書きします：新しい指示を入力すると、以前に定義されたルールが置き換えられます。 バージョン管理やロールバックはサポートされていませんので、保存する前に変更内容をよく確認してください。
変更は自動的に保存されます：指示を入力または変更すると、即座に適用されます。
指示がない場合、デフォルトが適用されます：指示フィールドを空白のままにすると、エージェントは内蔵ロジックに依存します。 一般的なユースケースには有効だが、特定のビジネスニーズには合致しないかもしれない。
指示はグローバルに適用されます：追加した指示は、すべてのチャネル（例：チャット、Slack）とエージェントが実行するすべてのタスクに適用されます。 現在のところ、ユーザーコンテキスト、チャンネル、タスクタイプに基づいて条件付き命令を設定することはできません。
指示を追加する手順
エージェントの動作を定義または更新します：
- メインメニューから「 ビルド 」に進む。
- エージェントを作成 > ゼロから作成をクリックします。
- 名前と 説明を入力します。
- ビヘイビアのセクションへ。
- 指示欄には、明確で実行可能なルールを入力する。
効果的な指示の書き方をまず見直す エージェントが期待通りに行動することを保証するために不可欠なものだ。 - 変更内容は自動的に保存されます。
指示が追加されると、エージェントはすべての会話ですぐにそれを使い始める。 これらのルールは、すべてのタスクと接続されたチャネルにわたって、エージェントがユーザのリクエストにどのように応答するかに影響します。
コンテキスト変数によるエージェントの応答のカスタマイズ
AIエージェントは、対話するユーザーとすでに利用可能な情報に基づいて、反応を調整することができる。 コンテキスト変数は、現在の状況やユーザープロファイルを反映した、ダイナミックでパーソナライズされた返信を可能にする。
コンテキスト変数は、エージェントの動作に渡すことができる、電子メールID、場所、またはメンバーシップIDのような、ユーザ固有のデータのプレースホルダのように動作します。 これによって、エージェントはよりインテリジェントになり、応答性が高まり、適切な対応ができるようになります。
コンテキスト変数を使用する利点
- パーソナライズされた回答：ユーザーの名前を使って挨拶したり、所在地を参照したり、ユーザーの役割や好みに合わせて回答を調整したり。
- セッションの継続性：ユーザーに繰り返しを求めることなく、複数のステップやタスクにまたがって情報を伝える。
- よりスマートな統合：ユーザーデータをツールや他のエージェントと共有し、レコードの取得やワークフローのトリガーなどのアクションを実行します。
設定方法
コンテキスト変数を使用するには、まずエージェント開発キット（ADK）を使用して定義する必要があります。 ADKは、エージェントが認識するデータの種類とアクセス方法を指定する方法を提供します。 詳しくは、 コンテキスト変数へのアクセスの提供 を参照のこと。
インストラクションでの使い方
ADKで変数を定義したら、 Agent Builder の Behavior セクションで中括弧{}を使って直接参照することができます。
以下は、コンテキスト変数を使用する命令のサンプルです：
- Always respond with watsonx Orchestrate email ID as {wxo_emailid}, wxo user name as {wxo_userid}, wxo tenant ID as {wxo_tenantid}, location as {location}, and member ID as {memberid}.
- Make a tool call when user input matches the tool description and respond to the user.
- Make a call to a collaborator agent when the user input matches its description. Pass {wxo_emailid}, {wxo_userid}, {wxo_tenantid}, {location}, and {memberid} to the collaborator agent so it returns the values back to you.
効果的な指示の書き方のすすめ
AIエージェントに指示を出す際には、エージェントが一貫して、プロフェッショナルに、貴社のビジネス目標に沿って行動できるよう、明確で効果的なガイドラインに従うことが重要です。 明確に定義された指示は、エージェントがどのようにユーザーに対応し、タスクを処理し、すべてのやり取りにおいてプロフェッショナルなトーンを維持するかを形作ります。
以下は、効果的な指示の書き方とよくある間違いを避けるための推奨事項を分類したものです。
何をすべきか
| カテゴリー | 推奨指導 |
|---|---|
| 具体的に | "未解決の問題は人間のエージェントにエスカレーションする" 「すべての対応に丁寧な口調を使う 「要求が曖昧な場合は、説明を求める |
| 行動重視 | 「ユーザーの意図が不明確な場合は、決めつけないこと 「長い回答は可能な限り要約する |
| 境界の定義 | 「法律、金融、医療に関する助言はしないこと |
これらの指示は、エージェントが軌道に乗り、プロフェッショナルなトーンを維持し、その役割を踏み越えないようにするのに役立つ。
避けるべきこと
| カテゴリー | 推奨指導 |
|---|---|
| 曖昧にしない | "常にベストを尽くす" "親切にする" "愛想よくする" （挨拶など、タスクの一部でない限り） |
| 裏付けのないロジックを使わない | "Only respond this way if users sounds confused" "Adjust tone based on user emotion" ユーザーの感情に基づいてトーンを調整する |
| 矛盾するルールを含めない | "回答は簡潔に" + "常に詳細な回答を" |
曖昧な指示や矛盾した指示は、エージェントを混乱させ、一貫性のない行動を引き起こす可能性があるため、避けること。
効果的なエージェント指示の例
独自のエージェント動作を定義する際には、以下の例を参考にしてください。 このサンプルは、エージェントが的確に対応できるように、明確で、目標志向で、ブランドに沿った指示の書き方を説明しています。
例ITサポートエージェント
以下のサンプル指示は、ユーザがシステムまたは環境の問題をトラブルシューティングし、チケットを管理し、設定ガイダンスを提供するのを支援するテクニカルサポートエージェントの動作を定義します。
- Always greet the user courteously. Include their name if available.
Example: Hello {wxo_userid}, how can I assist you with your system issue today?
- Maintain a clear, professional, and solution-oriented tone in all responses.
- When a user describes an issue, summarize their request before taking action to confirm understanding.
Example: You’re facing a login failure on the staging environment, correct?
- If the issue matches a known error pattern, retrieve and summarize the related troubleshooting article from the knowledge base.
- When a tool or workflow is available for remediation (for example, Restart Server or Create Ticket), trigger it automatically and confirm the outcome to the user.
- Include relevant details such as environment name, ticket number, and affected component using context variables.
- If the issue cannot be resolved automatically, escalate it to the DevOps team with all collected diagnostic details.
- Never make changes to production systems without explicit user confirmation.
Example: Do you want me to apply the configuration fix to the production environment?
- Close the conversation by confirming resolution or next steps.
Example: Your ticket {ticket_id} has been created. The DevOps team will review it shortly.
次のタスク
指示の追加を終えたら、以下のステップを踏んでエージェントの動作を検証し、改良してください：
- チャットページでエージェントをテストし、新しい指示がどのように適用されるかを観察してください。
- エージェントをサポートされているチャネル（例えば、SlackやMicrosoft Teams）に接続し、実際のシナリオでの応答を評価します。 詳しくは、 チャンネルへの接続を参照。
- エージェントを配置します。 詳細については、 エージェントのデプロイを参照してください。
- ビジネス目標、ユーザーの期待、またはサポートされるタスクの変更を反映するために、定期的に説明書を見直し、更新してください。