重要
本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。
本文为开发人员提供了有关如何生成和上传清单 YAML 文件以创建代理的一般指南。
若要试用 YAML 示例，请参阅 示例集合。
注意
此处介绍的用于上传 YAML 文件的解决方案是一种解决方法，直到代理生成器中开发“上传 YAML”功能。
生成和上传 YAML 的步骤
作为开发人员，你创建的代理定义可供安全分析师运行并查看结果。
若要生成代理清单，请引用清单中的属性，请参阅 代理清单。 可以使用提供的示例生成清单。
如果要自行生成代理，请按照以下步骤生成并上传 YAML。
步骤 1：创建工具 (技能)
创建名为 的文件
http_manifest.yaml。可以添加任何预定义工具，例如
API、KQL、GPT或AGENT。
对于
Format：GPT、API、KQL- 在 下
Skills，定义名称、说明、输入 (（如果有任何) 、设置）。
- 在 下
对于
Format：AGENT- 提供其他详细信息，例如：
- 说明 - 可以添加自然语言 (NL) 说明，以指导代理应如何执行任务。
- 子技能 (可选) - 可以定义代理可用于解决业务逻辑的技能。 定义后，代理将使用本部分中定义的技能列表来创建并执行动态计划。
- 提供其他详细信息，例如：
请参阅有关格式和设置的清单部分，请参阅 设置。
步骤 2：将 YAML 作为自定义插件上传
将自定义插件添加到 YAML 后，必须上传该文件。
注意
仅当所有者配置Security Copilot以允许所有者和参与者为组织中的每个人添加和管理自定义插件时，此选项才可用。
选择“Security Copilot源”图标。
在“管理插件”中，向下滚动到“自定义”部分。
选择 “上传插件”。
在下拉列表选项中，指定是否希望仅向自己或组织中的任何人提供插件。 然后选择添加Security Copilot插件或 OpenAI 插件。
注意
如果选择仅向自己提供插件，则会向插件添加一个专用标记。 如果选择将其提供给组织中的任何人的选项，则该插件将可供所有Security Copilot用户使用。
根据要添加的插件，请按照相应的步骤操作：
选择“Security Copilot插件”。
可以选择上传文件或作为链接上传。
若要上传文件，请执行以下操作：
- 选择“上传文件”部分。
- 选择要上传的文件，然后选择“添加”。
若要上传链接，请执行以下操作：
- 打开“作为链接上传”切换开关。
- 粘贴 YAML 或 JSON 文件的链接。
- 指定文件类型。
- 选择“添加”。
成功添加插件后，可能需要设置某些插件。 你也可以选择稍后设置插件。
为设置字段提供适当的值，然后选择“设置”。
- 完成设置步骤后，插件将显示在“自定义”部分中。
- 选择屏幕底部的 “显示 #更多 ”选项。
- 向下滚动以查找插件。
- 必须打开开关。
- 可以关闭“ 管理源 ”对话框。
注意
需要完成插件的安装步骤才能使用并显示在 “自定义 ”部分中。 仅当清单 YAML 具有代理定义 () AgentDefinitions 定义时，上传的 YAML 或清单才会作为代理发布到 Active 代理。
步骤 3：检查权限
Security Copilot角色控制你有权访问平台上的活动，例如配置设置、分配权限和执行任务。 Security Copilot角色在 Copilot 中定义和管理，并且仅授予对Security Copilot功能的访问权限。 有关权限的详细信息，请参阅 权限。
步骤 4：发现和设置/配置代理
若要在 Security Copilot 中发现代理，必须按清单中的 DisplayName 字段中指定的值进行搜索。
如果尚未安装，管理员或 Copilot 所有者可以选择为工作区设置、配置和启用代理。
步骤 5：测试插件 (代理)
测试代理的最简单方法是通过 系统功能 调用它，如下所示：
如果已登录到产品，请选择导航菜单>“主页”左上角的“智能 Microsoft Security Copilot 副驾驶®”链接。
在“如何Security Copilot帮助？”提示栏中选择提示。
导航到 “查看所有系统功能”。
使用搜索栏查找并选择插件。 这会使用代理的名称和输入参数填充搜索栏。
选择 “提交提示”。 这将运行代理 (可能需要大约 30 - 45 秒) 。
响应应显示结果。
可以通过单击屏幕右上角的“ 代理视图 ”按钮来验证代理执行了其函数调用循环。 这将显示用于完成任务的代理 的决策树 。