Agente (Agent)

Descripción general

La página de Agentes (menú de la barra lateral Agentes) es el punto de acceso para explorar y utilizar agentes de IA dentro del espacio de trabajo. Admite dos tipos de agentes:

Agentes del protocolo A2A: Agentes estandarizados que terceros ofrecen externamente conforme al protocolo A2A; basta con añadir una URL para poder conversar
Agentes tradicionales (tipos QuestionAnswer / Flow): agentes publicados en la plataforma GPTBots, integrados mediante iframe

Diferencia clave: A diferencia de Work, la página de Agentes es un mercado de aplicaciones: lo que invocas es un Agent que otra persona o tú mismo ya habéis creado, en lugar de iniciar una tarea desde cero.

Acceso

Web: https://www.gptbots.ai/工作区/agent
APP: menú lateral izquierdo "Agentes"

Vista de lista

Los agentes se muestran en forma de cuadrícula de tarjetas:

Elemento	Descripción
Icono + nombre	Avatar del agente y nombre para mostrar
Insignia de tipo	`Agent` (agente tradicional) o `A2A` (agente del protocolo A2A)
Descripción	Breve presentación de las capacidades del agente
Estadísticas	Número de usos, número de favoritos, etc.
Estrella de favorito	Haz clic para añadir a favoritos; una vez marcado, podrás encontrarlo rápidamente en "Mis favoritos"

Filtrado

Etiquetas de categoría superiores: Todo / Default / categorías personalizadas (como Finanzas / Administración / Producto e I+D / Legal)
Búsqueda por palabra clave: cuadro de búsqueda en la esquina superior derecha
Mis favoritos: botón en la esquina superior derecha, que muestra únicamente los agentes marcados como favoritos

Agentes A2A

Añadir un agente A2A

Añade un agente estándar del protocolo A2A mediante la Agent Card URL:

En la página de Agentes, haz clic en el botón Añadir agente A2A (solo administradores)
Introduce la Agent Card URL del agente (por ejemplo, https://agent.example.com/.well-known/agent.json)
El sistema obtiene automáticamente la información del agente (avatar, nombre, descripción, lista de capacidades)
Configura la categoría y el nombre para mostrar
Tras guardar, el agente aparece en la lista

¿Qué es la Agent Card URL? Es el endpoint HTTP que expone un agente A2A de terceros y que devuelve la información descriptiva de identidad del agente (en formato JSON). Normalmente la proporciona el desarrollador del agente.

Conversación A2A

Haz clic en la tarjeta del agente para acceder a la interfaz de conversación A2aChatView:

Función	Descripción
Respuesta en streaming SSE	Recibe las respuestas del agente en tiempo real
Respuesta estructurada	Admite cuatro tipos de bloques de contenido: text / file / data / a2ui
Gestión de sesiones	Reutiliza automáticamente una sesión existente o fuerza la creación de una nueva
Historial de mensajes	Consulta el historial de conversaciones

Tipos de respuesta estructurada:

Tipo de Part	Método de renderizado
`text`	Renderizado en Markdown (incluye fórmulas matemáticas, resaltado de código y tablas)
`file`	Archivo adjunto (imagen en línea o enlace de descarga)
`data`	Datos JSON (presentados en formato de bloque de código)
`a2ui`	Componente de interacción Agent-to-UI (renderizado por A2UIRenderer)

Para una explicación técnica detallada del protocolo, consulta el protocolo A2A.

Invocación entre cuentas

Los agentes A2A admiten el despacho por Gateway entre cuentas: cuando un usuario invoca desde la Web un agente de ámbito enterprise, la solicitud se enruta a través del Gateway hasta el nodo de destino para su ejecución. Consulta Arquitectura multinodo — Reglas de distribución de ventanas emergentes de permisos.

Agentes tradicionales

Los agentes tradicionales (tipos QuestionAnswer / Flow) se integran mediante iframe en la página de detalle del agente de Space Web.

Tipo	Descripción
QuestionAnswer	Agente de tipo preguntas y respuestas, basado en una base de conocimiento RAG
Flow	Agente de tipo flujo, basado en un flujo de trabajo previamente orquestado

Tras hacer clic en la tarjeta de un agente tradicional, accedes a AgentDetailPage, que integra la página /space/agent-details/{botId} de Space Web.

Control de permisos

Rol	Operación
Todos los miembros	Explorar la lista, buscar, filtrar, marcar como favorito y conversar con el agente
Administrador	Añadir, editar y eliminar agentes

Los permisos de administrador se verifican mediante canManageAgents() (rol Owner / Admin o que cuente con un código de permiso específico).

Guía de operaciones

Cómo añadir un agente A2A

Tras construir y publicar el Agent en el espacio de desarrollo, puedes hacer clic en publicar en el espacio de trabajo desde la página de integración.
En la página Espacio de trabajo - Gestión del espacio - Recursos empresariales - Agent, el administrador puede revisar si se pone en línea.
Una vez aprobada la revisión, dicho Agent se mostrará en la lista del espacio de trabajo; haz clic en Agentes en la barra lateral del espacio de trabajo
Localiza el Agent que acabas de poner en línea y haz clic en la tarjeta para acceder a la interfaz de conversación

Cómo conversar con un agente

Localiza la tarjeta del agente de destino en la página de Agentes
Haz clic en la tarjeta para acceder a la interfaz de conversación
Introduce un mensaje y pulsa Enter para enviarlo
Espera la respuesta del agente (streaming SSE, se muestra en tiempo real)

Sugerencia: el sistema reutiliza por defecto la sesión anterior. Si deseas iniciar una conversación completamente nueva, haz clic en el botón "Nueva sesión".

Preguntas frecuentes

Fallo en la conexión del agente

Confirma que la Agent Card URL sea accesible desde la red actual
Confirma que la URL sea HTTPS y no una dirección de red interna (el sistema cuenta con protección SSRF)
Si el agente requiere autenticación, confirma que authType y las credenciales estén configurados correctamente

La respuesta del agente está vacía o tiene un formato anómalo

Puede tratarse de un problema del lado del agente; intenta reenviar
Comprueba si el agente admite el chino (algunos agentes pueden admitir únicamente el inglés)

Documentos relacionados

Protocolo A2A — Explicación técnica detallada de Agent Card, JSON-RPC y respuestas estructuradas
Recursos empresariales — Gestión a nivel empresarial de agentes A2A
Arquitectura multinodo — Enrutamiento por Gateway entre cuentas