教程 - 生成自定义引擎代理 - Teams

本教程演示如何使用 Microsoft 365 Agents Toolkit (以前称为 Teams Toolkit) OpenAI 创建自定义引擎代理。

在本教程中，你将了解：

如何使用代理工具包创建新的自定义引擎代理。
如何与 LLM 和数据交互。
自定义引擎代理的目录结构。

注意

智能 Microsoft 365 Copilot 副驾驶® 对话助手的自定义引擎代理支持仅在公共开发人员预览版中提供。
Python 不支持自定义引擎代理。

先决条件

剩余 5 分钟

确保安装以下工具来生成和部署应用：

	安装	用于使用...
	代理工具包	一个Microsoft Visual Studio Code扩展，用于为应用创建项目基架。使用最新版本。
	Node.js 和 NPM	后端 JavaScript 运行时环境。有关详细信息，请参阅项目类型的Node.js 版本兼容性表。
	Microsoft Edge（推荐）或 Google Chrome	包含开发人员工具的浏览器。
	Visual Studio Code	JavaScript、TypeScript 或 SharePoint 框架 (SPFx) 生成环境。使用最新版本。
	OpenAI	首先创建 OpenAI API 密钥以使用 OpenAI 的 GPT。如果要在 Azure Microsoft托管应用或访问资源，则必须在开始之前创建 Azure OpenAI 服务。

注意

在自定义引擎代理中添加对智能 Microsoft 365 Copilot 副驾驶® 对话助手的支持

如果希望自定义引擎代理支持智能 Microsoft 365 Copilot 副驾驶® 对话助手，则必须安装预发行版本的 Microsoft 365 Agents Toolkit (以前称为 Teams 工具包) 。安装预发行版后，请执行以下步骤：

确保启用 Fx-extension：在代理工具包中启用自定义引擎代理 。
执行步骤 1。到步骤 4。从创建自定义引擎代理，并确保为步骤 5 选择“Teams 中的基本 AI 聊天机器人工作”和智能 Microsoft 365 Copilot 副驾驶®。代理工具包中的。继续执行步骤 6 (其余步骤。步骤 11.) 创建自定义引擎代理。

配置自定义引擎代理。在调试之前，请确保执行以下步骤：

确保应用清单包含 copilotAgents 及其子属性 customEngineAgents：

"copilotAgents": { 
   "customEngineAgents": [ 
      { 
         "type": "bot", 
         "id": "<Bot-Id-Guid>" 
      } 
   ] 
   }

确保 scopes 将 bots 设置为 personal 和 commandLists：

"bots": [ 
   { 
      "botId": "<Bot-Id-Guid>", 
      "scopes": [
          "personal",
          "team",
          "groupChat"
      ],
      "commandLists": [ 
         { 
         "scopes": ["personal"], 
         "commands": [ 
            { 
               "title": "Sample prompt title", 
               "description": "Description of sample prompt" 
            } 
         ] 
         }, 
         { 
         "scopes": ["personal"], 
         "commands": [ 
            { 
               "title": "Sample prompt title", 
               "description": "Description of sample prompt" 
            } 
         ] 
         } 
      ], 
   } 
   ],

创建自定义引擎代理

剩余 4 分钟

使用代理工具包创建新的自定义引擎代理

转到Visual Studio Code。
在Visual Studio Code活动栏中选择“Microsoft 365 代理工具包”图标。
选择“ 创建新应用”。
选择“ 自定义引擎代理”。
选择“ 基本 AI 聊天机器人”。
选择 JavaScript 作为编程语言。
选择“ OpenAI”。
输入 OpenAI 密钥。
选择“ 默认文件夹 ”，将项目根文件夹存储在默认位置。

还可以通过以下步骤更改默认位置：
选择“ 浏览”。
选择项目工作区的位置。
选择 “选择文件夹”。
为应用输入合适的名称 ，然后选择 Enter。

此时会显示一个对话框。根据你的要求，选择“ 是，我信任作者 ”或“ 否，我不信任作者 ”。

自定义引擎代理将在几秒钟内创建。

创建应用后，代理工具包将显示以下消息：

我遇到了问题

浏览源代码

查看此自定义引擎代理 > 基本 AI 聊天机器人模板中的内容。

文件夹名	目录
`.vscode`	用于调试的 VS Code 文件。
`appPackage`	Teams 应用程序清单的模板。
`env`	名称或值对存储在环境文件中，m365agents.yml用于自定义预配和部署规则。
`infra`	用于预配 Azure 资源的模板。
`src/`	通知 Teams 应用程序的源代码。
`src/index.js`	设置机器人应用服务器。
`src/adapter.js`	设置机器人适配器。
`src/config.js`	定义环境变量。
`src/prompts/chat/skprompt.txt`	定义提示。
`src/prompts/chat/config.json`	配置提示。
`src/app/app.js`	处理基本 AI 聊天机器人的业务逻辑。
`m365agents.yml`	主项目文件描述应用程序配置，并定义要在每个生命周期阶段运行的作集。
`m365agents.local.yml`	此替代 `m365agents.yml` 作可启用本地执行和调试。
`m365agents.playground.yml`	此替代 `m365agents.yml` 作可在 Microsoft 365 Agents Playground 中启用本地执行和调试， (以前称为 Teams 应用测试工具) 。

配置自定义引擎代理

剩余 3 分钟

创建自定义引擎代理后，让我们对其进行配置。

配置和调试自定义引擎代理

让我们自定义自定义引擎代理的提示。

转到 src/prompts/chat/skprompt.txt 并更新文件中的以下代码 skprompt.txt ：

The following is a conversation with an AI assistant, who is an expert on answering questions over the given context.
Responses should be in a short journalistic style with no more than 80 words.

屏幕截图显示 Visual Studio Code 资源管理器中的 skprompt。

在左窗格中，选择“ 运行和调试” (Ctrl+Shift+D) 。
在 Microsoft 365 代理场中选择“调试”。

注意

如果要在 Teams 或 Copilot 中调试，请选择 “在 Teams 中调试 或在 Copilot 中调试”。
选择 F5 键。
自定义引擎代理在浏览器中打开的 Agents Playground 中运行。