创建和管理 Model connections

连接到由超级分频器供应商（如 Amazon Bedrock、Google Vertex AI、Azure OpenAI、OpenAI 等）提供的基础模型精选列表，以将 generative AI 的功能集成到您的自动化中。

自动化管理员通过连接到基础模型来创建和测试 Model connections，并将这些连接提供给专业开发人员，专业开发人员在创建 AI Skills 时会使用这些连接。 Model connections 用于在 AI Skills 中发送提示并从模型接收响应。

此外，自动化管理员创建自定义角色，并向这些自定义角色分配 Model connections。 然后将这些自定义角色分配给能够访问 Model connections 的用户。

请按照以下步骤创建 Model connection。

先决条件

自动化管理员需要这些角色和权限来为其业务组织创建和管理 Model connections。
  • 角色： AAE_Basic，自动化管理员自定义角色
  • 许可: 有人值守机器人运行程序
  • 设置： AI 数据管理必须由自动化管理员启用，并选中允许用户禁用 AI 技能日志的复选框。
    • 允许拥有 Bot Creator 许可证的用户在使用 AI 技能时禁用数据记录。

请参阅 角色和权限 以了解自动化管理员自定义角色的权限。

重要： 要在 AI Agent Studio 中连接到外部生成式人工智能模型，您需要从相应的模型提供商处自备许可证 (BYOL)，例如 API 密钥、访问密钥或令牌。
其他要求：
  • 如果您想将身份验证详细信息存储在凭据保管库中，请准备好该信息。 请参阅 通过 Credential Vault 存储安全凭据。
  • 要测试 Model connection，您必须连接到 Bot Agent 22.60.10 及更高版本。 作为测试的一部分，您需要在桌面上运行 bot。 因此，请确保 Bot Agent 已配置为您的用户。 对于此任务，如果您需要切换连接到不同的 Control Room，请参阅：在 Control Room 实例之间切换设备注册。
  • 您需要访问 Recorder 软件包和 AI Skills 软件包才能成功测试连接。 将执行测试 Prompt 以测试 Model connection。

过程

  1. 在您的 Control Room 环境中，导航到 AI > 模型连接，然后单击创建模型连接。
  2. 在创建模型连接屏幕中，您将配置以下连接设置：
    创建 Model connections
    1. 模型连接名称： 为便于识别 Model connection 提供一个名称。
    2. 描述（可选）： 添加一个有意义的简短描述来定义连接。
    3. 选择供应商： 从支持的供应商列表中选择一个基础模型供应商，例如 Amazon Bedrock、Google Vertex AI、Azure OpenAI 或 OpenAI。
    4. 选择类型： 在您从下拉列表中选择模型后，将显示选择类型字段。 从下拉列表中选择标准。
    5. 选择模型： 从下拉列表中选择一个模型。 根据您的供应商选择在列表中显示相关的模型。
      有关每个基础模型供应商支持的完整模型列表，请参阅 常见问题解答。
    6. 单击下一步以继续到身份验证详细信息部分。
  3. 在身份验证详细信息部分中，配置参数设置。这些设置会根据您在定义 Model connection 时选择的模型而有所不同。
    注： 有关每个模型的身份验证详细信息，请参阅 验证模型连接。
  4. 设置身份验证详细信息后，确认并单击下一步，继续转到测试连接部分以测试 Model connection。
  5. 单击测试连接以确保所有连接详细信息已正确定义，并检查连接是否正常工作。
    这是一个使用 Bot Agent 的桌面操作。 使用 Bot Agent 22.60.10 及更高版本进行成功测试。
    • 如果连接按预期生效，系统将处理请求，并且您将收到系统生成的成功消息。
    • 如果连接未按预期生效，您将收到一条系统生成的消息，说明连接失败的原因。 例如，如果您尚未将支持的基础模型包下载到您的工作区，您将收到一条错误消息。 您需要下载该软件包，然后重新测试 Model connection。
    • 如果测试 Model connection 不成功，或者如果您未完成任务，Model connection 将不会被保存，您将不得不重新开始创建 Model connection 的过程。
  6. 单击下一步以进入邀请角色部分，开始为用户分配自定义角色。
    自动化管理员将创建自定义角色并将Model connections分配给该角色，然后可以将其分配给用户。 只有被分配到此自定义角色的用户才能使用此 Model connection。

    创建模型连接 - 邀请角色

  7. 通过自定义角色（使用 RBAC）为专业开发人员分配访问权限，以使用此 Model connection 创建 AI Skill。
  8. 单击创建模型连接以完成 Model connection 的创建。
    在成功创建 Model connection 之后，专业开发人员将使用它来创建 AI Skill。

    请参阅：创建 AI Skills。

  9. 您将收到一条系统生成的成功消息，说明您的 Model connection 已创建。 您将被引导到 Model connections 屏幕，其中显示模型连接的列表。
  10. 您可以通过单击每个连接旁边的省略号来查看连接、编辑连接、更改状态或删除每个连接。
    Model connection 操作
    操作 功能
    查看连接

    连接详细信息为您提供模型的摘要视图。

    常规详细信息显示连接上次被修改的时间和修改者。

    自动化管理员可以从此视图编辑 Model connection。
    更改状态
    Model connection 在创建时为可用状态。 自动化管理员可以将 Model connection 的状态更改为以下选项之一：
    • 可用：Model connection 可用于创建新的 AI Skills 并运行现有技能。
    • 有限访问：Model connection 可用于运行现有 ，但您无法将其添加到新的 中。
    • 禁用： 新的 AI Skills 不能使用这些 Model connections 创建。 使用这些 Model connections 的所有现有自动化执行都将失败。
    编辑连接 允许您编辑 Model connection 详细信息。
    编辑按钮仅对自动化管理员启用。
    注： 具有 AI STUDIO > 视图模型连接权限的用户，例如专业开发人员和普通开发人员，可以查看 Model connection 的详细信息，但不能编辑它。
    删除

    单击删除会显示一条消息，要求您确认，然后删除 Model connection。 您将收到一条确认删除的消息。

    如果您删除 Model connection，所有引用已删除 Model connection 的 AI Skills 将无法连接到基础模型，这将导致使用 AI Skill 的所有自动化执行失败。

    删除按钮仅对自动化管理员启用。
    注： 具有 模型连接 > 视图模型连接权限的用户，例如专业开发人员和普通开发人员，将能够查看 Model connection 的详细信息，但不能删除它。

后续步骤

在创建和测试 Model connection 之后，您需要将其分配给专业开发人员，他们将使用此连接创建 AI Skills。 请参阅 创建 AI Skills
注：
当您创建、测试、编辑或删除 Model connection 时，成功或失败的详细信息以及模型响应将作为日志捕获，可以在以下导航屏幕中查看：
  • 管理 > AI 治理 > AI 提示日志
  • 管理 > AI 治理 > 事件日志
  • 管理 > 审核日志
请参阅 AI Governance。

作为任务序列的下一步，请前往 创建 AI Skills，创建一个 AI Skill，并连接到 Model connection，以便最终在自动化中使用。