Un agente que responde una pregunta sobre API puede necesitar una guía de autenticación y una referencia de endpoint. Cargar un sitio web completo también trae material que no tiene relación con esa tarea.
La propuesta de llms.txt ofrece a los editores un lugar para describir su contenido y enlazar páginas Markdown útiles.
¿Qué contiene el archivo?
El archivo contiene un nombre de proyecto y puede incluir un resumen, indicaciones y enlaces agrupados hacia información adicional.
La propuesta usa Markdown para que personas y programas puedan procesar el mismo archivo. Sus listas de enlaces apuntan a contenido que el agente puede obtener cuando lo necesite.
Un índice de documentación podría agrupar autenticación, envío de mensajes y eventos de entrega bajo encabezados separados. Las descripciones breves ayudan al agente a distinguir esos destinos antes de descargarlos.
La propuesta también permite índices por debajo de la raíz del sitio. Un índice dentro de una ruta de documentación cubre el contenido bajo esa ruta.
¿Es lo mismo que robots.txt o un sitemap?
Estos archivos tienen propósitos distintos: reglas de acceso, descubrimiento de URL y una ruta curada hacia el contenido.
| Archivo | Propósito |
|---|---|
robots.txt | Proporciona a los clientes automatizados reglas de rastreo |
| Sitemap | Lista URL para que los motores de búsqueda las descubran |
llms.txt | Describe contenido y enlaza información útil detallada para agentes |
La comparación de la propuesta con estándares existentes describe llms.txt como complementario a los otros archivos. Publicarlo no otorga acceso a contenido protegido.
Tampoco expone una acción ejecutable. Un agente necesita una API separada o una conexión MCP para realizar operaciones en el espacio de trabajo.
¿Publicarlo demuestra que los agentes lo usan?
Publicar un índice legible establece disponibilidad. La evidencia de uso requiere observar que un cliente obtenga y use ese contenido.
La auditoría Lighthouse de Chrome verifica errores del servidor al obtener el archivo. Un archivo ausente recibe un resultado de no aplica porque el archivo es opcional. Superar esa verificación no mide la calidad de las respuestas del agente.
Para tu propia evaluación, registra la tarea y los documentos que el cliente obtuvo. Verifica si el agente llegó a la respuesta correcta o completó la acción prevista. Compara ejecuciones equivalentes para evaluar si el índice ayudó.
Una solicitud en un registro de acceso demuestra una obtención. Por sí sola, no demuestra que el cliente usó el contenido en su respuesta. Una cita establece una observación distinta. Mantén estos resultados separados al reportar conclusiones.
¿Qué documentación de Bird debo darle a un agente?
Puedes proporcionar el índice llms.txt de Bird cuando un agente necesite descubrir documentación y obtener páginas relevantes.
La guía de documentación legible por máquinas describe el índice, las páginas Markdown individuales y el corpus completo. El índice proporciona enlaces; las páginas individuales permiten al cliente obtener una respuesta enfocada.
llms-full.txt concatena la documentación con las URL de origen. Ese formato más grande es adecuado para un flujo de trabajo que necesita explícitamente el corpus, sujeto a los límites de contexto del cliente.
Para realizar una tarea de mensajería después de obtener las instrucciones, conecta el servidor MCP de Bird. La documentación proporciona información; la conexión autenticada proporciona acceso a las operaciones del espacio de trabajo.