--- title: Agentes externos description: "Decida qué clientes externos pueden encargar trabajo a los agentes de su organización por el protocolo A2A, y a qué agentes externos pueden encargárselo ellos. Claves de acceso, agentes a los que llamar y qué direcciones no se admiten." allan.topic: how-to allan.service: platform-ui allan.date: 10/17/2026 allan.ruta: /admin/external-agents allan.secciones: "vista=entrada": "Quién puede llamar a tus agentes" "vista=salida": "A quién pueden llamar" allan.fuente: [app/admin/external-agents/page.tsx, app/admin/external-agents/inbound-keys.tsx, app/admin/external-agents/delegates.tsx, platforma_ui_backend/api/routers/api_keys.py, platforma_ui_backend/api/routers/a2a_delegates.py, platforma_ui_backend/services/delegate_egress.py] allan.audiencia: [admin] allan.aplica_a: administradores de la organización allan.terminos: [agente, organizacion] --- 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í. > [!ADVERTENCIA] > 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. | > [!PRECAUCIÓN] > 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í. ## Pasos siguientes - [Herramientas de los agentes](herramientas-de-los-agentes.md)