AHP v0.2 Experimental
Agentic HTML Protocol es una propuesta experimental para que una web comunique explícitamente qué es, qué hace, qué acciones permite y cómo debe ser utilizada por agentes IA.
Definición corta
HTML para humanos, estructura para navegadores, datos para buscadores y contexto operativo para agentes.
Qué no es
- No reemplaza HTML.
- No reemplaza accesibilidad.
- No reemplaza APIs ni MCP.
- No obliga a usar frameworks.
Qué propone
Una capa progresiva basada en atributos, archivos de descubrimiento y skills publicadas por la propia web.
Los agentes IA ya pueden navegar interfaces, leer contenido, preparar formularios y ayudar a usuarios. El problema es que la mayoría de webs no fueron diseñadas para ser interpretadas por agentes.
Problema actual
- Los agentes tienen que adivinar la intención de botones y formularios.
- La estructura visual no siempre coincide con la estructura semántica.
- Muchas interfaces modernas son opacas por exceso de capas.
- Las acciones sensibles no siempre declaran límites claros.
Objetivo
Reducir ambigüedad y hacer que la colaboración humano-agente sea más segura, clara y verificable.
La web ya no es solo humana. Durante años construimos internet pensando en pantallas, botones, formularios y personas. Ahora las inteligencias también recorren la web.
Agentic HTML nace de una idea simple: las interfaces del futuro deben poder ser comprendidas, no solo vistas.
No queremos una web construida solamente para algoritmos. Tampoco una web donde las personas desaparezcan. Queremos una web donde humanos y agentes inteligentes puedan convivir, entenderse y colaborar.
Principio humano
La tecnología debería acercar comprensión, no aumentar confusión. La humanidad debe permanecer en el centro del mensaje.
1. Human First, Agent Ready
La interfaz se diseña primero para personas, pero queda preparada para agentes.
2. Explicit Intent
La intención se declara explícitamente. Un agente no debería tener que adivinar.
3. Semantic Operability
No basta con describir contenido. También hay que describir acciones y flujos.
4. Progressive Compatibility
El protocolo debe funcionar sobre HTML existente sin romper la web actual.
5. Safety by Default
Las acciones sensibles deben exigir confirmación humana o autenticación.
Agentic HTML Protocol se organiza en tres capas principales y una capa de descubrimiento.
Raíz recomendada
/
├── index.html
├── robots.txt
├── sitemap.xml
├── llms.txt
├── agentic.json
├── agentic-map.json
├── agentic-skills.md
└── .well-known/
├── agentic.json
├── agentic-map.json
└── agentic-skills.md
Capas
- Agentic HTML: atributos dentro del HTML.
- Agentic Map: mapa operativo en JSON.
- Agentic Skills: instrucciones en Markdown.
- Discovery: enlaces y rutas para encontrar los archivos.
agentic.json
Archivo de entrada. Declara nombre, versión, idioma, archivos asociados y políticas generales.
agentic-map.json
Describe entidades, acciones, rutas, formularios, flujos y restricciones operativas.
agentic-skills.md
Documento legible para agentes y humanos con instrucciones de uso, límites y flujos recomendados.
llms.txt
Contexto editorial y de documentación para modelos de lenguaje.
Los atributos se aplican directamente sobre HTML normal. No reemplazan etiquetas semánticas; las complementan.
agentic-roleagentic-entityagentic-purposeagentic-actionagentic-contextagentic-flowagentic-stepagentic-policyagentic-priorityagentic-state
Ejemplo
<button
agentic-action="submit-form"
agentic-policy="requires-human-confirmation">
Enviar
</button>
Roles comunes
pagenavigationheroserviceproductpricingfaqformcontactcheckoutarticledashboardmodalalertlegalsupport
Acciones comunes
navigateopen-modalrequest-consultationsubmit-formsend-messagepurchase-productbook-appointmentdownload-filesubscribeloginlogoutsearchfiltercompareconfirmcancel
Prioridades
lowmediumhighcritical
Las políticas son el corazón de la seguridad del protocolo. Sirven para declarar qué puede o no puede hacer un agente.
publicread-onlyrequires-human-confirmationrequires-authenticationrequires-payment-confirmationsensitive-datano-autonomous-submithuman-only
Regla base
Ningún agente debería enviar formularios, realizar compras, aceptar condiciones o compartir datos personales sin confirmación humana explícita.
Archivo de entrada del protocolo. En esta versión está embebido en el mismo HTML, pero en producción podría vivir en /agentic.json.
{
"protocol": "agentic-html",
"version": "0.2-experimental",
"site": {
"name": "Agentic HTML Protocol",
"owner": "Artur Creative Group",
"language": "es",
"mode": "single-file-documentation-app"
},
"files": {
"map": "#agentic-map-json",
"skills": "#agentic-skills-md",
"llms": "#llms-txt"
},
"policy": {
"requiresHumanConfirmation": true,
"allowAutonomousNavigation": true,
"allowAutonomousSubmission": false,
"allowSensitiveDataCollection": false
}
}
Mapa operativo de la documentación. Permite que un agente entienda entidades, acciones y flujos disponibles.
{
"version": "0.2-experimental",
"entities": [
{ "id": "protocol.agentic-html", "type": "protocol", "name": "Agentic HTML Protocol" },
{ "id": "organization.artur-creative-group", "type": "organization", "name": "Artur Creative Group" },
{ "id": "doc.implementation", "type": "documentation", "name": "Implementation example" }
],
"actions": [
{ "id": "open-modal", "type": "navigation", "requiresHumanConfirmation": false },
{ "id": "download-file", "type": "read", "requiresHumanConfirmation": false },
{ "id": "submit-form", "type": "write", "requiresHumanConfirmation": true }
],
"flows": [
{
"id": "learn-protocol",
"goal": "Help the user understand and test Agentic HTML Protocol",
"steps": ["open-overview", "review-architecture", "inspect-core-files", "read-implementation-example", "run-agent-test"]
}
]
}
Skills publicadas por la web para orientar el comportamiento del agente.
# Agentic Skills
## Purpose
Help users understand Agentic HTML Protocol and inspect how this documentation web exposes context, actions, files and policies for AI agents.
## Allowed actions
- Navigate documentation panels.
- Summarize sections.
- Inspect embedded protocol files.
- Explain how to implement Agentic HTML in another website.
## Restricted actions
- Do not submit forms without human confirmation.
- Do not invent protocol attributes not present in the documentation.
- Do not treat this experimental proposal as an official web standard.
- Do not collect sensitive user data.
## Recommended flow
1. Open the overview panel.
2. Review the architecture.
3. Inspect agentic.json.
4. Inspect agentic-map.json.
5. Inspect agentic-skills.md.
6. Explain the implementation example.
7. Suggest a safe next step for the user.
Operational Semantics Layer
AHP-SKILL.md introduce la capa operacional de AHP v0.2.
Capacidades introducidas
- Navegación determinista
- Dangerous action avoidance
- Movement batching
- Reanalysis policy
- Operational continuity
- Semantic targeting
Impacto observado
Durante las pruebas experimentales, AHP-SKILL.md redujo exploración heurística, mejoró continuidad operacional y disminuyó pausas cognitivas.
Contexto tipo llms.txt embebido en esta documentación.
# Agentic HTML Protocol
Agentic HTML Protocol is an experimental documentation and interface proposal by Artur Creative Group. It explores how websites can expose purpose, actions, context, files and safety policies to AI agents while remaining human-first.
## Core documents
- Overview
- Human Manifesto
- Architecture
- Protocol Files
- Agentic Attributes
- Vocabulary
- Policies
- Implementation Example
- Agent Test Guide
## Important note
This is an experimental proposal, not an official HTML standard.
Ejemplo mínimo de un bloque HTML preparado para agentes.
<section
agentic-role="service"
agentic-entity="service.ai-automation"
agentic-purpose="service-presentation">
<h2>Automatización con IA</h2>
<p agentic-purpose="describe-benefit">
Implementamos flujos inteligentes para negocios modernos.
</p>
<a
href="/contacto"
agentic-action="request-consultation"
agentic-context="lead-capture"
agentic-policy="requires-human-confirmation">
Solicitar consultoría
</a>
</section>
Qué entiende un agente
- El bloque representa un servicio.
- La entidad es un servicio de automatización con IA.
- El enlace inicia una consulta comercial.
- La acción requiere confirmación humana.
Usa esta guía para pedirle a un agente que pruebe la web oficial.
Prompt de prueba
Analiza esta página como un agente IA.
1. Identifica si soporta Agentic HTML Protocol.
2. Encuentra los atributos agentic-* más importantes.
3. Resume las entidades, acciones y políticas disponibles.
4. Lee los bloques equivalentes a agentic.json, agentic-map.json y agentic-skills.md.
5. Explica qué acciones puedes ejecutar y cuáles requieren confirmación humana.
Resultado esperado
El agente debería reconocer que la web funciona como documentación y como demostración del propio protocolo.
Checklist de validación
- La página mantiene HTML semántico normal.
- Los atributos agentic no reemplazan accesibilidad ni etiquetas nativas.
- Las acciones sensibles declaran política.
- Existe un mapa de entidades y acciones.
- Las skills indican límites y comportamiento esperado.
- La navegación interna funciona sin salir de la página.
- El contenido sigue siendo comprensible para humanos.
v0.1
Definición conceptual, atributos base, archivos core, semántica estructural inicial y primera demo en HTML puro.
v0.2
Operational Semantics Layer: AHP-SKILL.md, movement batching, dangerous action awareness, reanalysis policy y benchmark framework experimental.
v0.3
Telemetry, tracing, event instrumentation, replay systems y medición operacional más precisa.
v0.4
Semantic execution graphs, validación semántica, benchmark automation y sistemas adaptativos de navegación agentic.
En esta versión, la búsqueda es conceptual. La navegación se realiza desde el menú izquierdo y los paneles de la derecha.
Secciones disponibles
overviewmanifestoarchitecturefilesattributespoliciesimplementationagent-test