为丰富化任务配置外部连接器

借助第三方身份验证提供方，您可以将 Knowledge Studio 丰富化任务安全地连接到 GitHub、Microsoft SharePoint 和 Atlassian Confluence 等外部平台。完成本文档中的凭证生成和身份验证提供方配置步骤，作为前提条件设置的一部分。

准备工作

在配置外部连接器之前，请确保您已满足以下前提条件：

  • 在配置丰富化任务的前提条件中查看整体丰富化配置工作流。
  • 确保您在目标第三方平台（GitHub、Microsoft SharePoint 或 Atlassian Confluence）中拥有必要的管理员或开发者权限，以便生成访问令牌或注册应用。
  • 如需安全地存储凭证并将其附加到任务，请确保您已正确配置 Agent Identity 服务。如需了解详情，请参阅为身份验证提供方设置 IAM 权限。

将丰富代理连接到第三方知识源时，您必须使用 Google Cloud 代理身份服务。Agent Identity 充当身份验证管理器，可安全地存储您的第三方凭证，并为扩充智能体预配短期访问令牌，这样人工操作员就无需在任务执行期间直接管理原始客户端密钥。

配置 GitHub

如需将 Knowledge Studio 连接到 GitHub 代码库，您必须在 GitHub 中创建精细的个人访问令牌 (PAT)，并将其存储在 API 密钥身份验证提供方中。

  1. 登录 GitHub，点击您的个人资料照片，然后点击设置。
  2. 前往开发者设置 > 个人访问令牌 > 精细令牌。
  3. 点击生成新令牌。
  4. 配置令牌属性：
    • 令牌名称：输入描述性名称（例如 enrichment-agent）。
    • 到期时间：设置适当的到期日期。
    • 资源所有者：选择拥有目标代码库的组织或用户账号。
    • 代码库访问权限：选择仅选择代码库，然后选择要扩充的代码库。
    • 权限：为所需范围（例如问题、拉取请求和内容）授予特定的读取或读取和写入访问权限。
  5. 点击 Generate token（生成令牌），然后安全地复制令牌。
  6. 在 Google Cloud 中注册 API 密钥身份验证提供方，并提供 PAT 作为 API 密钥。请参阅使用 API 密钥和身份验证管理器进行身份验证。

如需详细了解如何创建 PAT，请参阅 GitHub 文档中的管理个人访问令牌。

配置 Microsoft SharePoint

如果您要连接到 Microsoft SharePoint，请使用 2-Legged OAuth 流程从 Microsoft Entra ID（以前称为 Azure Active Directory）获取 OAuth 凭证。

  1. 在 Microsoft Entra 管理中心内注册新应用。
  2. 授予 Microsoft Graph API 权限：
    1. 依次前往 API 权限 > 添加权限 > Microsoft Graph > 应用权限（请勿选择“委托的权限”）。
    2. 添加 Sites.Read.All 和 Files.Read.All 范围。
    3. 点击租户对应的授予管理员同意书，使两项应用权限都显示为“已授予”。

  3. 创建新的客户端密钥。请立即记录其值，因为它仅显示一次。如需了解详情，请参阅创建新的客户端密钥。

  4. 复制应用配置值。注册后，收集以下值以用于身份验证提供方配置：

    • 客户端 ID：应用概览中的应用（客户端）ID。
    • 令牌网址：在概览页面上，点击端点标签页。复制标记为 OAuth 2.0 令牌端点 (v2) 的网址。

  5. 使用这些密钥在 Google Cloud 中注册一个 2-legged OAuth 身份验证提供方。创建提供方时，请向 --allowed-scopes 参数提供默认范围：

    --allowed-scopes="https://graph.microsoft.com/.default"

    如需了解详情，请参阅 Microsoft Entra 文档中的向 Microsoft 身份平台注册应用。

配置 Atlassian Confluence

由于 Confluence 不支持服务器到服务器代理的三方模式 OAuth，因此您必须在 Atlassian 中创建专用服务账号（或虚拟用户账号），为其授予所需权限，并生成 PAT。

  1. 在 Confluence 中登录特定服务账号。
  2. 点击屏幕右上角的个人资料照片。
  3. 从菜单中选择设置（或账号设置）。
  4. 在“Security”（安全）标签页中，前往“API tokens”（API 令牌）部分。
  5. 点击 Create API token with scopes（创建具有范围的 API 令牌）按钮。请勿使用无范围令牌，因为它不会提取所有必需的工具。
  6. 提供一个描述性名称（例如 enrichment-agent），配置失效日期，然后点击下一步。
  7. 在选择应用列表中，选择 Atlassian MCP 选项，然后点击下一步。
  8. 选择以下所有 Confluence 读取和搜索范围：
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. 点击下一步，然后点击创建。
  10. 复制生成的令牌。
  11. 将 Google Cloud 身份验证提供方的凭据字符串格式设置为<ATLASSIAN_EMAIL>:<API_TOKEN>。Atlassian 要求使用 HTTP 基本身份验证编码 (email:api_token) 以编程方式使用个人 API 令牌。
  12. 在 Google Cloud 中注册 API 密钥身份验证提供方，并提供 <ATLASSIAN_EMAIL>:<API_TOKEN> 字符串作为 API 密钥。请参阅使用 API 密钥和身份验证管理器进行身份验证。

如需详细了解如何创建 PAT，请参阅 Atlassian 文档中的管理 Atlassian 账号的 API 令牌。

后续步骤