Agente 2 Autenticación de agente

Conecta Integration Service a un agente remoto Agent2Agent (A2A) introduciendo su URL de servicio y las credenciales para el tipo de autenticación que requiere el agente.

Cada conexión de Agent 2 Agent apunta a un agente remoto. Crea una conexión para cada agente al que quieras llamar desde Maestro.

Requisitos previos

• El agente remoto cumple los requisitos del agente remoto.
• La URL base del agente, utilizada como URL de servicio. Introduzca solo la URL base, sin una ruta o una barra final. El conector añade las rutas A2A, como /.well-known/agent-card.json, en sí mismo.
• Las credenciales para el tipo de autenticación que requiere el agente. El agente declara sus esquemas de seguridad compatibles en su Tarjeta de agente.

Tipos de autenticación

Todos los tipos de autenticación requieren la URL de servicio. Los otros campos dependen del tipo de autenticación.

Tipo de Autenticación	Campos
Autenticación básica	Nombre de usuario, Contraseña (opcional), API de validación de autenticación (opcional)
Clave API	Nombre del parámetro, Valor, Añadir a (encabezado o consulta, encabezado predeterminado), API de validación de autenticación (opcional)
Token de acceso personal	Prefijo del token ( Bearer predeterminado), Token, API de validación de autenticación (opcional)
Código de autorización OAuth 2.0	ID de cliente, Secreto de cliente, URL de autorización, URL del token, Ámbito (opcional)
Credenciales de cliente OAuth 2.0	ID de cliente, Secreto de cliente, URL del token, Ámbito (opcional)
Contraseña OAuth 2.0	ID de cliente, Secreto de cliente, URL de autorización, URL de token, Nombre de usuario, Contraseña (opcional), Ámbito (opcional)
Portador OAuth 2.0 JWT	ID de cliente, Secreto de cliente, URL de autorización, URL del token, Clave codificada en JWT base64, Ámbito (opcional)

Los siguientes campos necesitan más contexto:

• Nombre del parámetro: el nombre exacto del encabezado o parámetro de consulta que lleva la clave API, por X-API-Key.
• Prefijo del token: el prefijo añadido antes del token en el encabezado Authorization . Déjalo vacío si el agente espera el token sin prefijo.
• API de validación de autenticación: una ruta relativa que devuelve una respuesta correcta cuando las credenciales son válidas, por /api/v1/me.
• Ámbito: los ámbitos OAuth solicitados al servidor de autorización del agente, como se declara en su Tarjeta de agente. Separa varios ámbitos con espacios o comas. Déjalo vacío para utilizar los ámbitos predeterminados del servidor de autorización.
• Clave codificada en base64 de JWT: la clave privada codificada en Base64 utilizada para firmar el JWT. Sigue las instrucciones de tu proveedor de identidad para generarlo y codificarlo.

Añadir la conexión Agent 2 Agent

1. Selecciona Orchestrator en el lanzador de productos.

2. Selecciona una carpeta y luego navega a la pestaña Conexiones .

3. Selecciona Añadir conexión.

4. Para abrir la página de creación de conexión, selecciona el conector Agent 2 Agent de la lista. Puedes utilizar la barra de búsqueda para encontrar el conector.

5. En URL de servicio, introduce la URL base del agente.

6. Selecciona el Tipo de autenticación.

7. Introduce los campos necesarios para el tipo de autenticación seleccionado.

   Cuando esté disponible, selecciona el menú junto a un campo y elige Usar activo de credenciales o Usar activo de Orchestrator para hacer referencia a un activo de Orchestrator en lugar de introducir el valor directamente. Para obtener más información, consulta Usar activos de credenciales para las conexiones.

8. Select Connect.

La conexión se crea y lleva el nombre del agente, tal y como se declara en el campo name de su Tarjeta de agente.