Agent Experience · Parte de uxuiprinciples
Diseña tu producto para los agentes que ahora lo usan.
25 principios de Agent Experience orientados al sistema, cada uno con un artefacto listo para copiar, una cita verificable y código. La referencia para construir productos listos para agentes.
Comprensible
Expón tu propósito en forma limpia y legible por máquinas para que los agentes lo usen y citen.
Accesible
Permite que los agentes se autentiquen con identidades acotadas y errores autocorregibles, sin barreras solo para humanos.
Accionable
Ofrece herramientas acotadas y bien descritas, con resultados estructurados sobre los que los agentes actúen con seguridad.
Responsable
Haz visible la actividad de los agentes, acota la autonomía y recupérate de los fallos con elegancia.
Categorías
Nueve formas de manejar a los agentes
Context and comprehension
3 principiosHaz que lo que hace tu producto sea interpretable por una máquina, en forma limpia y eficiente en tokens.
Access and identity
5 principiosPermite que los agentes se autentiquen con identidades acotadas, de mínimo privilegio y errores autocorregibles.
Discovery and navigation
3 principiosExpón mapas de capacidades y recursos legibles por máquinas que los agentes puedan encontrar y recorrer.
Tools and capabilities
4 principiosDiseña herramientas acotadas y bien descritas, y trata sus metadatos como una frontera de confianza.
Recovery and reliability
2 principiosFalla de forma elegante e idempotente para que los agentes reintenten sin efectos duplicados.
Memory and state
1 principiosConserva un estado duradero y reanudable a lo largo de flujos de agente largos y de varios pasos.
Notifications and change
1 principiosAvisa a los agentes cuando algo cambia mediante webhooks, feeds de cambios y versionado.
Orchestration and handoff
2 principiosSé activable por otros agentes y define roles claros y contratos de transferencia.
Observability and governance
4 principiosHaz visible la actividad de los agentes, acota la autonomía con límites y renderiza su salida de forma segura.
Artefactos
Copiar y pegar, no teoría
# Acme
> One-line description of what Acme does.
## Docs
- [Quickstart](https://acme.com/docs/quickstart.md): get running in 5 minutes
- [API reference](https://acme.com/docs/api.md): endpoints and schemas<script type="application/ld+json">
{"@context":"https://schema.org","@type":"SoftwareApplication","name":"Acme",
"description":"Acme helps teams do X.","url":"https://acme.com",
"offers":{"@type":"Offer","price":"29","priceCurrency":"USD"}}
</script>GET /docs/quickstart HTTP/1.1
Accept: text/markdown<link rel="alternate" type="text/markdown" href="/docs/quickstart.md">Cómo usar esto
Lee el principio
Cada principio dice qué hacer, por qué y qué evitar, con una cita primaria.
Copia el artefacto
Toma el manifiesto, esquema, forma de error o encabezado y adáptalo a tu stack.
Publica y verifica
Practícalo: expón llms.txt, un manifiesto de capacidades y gemelos en markdown como este sitio.