Agentes externos reúne las dos direcciones del protocolo A2A, con el que los agentes de su organización hablan con agentes de otras empresas o servicios. Está en Administración › Sistemas y tiene dos pestañas:
- Quién puede llamar a tus agentes: las claves con las que un cliente externo encarga trabajo a sus agentes.
- A quién pueden llamar: los agentes externos a los que sus agentes pueden encargar trabajo.
Las dos actúan siempre sobre la organización en la que está.
Quién puede llamar a tus agentes
Crear una clave
Seleccione Nueva clave, escriba un nombre que le sirva para reconocer la integración y decida el alcance. El interruptor Todos los agentes viene activado; al apagarlo aparece la lista de agentes de la organización para marcar los que quiera. Si lo apaga sin marcar ninguno, el diálogo se lo advierte y no crea nada.
La lista de agentes que se ofrece es la de la organización. Los agentes personales de cada miembro no aparecen y, por tanto, no se pueden acotar aquí.
El valor completo de la clave se muestra una sola vez, en el diálogo que sigue a la creación o a la rotación. La plataforma guarda solo un prefijo y no puede volver a enseñarlo. Cópielo a su gestor de secretos antes de cerrar ese diálogo; si lo pierde, la única salida es rotar la clave y actualizar a todos los clientes que la usaban.
Acciones
| Acción | Qué hace |
|---|---|
| Rotar | Genera un valor nuevo y lo muestra una vez. La fila pasa a exhibir otro prefijo: lo que tuvieran configurado los clientes deja de servir. |
| Revocar | Desactiva la clave. La fila queda marcada como Revocada y el botón desaparece. |
| Buscar | Filtra por nombre, prefijo o nombre de agente acotado. La lista pagina de ocho en ocho. |
Rotar no es una operación de mantenimiento inocua: en cuanto termina, toda integración que siguiera usando el valor anterior deja de autenticarse. Coordine la rotación con quien opere el cliente externo.
Estados y su significado
Cada fila muestra si la clave está Activa o Revocada, su prefijo, la fecha de creación y la del último uso, o «sin uso todavía» si nunca ha autenticado una llamada. Ese último dato es la forma práctica de averiguar qué claves sobran antes de revocarlas.
El alcance se lee en los distintivos: Todos los agentes, o un distintivo por cada agente al que la clave esté limitada.
Límites de esta pantalla
No hay borrado: una clave revocada permanece en la lista. Tampoco hay un botón de reactivación, pero Rotar sigue ofreciéndose sobre una clave revocada, así que esa vía existe de hecho aunque la pantalla no la anuncie. Si su intención es retirar una credencial para siempre, revóquela y no vuelva a rotarla.
A quién pueden llamar
Cada agente externo de esta lista aparece como una herramienta para los agentes de su organización, y solo para ellos: un agente puede encargarle trabajo y esperar su respuesta. No hace falta añadirlo a cada agente: todos lo ven en cuanto está activo. Seleccione Nuevo agente externo y rellene:
| Campo | Qué es |
|---|---|
| Nombre | En minúsculas, con números y guiones (por ejemplo, crm-ventas). Es el nombre con el que los agentes ven la herramienta. |
| Dirección del agente | La dirección A2A del agente externo. Tiene que empezar por https://. |
| Descripción | Para qué sirve y cuándo deben pedirle trabajo sus agentes, en un párrafo (hasta 600 caracteres). Es lo que leen para decidir si lo necesitan. |
| Credencial | La clave que le pida el agente externo, si pide alguna. Se guarda cifrada y no vuelve a mostrarse; al editar, déjela vacía para conservar la actual. |
Por qué importa la descripción
Sus agentes deciden solos cuándo encargar trabajo a un agente externo, y lo
deciden por lo que leen de él. El nombre rara vez basta: asistente-personal-prod
no dice qué sabe hacer. Escriba en la descripción qué resuelve y en qué casos
conviene acudir a él, por ejemplo: «Consulta pedidos y clientes del CRM de
ventas; úsalo cuando pregunten por el estado de un pedido».
Si la deja vacía, sus agentes leen lo que el agente externo publica sobre sí mismo (su descripción y sus habilidades), cuando lo publica. Si tampoco publica nada, solo lo usarán cuando alguien lo pida por su nombre.
Los cambios llegan a sus agentes en un minuto como mucho.
Cada fila se puede activar o desactivar (desactivado, los agentes dejan de verlo sin perder la configuración), editar o eliminar, que borra también su credencial.
Direcciones que no se admiten
El agente externo tiene que estar en una dirección pública de internet. La plataforma rechaza al guardar, con el motivo:
- las direcciones que no empiezan por
https://; - las que apuntan a la red interna: direcciones privadas, locales o reservadas, y nombres que solo existen dentro de la plataforma;
- los nombres que no se encuentran.
La misma regla se vuelve a aplicar en cada llamada, aunque la dirección ya estuviera guardada: si un nombre empieza a apuntar a una dirección interna, o el agente externo redirige a una, la llamada no se hace.
Quién puede hacer qué
Quien administra la organización, sobre su propia organización. Quien administra la plataforma también puede entrar, para dar soporte. Un miembro sin ese rol ve el aviso de que solo quien administra la organización gestiona sus agentes externos.
Hasta octubre de 2026 las dos pantallas estaban en el área de Administración de plataforma («API Keys (A2A)» y «Delegados A2A») y solo las usaba quien administra la plataforma. Las direcciones antiguas llevan aquí.