添加说明
人工智能代理的运行基于一系列行为指令，这些指令规定了代理如何响应用户输入、执行任务和跨不同渠道进行交互。 这些指令是代理的内部指南，帮助它在各种情况下采取一致有效的行动。
通过配置这些指令，您可以确保代理符合贵组织的基调、业务目标和用户期望。 无论是回答问题、触发工具还是与其他代理合作，这些规则都有助于保持无缝的专业体验。
Agent Builder 的 "行为 "部分添加了说明。 一旦添加，它们就会在所有渠道和任务中全面应用，这意味着无论在哪里或以何种方式调用，代理都会遵循它们。
如果您的指令开始包含大量条件、分支或序列，请考虑使用代理流程。 工作流程可帮助您将复杂的逻辑编码为结构化、可重复的格式，从而更易于管理和扩展。 有关详细信息，请参阅 “创建流程 ”。
什么是说明
指令是塑造代理行为的可配置规则。 它们决定了代理如何响应、何时触发工具以及如何与其他代理协作。 说明添加到 Agent Builder 的行为部分，并全面适用于所有渠道和任务。
何时使用说明
想使用说明时就使用说明：
让代理商的语气与您的品牌保持一致。
控制代理如何处理特定场景。
确保不同渠道和任务的行为一致。
实现与工具或其他代理的协作。
准备工作
在向代理添加指令之前，了解它们的工作原理和影响非常重要：
指令可覆盖现有指令：输入新指令后，这些指令将取代之前定义的任何规则。 不支持版本控制或回滚，因此保存前请仔细检查更改。
更改会自动保存：当您输入或修改指令时，它们会立即应用。
如果缺少说明，则采用默认值：如果将说明字段留空，代理将依赖其内置逻辑。 虽然它可以适用于一般用例，但可能不符合您的具体业务需求。
指令全局应用：您添加的任何指令都会应用于所有渠道（如聊天、Slack）和代理执行的所有任务。 目前，无法根据用户上下文、通道或任务类型设置条件指令。
添加说明的步骤
定义或更新代理行为：
从主菜单转到 " 构建"。
单击创建代理 > 从头开始创建。
输入名称和描述。
转到 " 行为 "部分。
在 " 说明 "字段中，输入清晰、可操作的规则。
请先阅读关于撰写有效说明的建议。 这对帮助确保您的代理按照预期行事至关重要。
自动保存更改。
添加指令后，特工会在所有对话中立即使用这些指令。 这些规则会影响代理如何在所有任务和连接渠道中响应用户请求。
利用上下文变量定制代理响应
人工智能代理可以根据与之互动的用户和已有的信息来定制响应。 情境变量可实现动态的个性化回复，反映当前情况和用户特征。
上下文变量就像用户特定数据的占位符，例如电子邮件 ID、位置或会员 ID，您可以将这些数据传递到代理的行为中。 有了它们，您的代理将变得更加智能、反应更快、更有针对性。
使用上下文变量的好处
个性化回复：以姓名问候用户，提及用户所在位置，或根据用户的角色或偏好量身定制回答。
会话连续性：在多个步骤或任务中传递信息，而不要求用户重复。
更智能的集成：与工具或其他代理共享用户数据，以执行获取记录或触发工作流等操作。
如何设置
要使用上下文变量，必须先使用代理开发工具包（ADK）定义它们。 ADK 提供了一种方法来指定代理可识别的数据类型以及如何访问这些数据。 有关详细信息，请参阅“提供对上下文变量的访问权限”。
如何在说明中使用它们
在 ADK 中定义变量后，您就可以在 Agent Builder 的行为部分使用大括号 {} 直接引用它们。
以下是使用上下文变量的示例指令：
- 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.
关于编写有效说明的建议
当您为人工智能代理编写指令时，必须遵循清晰有效的指导原则，确保代理的行为始终如一、专业并符合您的业务目标。 定义明确的指令决定了代理如何回应用户、处理任务，以及在所有互动中保持专业的语气。
以下是关于撰写有效说明和避免常见错误的分类建议。
该怎么办
类别 |
建议的指导 |
|---|---|
要具体 |
"将未解决的问题上报给人工代理" “所有回复均应保持礼貌的语气。” “如果请求表述模糊，请要求对方予以澄清。” |
关注行为 |
"如果用户的意图不明确，就不要妄加猜测" “尽可能对长篇回复进行总结。” |
确定边界 |
"不提供法律、财务或医疗建议" |
这些指示有助于代理人保持正确的方向，保持专业的语气，避免越俎代庖。
应避免的事项
类别 |
建议的指导 |
|---|---|
不要含糊其辞 |
“永远尽自己最大的努力”“乐于助人”“友善待人”（除非是任务要求，例如问候） |
不要使用毫无根据的逻辑 |
“只有当用户显得困惑时才这样回应” “根据用户的情绪调整语气” |
不要包含相互冲突的规则 |
"回答简短 "+"始终提供详细答案" |
避免含糊不清或自相矛盾的指令，因为它们会让代理感到困惑，并导致不一致的行为。
有效代理说明示例
在定义自己的代理行为时，请参考下面的示例。 示例说明了如何编写清晰、目标明确、与品牌一致的说明，以帮助您的代理做出准确回应。
举例说明：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.
下一步操作
完成添加指令后，请采取以下步骤验证和完善代理行为：