Interfaz de agente (agente a agente)
Expón tu agente empresarial a otros agentes. El asistente de IA de un cliente puede descubrirlo, consultarlo y enviar una solicitud estructurada y precompletada sobre MCP y A2A — mientras que una persona confirma cualquier acción irreversible.
La Interfaz de agente hace que tu agente sea accesible no solo para las personas en un chat, sino para los asistentes de IA de tus clientes, máquina a máquina. Un asistente puede hacer preguntas fundamentadas y enviar una solicitud estructurada y precompletada; tu lado hace el preprocesamiento y devuelve un resumen para que una persona lo confirme. Se construye sobre estándares abiertos de agentes — MCP (herramientas) y A2A (tarjetas de agente) — así que no hay ningún protocolo a medida que implementar.
La forma de una interacción
Descubrimiento y conexión
Hay dos niveles, y la diferencia es lo que el asistente puede hacer.
Nivel de lectura — autodescubrimiento, sin configuración
Un asistente encuentra la tarjeta de tu agente en una dirección estándar y puede empezar de inmediato:
https://<tu-dominio>/.well-known/agent.json— la tarjeta de agente A2A (dominio de marca blanca, o tu URL de agent4.io).- En la página: una etiqueta
<link rel="agent" href="…">ywindow.agent4, de modo que un asistente basado en navegador que ya está en tu sitio la encuentra sin un salto adicional.
El nivel de lectura es público y seguro: solo respuestas fundamentadas, el contrato de recepción y consultas de estado. Sin datos personales y sin enviar solicitudes.
Nivel de escritura — un emparejamiento de un solo uso
Para enviar una solicitud en nombre de alguien, el asistente debe estar emparejado con esa persona una vez:
- El cliente pulsa "Usar con tu asistente de IA" en tu chat o widget.
- Recibe un código de un solo uso (más un enlace copiable, un código QR y un enlace profundo) — no un bloque de texto para pegar.
- Su asistente intercambia el código por un token acotado (un intercambio estilo OAuth de dispositivo / código de autorización) y lee la tarjeta de agente por sí mismo.
El token resultante está vinculado a esa persona autenticada, acotado (esta empresa, este cliente, solo preprocesamiento), de corta duración y revocable por el cliente en cualquier momento. Eso es lo que convierte una identidad declarada en una con procedencia.
Los verbos
| Verbo | Nivel | Propósito |
|---|---|---|
get_capabilities | lectura | Qué puede responder y hacer este agente; sus servicios y límites |
get_requirements(service) | lectura | El contrato de recepción — campos obligatorios/opcionales, tipos y políticas fundamentadas |
ask(question) | lectura | Una respuesta fundamentada con citas, o un traspaso si está fuera de alcance |
status(reference) | lectura | Progreso de una solicitud previa |
propose(service, payload) | escritura | Envía una solicitud estructurada; devuelve un borrador + resumen |
handoff_to_human(reference?) | escritura | Un enlace de continuación que el asistente devuelve a su dueño |
El contrato de recepción
get_requirements es la clave para eliminar la fricción — el asistente nunca debería tener que adivinar
tu formato. Devuelve los campos que un servicio necesita y las políticas fundamentadas a su alrededor
(depósito, plazo de antelación, cancelación), derivadas de las habilidades de tu agente — así que el
asistente completa lo que sabe y le pregunta a su dueño solo lo que genuinamente falta.
El modelo de borrador
propose nunca devuelve "hecho". Su estado más fuerte es tentative — una solicitud preparada y a la
espera de confirmación, no una transacción completada:
needs_info— faltan campos obligatorios o son ambiguos; consultaopen_questions.tentative— aceptada como borrador, pendiente de confirmación.declined— no puede aceptarse (fuera de política o de alcance).
Nada queda confirmed hasta que una persona lo confirma. Tu marketing y tus respuestas deben reflejar
esto — una reserva tentative es una solicitud, no una mesa reservada.
Traspaso al humano
En cualquier momento el asistente (o tu agente) puede solicitar un traspaso. agent4.io genera un enlace de continuación acotado a esa sesión; el cliente lo abre, ve la transcripción completa y continúa como persona — corrigiendo o cancelando el borrador antes de que se confirme. La atribución de actor cambia en el traspaso, así que el registro siempre muestra quién dijo qué.
Auditoría
Cada interacción se registra, de solo anexado y vinculada a la referencia de la solicitud: cada aserción entrante (atribuida al asistente que llama y a la persona con la que está emparejado), cada respuesta que devolviste y el actor en cada paso. Una solicitud que envía datos nunca es anónima — que es lo que te permite tratar al asistente de un cliente como el representante autorizado de ese cliente, y demostrar después exactamente qué se intercambió.
Un ejemplo trabajado
- Descubrir — el asistente obtiene la tarjeta de tu agente.
- Emparejar — el cliente pulsa Usar con tu asistente de IA; el asistente intercambia el código por un token acotado.
get_requirements("reservation")— ventana de fecha/hora, tamaño del grupo, ubicación de mesa, notas dietéticas, nombre, contacto; más tu política de depósito y cancelación.propose("reservation", …)→{ status: "tentative", summary, reference, open_questions: [] }.- Confirmar — el asistente muestra el resumen a su dueño; tras la confirmación, tu equipo (o una comprobación de disponibilidad) lo finaliza.