从头开始创建自定义连接器
备注
本文是有关在 Azure 逻辑应用中创建和使用自定义连接器以及 Microsoft Power Automate Microsoft Power Apps 使用支持 AI 的连接器的教程系列的一部分 Microsoft Copilot Studio。 请务必阅读 自定义连接器概述 以了解该过程。 转到在中使用 Power Platform Copilot Studio 连接器，了解如何在代理中 Microsoft Copilot 将连接器作为连接器作调用。
若要创建自定义连接器，必须描述要连接到的 API，使连接器可识别此 API 的操作和数据结构。 在本文中，您将从头开始创建自定义连接器，而无需使用 OpenAPI 定义 来描述 Azure 认知服务文本分析 API 情绪作（本系列的示例）。 而是完全在自定义连接器向导中说明连接器。
有关描述 API 的另一种方法，请转到 从 OpenAPI 定义创建自定义连接器。
备注
您当前可以在 Power Automate 和 Power Apps 中从头创建自定义连接器。 对于逻辑应用，您必须至少从基本的 OpenAPI 定义开始。
先决条件
启动自定义连接器向导
登录到 Power Apps 或 Power Automate。
在左侧窗格中，选择 Data>Custom connectors。
选择 New custom connector>Create from blank.
输入自定义连接器的名称，然后选择 Continue（继续）。
参数 价值 自定义连接器标题 SentimentDemo
步骤 1：更新一般详细信息
从这一点开始， Power Automate 我们展示了 UI，但不同技术的步骤大致相同。 我们会指出任何差异。
在常规选项卡上，执行以下操作：
在 Description 字段中，输入一个有意义的值。 此描述显示在自定义连接器的详细信息中，它可以帮助其他人确定连接器是否对他们有用。
将 Host 字段更新为文本分析 API 的地址。 连接器使用 API 主机和基 URL 来确定如何调用 API。
参数 价值 说明 使用 Cognitive Services 文本分析情绪 API 来确定文本是积极的还是消极的 Host westus.api.cognitive.microsoft.com
步骤 2：指定身份验证类型
有多个选项可用于自定义连接器中的身份验证。 认知服务 API 使用 API 密钥身份验证，这就是您为本教程指定的内容。
在 Security（安全） 选项卡上的 Authentication type（身份验证类型 ）下 ，选择API Key（API 密钥 ）。
在 API 密钥下，指定参数标签、名称和位置。 指定一个有意义的标签，因为当某人首次与自定义连接器建立连接时，将显示该标签。 参数名称和位置必须与 API 预期的匹配。 选择连接。
参数 价值 参数标签 API 密钥 参数名称 Ocp-Apim-Subscription-Key 参数位置 标头 在向导顶部，确保将名称设置为 SentimentDemo，然后选择 Create connector 。
步骤 3：创建连接器定义
自定义连接器向导为您提供了很多选项，用于定义连接器的功能以及它在逻辑应用、流和应用中的公开方式。 我们将在本节中介绍 UI 并介绍一些选项，但我们也鼓励您自行探索。
创建操作
首先要创建一个调用文本分析 API 情绪操作的操作。
在定义 选项卡上 ，左窗格显示为连接器定义的所有作、触发器（适用于逻辑应用和 Power Automate）和引用。 选择新建操作。
此连接器中没有触发器。 若要了解自定义连接器的触发器，请转到 将 Webhook 与 Azure 逻辑应用配合使用。 Power Automate
General （常规 ）区域显示有关当前所选作或触发器的信息。 为此操作添加摘要、说明和操作 ID。
参数 价值 总结 返回表示检测到的情绪的数字评分 说明 API 返回介于 0 和 1 之间的数字评分。 接近 1 的评分表示积极情绪，而接近 0 的评分表示消极情绪。 操作 ID DetectSentiment 将 Visibility（可见性 ） 属性设置为 none。 逻辑应用或流中的操作和参数的这个属性包含以下选项：
- none：在逻辑应用或 Flow 中正常显示
- 高级：隐藏在另一个菜单下
- internal：对用户隐藏
- 重要提示：始终首先向用户显示
Request（请求 ） 区域根据作的 HTTP 请求显示信息。 选择从示例导入。
指定连接到 API 所需的信息，指定请求正文（在下图后提供），然后选择 Import。 我们为您提供此信息，但对于公共 API，您通常从文本分析 API（v2.0） 等文档获取此信息。
参数 价值 谓词 POST URL <https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment>Body 使用以下 JSON 代码 示例:
{ "documents": [ { "language": "string", "id": "string", "text": "string" } ] }Response （响应 ）区域根据作的 HTTP 响应显示信息。 选择 Add default response（添加默认响应）。
指定响应正文，然后选择 Import（导入）。 正如我们对请求正文所做的那样，我们会在图像之后为您提供此信息，但通常在 API 文档中提供。
示例:
{ "documents": [ { "score": 0.0, "id": "string" } ], "errors": [ { "id": "string", "message": "string" } ] }验证区域显示了在 API 定义中检测到的任何问题。 检查状态，然后在向导的右上角，选择 Update connector。
更新定义
现在让我们更改几项设置，使连接器变得更友好，方便用户在逻辑应用、流或应用中使用它。
在 Request（请求 ） 区域中，选择 body（正文），然后选择 Edit（ 编辑）。
在 Parameter（参数 ）区域中，您现在可以看到 API 期望的三个参数：
id、language和text。 选择 id，然后选择 Edit（ 编辑）。在 Schema Property（架构属性 ） 区域中，更新参数的值，然后选择 Back（ 返回）。
参数 价值 称谓 ID 说明 提交的每个文档的标识符 Default value 1 必需 是 在 Parameter（参数 ）区域中，选择 language Edit（语言>编辑），然后使用以下值重复您在此过程的步骤 2 和 3 中使用的
id过程。参数 价值 称谓 语言 说明 文本的两个或四个字符的语言代码 Default value en 必需 是 在 Parameter（参数 ）区域中，选择 文本>Edit（编辑），然后使用以下值重复您在此过程的步骤 2 和 3 中使用的
id过程。参数 值 标题 文本 说明 用于分析情绪的文本 默认值 无 必需 是 在 Parameter 区域中，选择 Back 以返回到主 Definition 选项卡。
在向导的右上角，选择 Update connector。
步骤 4：（可选）启用连接器作为 AI 插件
仅当您计划 认证连接器 时，才使用连接器的 AI 插件（预览）选项卡。 若要将连接器用作 AI 插件，连接器必须经过认证。
在将连接器启用为 AI 插件之前，请确保您了解 AI 插件场景的使用案例，并查看其他注意事项，例如可支持性、最佳实践和建议。 详细信息： 创建连接器 AI 插件（预览）
在左侧导航窗格中，选择 Custom connectors。
如果您没有看到 自定义连接器，请选择 更多>发现所有>自定义连接器。 该选项将显示在左侧导航窗格上。
在右上角，从 New custom connector 菜单中选择一个选项。
选择 AI Plugin（preview） 选项卡。
在 Plugin manifest（插件清单 ）部分中，输入详细信息以将此连接器启用为 AI 插件。
字段 Description 插件清单：名称 AI 插件的名称。 插件清单：说明 AI 插件的说明。 详细信息： 创建连接器 AI 插件（预览） 插件清单：联系人电子邮件 此 AI 插件的联系人的电子邮件地址。 插件清单：法律信息 URL 一个可公开访问的位置，其中发布与您的 AI 插件相关的法律信息。 向下滚动到“插件作详细信息 ” 部分，然后输入连接器 AI 插件中每个作的作详细信息。
字段 Description 插件操作详细信息：摘要 有关用户可以执行的每个 AI 插件操作的摘要。 插件操作详细信息：说明 用户可以针对此特定 AI 插件操作步骤执行的每个操作的说明。 复选框：启用作为 Copilot 插件操作 当复选框中出现复选标记时，表示 AI 插件操作已启用。 复选框：需要用户确认吗？ 当复选框中出现复选标记时，需要用户确认。 小费
如果您需要帮助定义作，请打开 Swagger 编辑器 切换。
向下滚动到 Parameter（参数 ）部分，然后输入连接器 AI 插件的参数详细信息。
字段 Description 参数：名称 参数的名称。 使用可识别的名称，例如 Account Identifier 而不是 ID。 参数：说明 参数的说明。 使用 MM/DD/YYYY 格式 的联系人的描述性说明 ，例如出生日期，而不是 b_date。 此类名称和说明有助于 LLM（大型语言模型）与 AI 插件有效交互。 参数：摘要 有关参数的摘要信息。 参数：默认值 参数的默认值。 在 AI 插件（preview） 部分下方的 Request 部分中，选择输入参数，然后输入描述。
步骤 5：（可选）使用自定义代码支持
自定义代码转换超出现有策略模板范围的请求和响应有效负载。 转换包括发送外部请求以提取其他数据。 使用代码时，它优先于无代码定义。 这意味着代码将执行，我们不会将请求发送到后端。
备注
- 此步骤是可选的。 您可以通过忽略此步骤并转到 步骤 6：测试连接器来完成创建连接器的无代码体验。
- 自定义代码支持在公开预览中提供。
您可以粘贴代码或上载包含代码的文件。 您的代码必须：
- 用 C# 编写。
- 最长执行时间为五秒。
- 文件大小不超过 1 MB。
有关编写代码的说明和示例，请转到 在自定义连接器中编写代码。
有关自定义代码的常见问题，请转到 自定义代码常见问题解答。
在 Code（代码 ） 选项卡上，使用以下选项之一插入自定义代码：
- 复制/粘贴
- 选择上载按钮。
如果您选择上传自定义代码，则只有扩展名为 .cs 或 .csx 的文件可用。
重要提示
目前，我们仅支持在代码编辑器中突出显示语法。 请务必在本地测试您的代码。
粘贴或上传代码后，选择 Code Disabled（已禁用 代码）旁边的 切换开关以启用您的代码。 切换开关名称将更改为 Code Enabled。
您可以随时启用或禁用您的代码。 如果切换开关为 Code Disabled，则您的代码将被删除。
通过在下拉菜单中选择一个选项，选择要应用于自定义代码的操作和触发器。 如果未选择任何作，则作和触发器将应用于 所有 作。
步骤 6：测试连接器
既然已创建了连接器，请对其进行测试，以确保它正常工作。 测试当前仅在 Power Automate 和 Power Apps 中可用。
重要提示
在使用 API 密钥时，不建议您在创建连接器后立即对其进行测试。 连接器准备好连接到 API 可能需要几分钟。
在 Test（测试） 选项卡上，选择 New connection（ 新建连接 ）。
输入文本分析 API 中的 API 密钥，然后选择 Create connection（ 创建连接）。
备注
对于需要 Bearer 认证的 API，请在 API Key 前添加 Bearer 和 1 个空格。
返回到 Test（测试 ） 选项卡，然后执行以下作之一：
（在 Power Automate）您将返回到 Test（测试 ） 选项卡。选择刷新图标以确保连接信息已更新。
（在 Power Apps 中）您将会转到当前环境中的可用连接列表。 在左侧窗格中，选择 Data>Custom connectors。 选择您创建的连接器，然后返回到 Test（测试） 选项卡。
在 Test（测试） 选项卡上，输入文本 字段的值 （其他字段使用您之前设置的默认值），然后选择 Test operation（ 测试作 ）。
连接器调用 API，您可以查看响应，其中包括情绪分数。
（对于 CLI 用户）最佳实践
下载所有连接器，并使用 Git 或任何源代码管理系统保存文件。
如果有不正确的更新，请使用源代码管理中的正确文件集重新运行更新命令，以重新部署连接器。
在生产环境中部署之前，请在测试环境中测试自定义连接器和设置文件。
请务必仔细检查环境和连接器 ID 是否正确。
后续步骤
现在，您已创建自定义连接器并定义了其行为，您可以从以下位置使用该连接器：
还可以在组织中共享连接器或认证连接器，使组织外部的人员也可以使用它。
提供反馈
我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 若要提供反馈，请转到 提交问题或获取有关连接器 的帮助，然后选择您的反馈类型。