27 AI 注册表

AI 注册表是 Oracle AI Data Platform 的代理和 MCP 服务器的中心目录。它支持开放标准,包括 MCP 和 A2A。

AI 数据平台是构建和部署代理的位置。Oracle Agent Hub 是业务用户与其交谈的地方。AI 注册表是它们之间的层。AI 注册表使代理或工具在内置环境之外可发现和可用。代理和工具必须先在 AI 注册表中注册,然后才能在代理中心共享。请参阅 Using Oracle Agent Hub 中的 How Enterprise AI Works in Agent Hub 。

您可以在 AI Data Platform AI Registry 中注册以下代理和工具:

类型 说明
AI Data Platform 代理 在您有权访问的工作区中,在 AI 数据平台中构建和部署的代理。在 AI Data Platform AI Registry 中也称为本地代理。
外部座席 托管在 AI 数据平台外部的代理,由其 A2A 代理卡 URL 添加。
MCP 服务器 公开一组代理可以调用的工具的模型上下文协议 (MCP) 服务器。

在 AI 注册表中,您可以管理使用这两者所需的 AI 代理、MCP 服务器和凭证。在“AI 注册表”页上,可以使用代理、 MCP 服务器和身份证明选项卡查看每个选项卡的列表。您可以使用搜索栏按名称或说明筛选可见选项。在“代理”选项卡上,您可以使用排序依据下拉菜单按最近将代理添加到注册表中的方式进行排序。

单击代理卡将显示该代理的详细信息,其中提供了创建者、源、版本、代理卡的 URL 和协议版本。您可以使用卡右上角的选项在详细信息视图和卡的 JSON 视图之间切换。

在注册新的外部代理或 MCP 服务器之前,需要先在身份证明选项卡中注册其验证身份证明。然后,您可以通过单击右上角的注册并选择相应的选项来注册新的代理和 MCP 服务器。从 Permissions 选项卡管理 AI 注册表的权限。

关于代理卡

代理卡是描述代理的元数据结构。AI 注册表在注册期间读取它们,并在提交之前将其显示给您以供查看。

有关更多信息,请参见 A2A Protocol Specification 。

代理卡包含以下信息:
  • 名称、版本和说明。
  • 代理卡 URL,即卡本身的发布位置。
  • 协议版本。
  • 输入和输出模式。例如,文本、文本/纯文本或 text/html。
  • 功能,例如流处理。
  • 技能,每个技能都有自己的名称和描述。
该卡与业务流程匹配。当用户在代理中心中提问而未选择代理时,此卡上的名称、说明、技能和功能将决定您的代理是否已显示。模糊描述是从未选择代理的最常见原因。

在 AI 注册表中创建身份证明

您可以保存验证 AI 注册表对象(例如代理和 MCP 服务器)时所需的身份证明。

  1. 在主页中,单击 AI 注册表图标 AI 注册表。
  2. 单击身份证明选项卡,然后单击创建身份证明。
  3. 输入身份证明的名称和描述。
  4. 从下拉菜单中选择凭证类型。
  5. 从下拉菜单中选择“Grant(授权)”类型。
  6. 输入身份证明的授权 URL 、访问令牌 URL 、客户端 ID 、客户端密钥和刷新 URL 。
  7. 输入范围名称和值。至少需要一个范围名称和值。通过单击添加范围添加其他范围名称和值。
  8. 复制重定向 URL。您需要将重定向 URL 粘贴到身份域中的机密应用程序。以下示例演示如何将重定向 URL 复制到 Oracle Cloud Infrastructure :
    1. 登录到 OCI 控制台。
    2. 依次单击身份和安全、域和集成的应用程序。
    3. 选择要更新其重定向 URL 的应用程序。
    4. 单击 OAuth 配置选项卡,然后单击编辑 OAuth 配置。
    5. 应用所需的任何重定向 URL,然后单击提交。
  9. 单击创建。

在 AI 注册表中注册本地代理

您可以从您有权访问的 Oracle AI Data Platform 工作区注册本地 AI 代理。

必须先在 AI 数据平台中部署代理,然后才能在 AI 注册表中注册代理。请参阅代理部署。
  1. 在主页中,单击 AI 注册表图标 AI 注册表。
  2. 单击注册,然后单击代理。
  3. 单击本地代理。
  4. 从工作区下拉菜单中,选择本地代理所在的工作区。
  5. 从代理下拉菜单中,选择要注册的代理。
  6. 可选:将鼠标悬停在卡图标上以预览代理卡。
  7. 单击下一步。
  8. 确认代理详细信息正确,然后单击注册。

在 AI 注册表中注册外部代理

您可以将外部 AI 代理从支持的源注册到 AI 注册表。这些代理必须符合 A2A 协议。

如果外部代理需要验证,请首先在 AI 注册表的 Credentials(凭证)选项卡中创建这些凭证。
  1. 在主页中,单击 AI 注册表图标 AI 注册表。
  2. 单击注册,然后单击代理。
  3. 单击外部代理。
  4. 输入代理卡 URL。
  5. 可选:如果端点需要安全凭证,请选择需要验证,然后从凭证下拉菜单中选择凭证。
  6. 单击下一步。
  7. 可选:如果选择了 "Require authentication"(要求验证),请在显示的对话框中为有权访问代理的帐户输入凭证。
  8. 查看代理详细信息以了解准确性,然后单击注册。

在 AI 注册表中注册 MCP 服务器

MCP 服务器公开了一组代理可以通过标准接口发现和调用的工具。在 AI 注册表中注册一个使这些工具可以在平台上使用。

注意:

如果您的 MCP 服务器需要验证,则必须首先在 AI 注册表中创建 OAuth 凭证。无法在注册 MCP 服务器时添加身份证明。
  1. 在主页中,单击 AI 注册表图标 AI 注册表。
  2. 单击注册,然后单击 MCP 服务器。
  3. 输入 MCP 服务器端点的 URL。
  4. 输入有用的显示名称和说明。用户和代理将使用这些信息来标识 MCP 服务器的用途。
  5. 从下拉菜单中,选择传输方法。
  6. 可选:如果 MCP 服务器需要安全凭证,请选择需要验证。从 Credentials(身份证明)下拉菜单中选择身份证明。
  7. 单击继续。
  8. 查看所选 MCP 服务器的包含工具列表。选择要单独包括的工具,或单击全选以包括列出的所有工具。
  9. 单击注册。