Esta documentación se publica tanto para herramientas de IA como para personas. Un agente puede leer cualquier página en Markdown, encontrar todas las referencias de la API y sus documentos OpenAPI a partir de unas pocas URL conocidas, e instalar una skill que le enseña a llamar a la API de Arbol. Todo es público y no necesita credenciales.
Empieza en llms.txt
| URL | Qué contiene |
|---|---|
/llms.txt |
El índice de la documentación: las páginas de nivel superior y un índice por sección. |
/<section>/llms.txt |
Las páginas de una sección, enlazadas a su Markdown, como /developers/guides/llms.txt. |
/api/<service>/llms.txt |
Una referencia de la API, como /api/raiz/llms.txt, con un índice por recurso, como /api/raiz/agents/llms.txt, que lista cada operación y lo que hace. |
/llms-full.txt |
Todas las páginas de la documentación en un solo documento Markdown, para las herramientas que lo leen todo de una vez. |
Markdown para cada página
Agrega index.md a la URL de una página para obtenerla en Markdown, con los componentes convertidos en texto plano:
https://docs.getarbol.com/en/developers/guides/create-an-agent/
https://docs.getarbol.com/en/developers/guides/create-an-agent/index.mdLas páginas de la documentación también sirven su fuente original en index.mdx; las páginas de la referencia de la API solo tienen index.md. La página de inicio es /index.md. Cada página HTML enlaza su versión en Markdown con <link rel="alternate" type="text/markdown">, se describe con JSON-LD y lleva una nota visualmente oculta que remite a los agentes a su Markdown y a /llms.txt.
Documentos OpenAPI
Cada referencia de la API publica su documento OpenAPI como un único archivo JSON autocontenido, con los ejemplos de código de cada operación (x-codeSamples) y, en su descripción, el scope que necesita, las credenciales que acepta, su efecto y sus límites:
https://docs.getarbol.com/api/<service>/openapi.jsonDescubrimiento
| URL | Qué contiene |
|---|---|
/.well-known/api-catalog |
Un catálogo de API según RFC 9727: una entrada por referencia de la API, que enlaza su página, su Markdown y su documento OpenAPI. |
/.well-known/ard.json, /.well-known/ai-catalog.json |
El mismo manifiesto de descubrimiento: /llms.txt, el Markdown de la página de inicio, cada documento OpenAPI y el índice de Agent Skills. |
/.well-known/agent-skills/index.json |
Las Agent Skills que publica este sitio, cada una con un digest SHA-256. |
/robots.txt, /sitemap-index.xml |
La política para rastreadores y el mapa del sitio. |
La skill de la API de Arbol
/.well-known/agent-skills/arbol-api/SKILL.md es una Agent Skill que le enseña a un agente a llamar correctamente a la API de Arbol: la URL base, cómo encontrar un servicio y su documento OpenAPI, las credenciales y el encabezado Authorization, el envoltorio de respuesta y los errores, cuándo no reintentar, y el mínimo privilegio. Instálala en cualquier herramienta que admita Agent Skills, o indícale al agente su URL.
Skills
Este sitio publica además skills para tareas concretas, cada una en /.well-known/agent-skills/<nombre>/SKILL.md. El índice /.well-known/agent-skills/index.json las lista todas.
| Skill | Para qué sirve |
|---|---|
arbol-api |
Llamar correctamente a la API de Arbol: credenciales, respuestas, errores y reintentos (arriba). |
arbol-docs-help |
Ayudar a alguien del equipo de la clínica a hacer una tarea en las aplicaciones de Arbol, con las guías de esta documentación. |
raiz-agents |
Crear, probar y actualizar un agente de Raíz, y asignarle un canal. |
raiz-instructions |
Escribir o mejorar las instrucciones de un agente de Raíz, con límites de seguridad clínica y conversaciones de prueba. |
raiz-conversations |
Hacer seguimiento de conversaciones y contactos, tomar o devolver una conversación y resumirla para una persona. |
agenda-scheduling |
Encontrar un horario y agendar, reprogramar o cancelar una cita con la confirmación de la persona. |
agenda-setup |
Revisar los servicios, agendas, sedes y horarios de Agenda, comprobar que un servicio ofrece cupos y guiar a la administración en la aplicación. |
arbol-troubleshooting |
Diagnosticar un problema, leer el error, decidir si reintentar, corregir o escalar, y reportarlo sin datos de pacientes ni credenciales. |
arbol-cli |
Usar la CLI arbol desde una terminal, un script o CI sin exponer credenciales. |
arbi |
Trabajar junto a Arbi, el asistente del equipo: qué sabe hacer en cada aplicación y en WhatsApp, qué espera aprobación, quién ve sus notas y cuándo llevar a una persona a Arbi, a una guía o al equipo de Arbol. |
Buscar desde el navegador
En los navegadores que admiten WebMCP, cada página registra una herramienta search_documentation que busca en esta documentación y responde con títulos, URL con anclas y fragmentos:
{ "query": "create an agent", "limit": 5 }query es obligatorio, de hasta 500 caracteres; limit va de 1 a 20, 5 por defecto.
Actuar sobre Arbol
Esta documentación explica la API; no la llama. Para que un asistente de IA trabaje con los datos de tu organización, como agentes, conversaciones o citas, conéctalo al servidor MCP de Arbol, que ofrece operaciones de la API como herramientas y las ejecuta con tus propias credenciales. Consulta MCP.