Recursos para desarrolladores y agentes
Todos los documentos legibles por máquina que publica Ivy, en un solo lugar. Sin clave, sin registro, sin negociar límites: cada endpoint de abajo es un GET público.
Ivy está construido para que el software lo consuma con la misma facilidad que las personas. El sitio sirve una descripción OpenAPI 3.1 de su superficie pública, resúmenes llms.txt para motores de respuesta, documentos de descubrimiento bajo /.well-known/ y una versión en text/markdown de cada página de marketing mediante negociación por cabecera Accept. Todo lo de esta página es estable, versionado y seguro para automatizar.
Especificaciones de la API
Descripciones legibles por máquina de la API pública. Ambos documentos se generan desde una única fuente, así que nunca pueden desincronizarse.
API pública de agentes
Cuatro endpoints JSON sin autenticación que describen qué es Ivy, cuándo debería usarlo un agente y dónde descargarlo.
Capacidades del agente
/api/v1/agent/capabilitiesAgentes de programación y modelos de lenguaje admitidos, con la matriz de funciones de cada uno.
Instrucciones para agentes
/api/v1/agent/instructionsCuándo usar Tendril, cuándo no, cómo invocarlo y cuál es la ruta de incorporación.
Contexto de empresa y producto
/api/v1/agent/contextDatos de la organización, catálogo de productos, planes de precios y el mapa completo de endpoints.
Descargas de versiones
/api/v1/agent/downloadsLa versión actual de Tendril con las URL de instalación para cada plataforma admitida.
Recursos para motores de respuesta
Resúmenes en texto plano escritos para grandes modelos de lenguaje, siguiendo la convención llms.txt.
Resumen llms.txt
/llms.txtVisión general concisa de Ivy, Tendril, los recursos para desarrolladores y cómo deberían invocarlos los agentes.
Resumen ampliado llms-full.txt
/llms-full.txtEdición extendida que cubre cada página de marketing, plan de precios y artículo publicado.
agent-instructions.txt
/agent-instructions.txtInstrucciones operativas para agentes autónomos que evalúan o instalan Tendril.
Documentos de descubrimiento
URI well-known que permiten a un cliente configurarse solo, sin que nadie le indique dónde está cada cosa.
Manifiesto del Model Context Protocol
/.well-known/mcp.jsonDescriptor de servidor MCP para agentes que hablan Model Context Protocol.
Manifiesto del Universal Commerce Protocol
/.well-known/ucp/manifest.jsonIdentidad del proveedor, categoría de servicio y precios, declarados para agentes de comercio.
security.txt
/.well-known/security.txtDónde reportar una vulnerabilidad de seguridad, según RFC 9116.
Negociación de contenido en markdown
Envía Accept: text/markdown a cualquier página de marketing y obtendrás markdown limpio en lugar de HTML: sin scraping, sin analizar el DOM. Esto sigue la convención de acceptmarkdown.com.
curl -H 'Accept: text/markdown' https://ivy.app/productLímites de uso
Los endpoints públicos anuncian su presupuesto de peticiones con las cabeceras RateLimit del borrador del IETF, de modo que un cliente puede descubrir el techo en lugar de encontrarlo al ser cortado. Los documentos se sirven desde caché y se revalidan cada hora, así que un cliente que respete Cache-Control no puede agotar el presupuesto. Si alguna vez se supera, la respuesta es 429 con cabecera Retry-After y un documento de problema según RFC 9457.
Versionado y obsolescencia
Los endpoints de agente se versionan en la ruta (/api/v1/). Los cambios incompatibles salen bajo una versión nueva en lugar de mutar una existente. Cuando se retira una operación, primero se marca como obsoleta en el documento OpenAPI y sirve cabeceras Deprecation y Sunset durante al menos 180 días antes de eliminarse, según RFC 9745 y RFC 8594.
Construye con Ivy
Tendril es de código disponible y la capa de orquestación se ejecuta en tu propia máquina.