在 Microsoft Visual Studio Code 中克隆您的 Microsoft Copilot Studio 代理程序

注释

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

使用扩展从Microsoft Copilot Studio克隆代理时，请将代理定义和相关组件定义从 Copilot Studio 下载到本地计算机。 可以使用Microsoft Visual Studio Code编辑这些文件。 克隆作创建一个本地工作区，包含所有代理文件，格式为结构化目录。

Prerequisites

在开始克隆试剂之前，有一些重要的前提和考虑因素。

选择工作区位置

为你的代理文件选择合适的本地文件夹。 这个位置是扩展名保存代理文件的地方。 以下是选择地点的一些重要建议：

  • 确保磁盘空间充足。 典型的代理体大小取决于组件数量。
  • 如果可能，使用不包含空格的路径，即使支持空格也是如此。
  • 考虑使用一个已经被Git追踪的位置。

了解哪些内容会被克隆

克隆代理时，代理文件会在所选位置本地克隆，并在Visual Studio Code资源管理器中创建如下结构定义：

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

克隆方法

如果首次使用扩展，甚至不熟悉Visual Studio Code，则克隆代理的最简单方法是在打开 Extension 窗格时选择 Clone Agent。 不过，如果你已经克隆并本地开启了代理，这个选项就不适用了。 可以采用以下方法代替：

这是克隆特工最直接且推荐的方法。

  1. 通过在活动栏中选择Copilot Studio 图标，打开 Copilot Studio 扩展。 您还可以按 Ctrl+Shift+P，并输入“Copilot Studio: Focus on Agents View”。Copilot Studio 窗格将在边栏中打开。

  2. 在 “代理” 面板中，从下拉列表（例如“环境1”）中选择你的目标环境，可以看到环境中的代理列表。

    > Environment 1
  Environment 2
  Environment 3

  3. 从列表中选择要克隆的代理。 智能体显示其上次修改日期。 右键点击代理名称，选择 克隆代理。

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    会弹出一个文件选择器对话框。

  4. 在文件选择器对话框中导航到你想要的位置，或者创建新文件夹并选择 “选择文件夹”。 克隆过程开始了。

  5. 等待克隆过程完成。 会弹出一个进度通知，显示“克隆代理：客户支持机器人”，随后是成功提示“成功克隆代理”。这个过程通常需要10到30秒。

  6. 确认克隆成功完成。 代理文件夹在Visual Studio Code资源管理器中打开，源代码管理窗格显示干净的工作树，文件窗口显示文件夹的名称。

方法三：使用命令面板克隆

如果你喜欢以键盘为核心的工作流程，可以试试这种方法。

  1. 通过点击 Ctrl+Shift+P打开命令面板。

  2. 键入“Copilot Studio：克隆代理”，然后按 Enter。 命令执行后，提示出现。

  3. 按照提示选择环境，选择代理，选择目标文件夹，等待克隆完成。 该代理被克隆到你选定的位置。

方法三：使用代理网址克隆

当有人与你共享代理网址时，这种方法非常有用。

  1. 在 Copilot Studio 网页门户中打开代理。

  2. 选择 设置>中的代理详情，复制代理的URL。 URL格式应为： https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}。 网址现在已经在你的剪贴板里了。

  3. 返回到Visual Studio Code并打开 Copilot Studio 扩展。

  4. 选择 克隆代理。 扩展程序检测到你剪贴板中的URL，并显示标记为“（来自剪贴板）”的代理。

  5. 选择标记为“（从剪贴板）”的代理，选择目标文件夹，等待克隆完成。 该代理被克隆到你选定的位置。

常见的克隆场景

以下是克隆智能体有用的几个常见场景，并附有建议工作流程的高级细节。

应用场景 1：针对独立开发克隆

目标： 自己找经纪人

  1. 把代理克隆到本地文件夹。

  2. 在导航中从源控制器初始化一个 Git 仓库。

  3. 在本地进行更改。

  4. 进行提交。

  5. 准备就绪后，将更改应用到 Copilot Studio。

情景二：克隆用于团队协作

目标： 多个开发者在同一代理上工作

  1. 第一个开发者克隆了代理人。

  2. 第一个开发人员初始化 Git 并将内容推送到共享存储库（GitHub，Azure DevOps）。

  3. 其他开发者则是从共享的Git仓库中克隆的。

  4. 每个开发人员都运行 Copilot Studio：重新附加代理将其本地文件夹连接到 Copilot Studio。

  5. 团队使用 Git 进行协作和跟踪更改，并使用Visual Studio Code扩展来处理代理。

  6. 然后，每个开发人员将更改应用于 Copilot Studio，以便根据其软件开发生命周期或自动化管道测试或推送到另一个下游环境。

情景三：克隆多个环境

目标： 管理开发、测试和生产版本

多环境部署的推荐方法是使用解决方案。 考虑一个自动化部署流程，组织流程可审计且可扩展，如管道。 对于选择不使用解决方案的用户，Copilot Studio 扩展提供了将 Copilot Studio 代理定义从本地计算机同步到另一个环境的功能。 在为客户和终端用户发布软件时，您仍应考虑将技术资产迁移到下游环境的组织流程，以提供审计、遥测及软件开发生命周期内的其他关键组件。

  1. 将开发环境中的代理克隆到本地开发文件夹。

  2. 在开发文件夹里做修改。

  3. 应用这些更改，并在同一个环境中测试。

  4. 使用 Copilot Studio：重新附加代理将代理连接到备用环境。

  5. 在 Copilot Studio 测试窗格中测试代理。

最佳做法

执行

  • 将所有特工克隆到一个一致的位置。
  • 克隆后立即初始化 Git。
  • 使用有意义的文件夹名称。
  • 在更改前先检查克隆是否能正常工作。
  • 备份克隆位置（例如，GitHub或Azure DevOps）。
  • 在团队内部的维基或文档中记录你的克隆位置。

不要

  • 不要克隆到临时目录。
  • 不要多次复制到不同位置。 这样做可能会引起混淆。

后续步骤

克隆你的代理人后：

  • 上次更新时间为