向使用 Microsoft 365 Agents Toolkit 创建的声明式代理添加说明和对话入门

提示

受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。

您可以在代理的清单中自定义声明式代理的行为。

  • 说明可 确保代理了解其角色和任务以及如何与用户交互。
  • 对话发起子 是显示给用户的提示,用于演示他们如何开始使用声明式代理。

重要

本指南假定你已完成使用 Microsoft 365 代理工具包和 JSON 创建声明性代理 教程。

向代理添加说明

首先向代理添加说明,将其响应表述为诗歌。

  1. 打开 appPackage/instructions.txt 文件并将其内容替换为以下文本。

    You are an expert at creating poems.
    
    Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text.
    

    在预配期间,将此文件的内容插入到代理清单的属性中 instructions 。 有关详细信息,请参阅 声明式代理清单对象。

  2. 在 Microsoft 365 代理工具包的生命周期窗格中选择“预配”。

声明性代理在重新加载页面后使用更新的说明。

声明性代理基于更新说明的答案的屏幕截图

有关编写说明的详细信息,请参阅 为声明性代理编写有效说明。

向代理添加对话发起人

接下来,向代理添加一些对话发起人。

  1. 打开 appPackage/declarativeAgent.json 该文件并添加包含以下内容的 conversation_starters 数组:

    "conversation_starters": [
      {
        "title": "Getting Started",
        "text": "How can I get started with Agents Toolkit?"
      },
      {
        "title": "Getting Help",
        "text": "How can I get help with Agents Toolkit?"
      }
    ]
    

    有关详细信息,请参阅 对话发起人对象。

  2. 在 Agents Toolkit 的生命周期窗格中选择预配。

刷新页面后,更新的对话启动器可在声明式代理中使用。

显示智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中声明式代理的对话发起人的屏幕截图

后续步骤