Configura conectores externos para tareas de enriquecimiento

Los proveedores de autenticación de terceros te permiten conectar de forma segura las tareas de enriquecimiento de Knowledge Studio con plataformas externas, como GitHub, Microsoft SharePoint y Atlassian Confluence. Completa los pasos de generación de credenciales y configuración del proveedor de autenticación que se indican en este documento como parte de la configuración de requisitos previos.

Antes de comenzar

Antes de configurar los conectores externos, asegúrate de haber completado los siguientes requisitos previos:

Cuando conectes el agente de enriquecimiento a fuentes de conocimiento de terceros, debes usar el servicio de identidad del agente de Google Cloud . Agent Identity actúa como un administrador de autenticación que almacena de forma segura tus credenciales de terceros y aprovisiona tokens de acceso de corta duración al agente de enriquecimiento para que los operadores humanos nunca tengan que administrar directamente los secretos de cliente sin procesar durante la ejecución de la tarea.

Configurar GitHub

Para conectar Knowledge Studio a los repositorios de GitHub, debes crear un token de acceso personal (PAT) detallado en GitHub y almacenarlo en un proveedor de autenticación de clave de API.

  1. Accede a GitHub, haz clic en tu foto de perfil y, luego, en Settings.
  2. Ve a Developer settings > Personal access tokens > Fine-grained tokens.
  3. Haz clic en Generate new token.
  4. Configura las propiedades del token:
    • Nombre del token: Ingresa un nombre descriptivo (por ejemplo, enrichment-agent).
    • Vencimiento: Establece una fecha de vencimiento adecuada.
    • Propietario del recurso: Selecciona la organización o la cuenta de usuario propietaria de los repositorios de destino.
    • Acceso al repositorio: Elige Solo repositorios seleccionados y selecciona los repositorios que deseas enriquecer.
    • Permisos: Otorga acceso específico de Lectura o Lectura y escritura para los permisos requeridos (como Problemas, Solicitudes de extracción y Contenido).
  5. Haz clic en Generar token y copia el token de forma segura.
  6. Registra un proveedor de autenticación de clave de API en Google Cloud y proporciona el PAT como la clave de API. Consulta Autentica con una clave de API con el administrador de autenticación.

Para obtener más información sobre cómo crear un PAT, consulta Administra tus tokens de acceso personal en la documentación de GitHub.

Configura Microsoft SharePoint

Si te conectas a Microsoft SharePoint, obtén credenciales de OAuth de Microsoft Entra ID (antes Azure Active Directory) con un flujo de OAuth de 2 segmentos.

  1. Registra una aplicación nueva en el centro de administración de Microsoft Entra.
  2. Otorga permisos de la API de Microsoft Graph:
    1. Ve a Permisos de API > Agregar un permiso > Microsoft Graph > Permisos de la aplicación (no selecciones Permisos delegados).
    2. Agrega los permisos Sites.Read.All y Files.Read.All.
    3. Haz clic en Grant admin consent para tu usuario, de modo que ambos permisos de la aplicación se muestren como "Granted".

  3. Crea un nuevo secreto del cliente. Registra su valor de inmediato, ya que solo se muestra una vez. Para obtener más información, consulta Crea un secreto de cliente nuevo.

  4. Copia los valores de configuración de tu aplicación. Después del registro, recopila los siguientes valores para la configuración de tu proveedor de autenticación:

    • ID de cliente: Es el ID de aplicación (cliente) de la descripción general de tu app.
    • URL del token: En la página Descripción general, haz clic en la pestaña Extremos. Copia la URL etiquetada como Extremo de token de OAuth 2.0 (v2).

  5. Registra un proveedor de autenticación de OAuth de 2 niveles en Google Cloud con estos secretos. Cuando crees el proveedor, proporciona el permiso predeterminado al parámetro --allowed-scopes:

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

    Para obtener más información, consulta Registra una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft Entra.

Configura Atlassian Confluence

Debido a que Confluence no admite OAuth de 2 segmentos para agentes de servidor a servidor, debes crear una cuenta de servicio dedicada (o una cuenta de usuario ficticia) en Atlassian, otorgarle los permisos necesarios y generar un PAT.

  1. Accede a la cuenta de servicio específica en Confluence.
  2. Haz clic en tu foto de perfil en la esquina superior derecha de la pantalla.
  3. Selecciona Configuración (o Configuración de la cuenta) en el menú.
  4. En la pestaña Seguridad, navega a la sección de tokens de API.
  5. Haz clic en el botón Create API token with scopes. No uses un token sin alcance, ya que no recuperará todas las herramientas necesarias.
  6. Proporciona un nombre descriptivo (por ejemplo, enrichment-agent), configura la fecha de vencimiento y haz clic en Siguiente.
  7. En la lista Selecciona la app, elige la opción Atlassian MCP y haz clic en Siguiente.
  8. Selecciona todos los siguientes permisos de lectura y búsqueda de 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. Haz clic en Siguiente y, luego, en Crear.
  10. Copia el token generado.
  11. Asigna el formato <ATLASSIAN_EMAIL>:<API_TOKEN> a la cadena de credenciales del proveedor de autenticación de Google Cloud . Atlassian requiere la codificación de autenticación básica de HTTP (email:api_token) para usar los tokens de API personales de manera programática.
  12. Registra un proveedor de autenticación de clave de API en Google Cloud y proporciona la cadena <ATLASSIAN_EMAIL>:<API_TOKEN> como la clave de API. Consulta Autentica con una clave de API con el administrador de autenticación.

Para obtener más información sobre cómo crear un PAT, consulta Administra tokens de API para tu cuenta de Atlassian en la documentación de Atlassian.

¿Qué sigue?