--- title: "Documentación para agentes de IA" description: "Cómo las herramientas de IA leen esta documentación en Markdown, encuentran los documentos OpenAPI de la API e instalan la skill de la API de Arbol." --- > Documentation Index > Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt > Use this file to discover all available pages before exploring further. # Documentación para agentes de IA 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`](/llms.txt) | El índice de la documentación: las páginas de nivel superior y un índice por sección. | | `/
/llms.txt` | Las páginas de una sección, enlazadas a su Markdown, como `/developers/guides/llms.txt`. | | `/api//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`](/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: ```text https://docs.getarbol.com/en/developers/guides/create-an-agent/ https://docs.getarbol.com/en/developers/guides/create-an-agent/index.md ``` Las 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 ``, 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: ```text https://docs.getarbol.com/api//openapi.json ``` ## Descubrimiento | URL | Qué contiene | |---|---| | `/.well-known/api-catalog` | Un catálogo de API según [RFC 9727](https://www.rfc-editor.org/rfc/rfc9727): 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](https://agentskills.io/specification) 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//SKILL.md`. El índice [`/.well-known/agent-skills/index.json`](https://docs.getarbol.com/.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: ```json { "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](/developers/mcp/). Source: https://docs.getarbol.com/developers/ai-agents/index.mdx