Ressources pour développeurs et agents
Tous les documents lisibles par machine publiés par Ivy, au même endroit. Pas de clé, pas d'inscription, pas de négociation de quota : chaque endpoint ci-dessous est un GET public.
Ivy est conçu pour être consommé par des logiciels aussi facilement que par des humains. Le site sert une description OpenAPI 3.1 de sa surface publique, des résumés llms.txt pour les moteurs de réponse, des documents de découverte sous /.well-known/ et une version text/markdown de chaque page marketing via la négociation par en-tête Accept. Tout ce qui figure sur cette page est stable, versionné et automatisable en toute sécurité.
Spécifications d'API
Descriptions lisibles par machine de l'API publique. Les deux documents sont générés depuis une source unique : ils ne peuvent donc pas diverger.
API publique pour agents
Quatre endpoints JSON sans authentification décrivant ce qu'est Ivy, quand un agent doit y recourir et où le télécharger.
Capacités de l'agent
/api/v1/agent/capabilitiesAgents de développement et modèles de langage pris en charge, avec la matrice de fonctionnalités de chacun.
Instructions pour agents
/api/v1/agent/instructionsQuand utiliser Tendril, quand s'en abstenir, comment l'appeler et quel est le parcours de prise en main.
Contexte entreprise et produit
/api/v1/agent/contextInformations sur l'organisation, catalogue produit, paliers tarifaires et carte complète des endpoints.
Téléchargements de versions
/api/v1/agent/downloadsLa version actuelle de Tendril avec les URL d'installation pour chaque plateforme prise en charge.
Ressources pour moteurs de réponse
Résumés en texte brut rédigés pour les grands modèles de langage, selon la convention llms.txt.
Résumé llms.txt
/llms.txtAperçu concis d'Ivy, de Tendril, des ressources développeurs et de la façon dont les agents doivent les appeler.
Résumé étendu llms-full.txt
/llms-full.txtÉdition élargie couvrant chaque page marketing, chaque palier tarifaire et chaque article publié.
agent-instructions.txt
/agent-instructions.txtInstructions opérationnelles pour les agents autonomes qui évaluent ou installent Tendril.
Documents de découverte
URI well-known qui permettent à un client de se configurer seul, sans qu'on lui indique où se trouve quoi que ce soit.
Manifeste Model Context Protocol
/.well-known/mcp.jsonDescripteur de serveur MCP pour les agents qui parlent le Model Context Protocol.
Manifeste Universal Commerce Protocol
/.well-known/ucp/manifest.jsonIdentité du fournisseur, catégorie de service et tarifs, déclarés pour les agents de commerce.
security.txt
/.well-known/security.txtOù signaler une vulnérabilité de sécurité, conformément à la RFC 9116.
Négociation de contenu markdown
Envoyez Accept: text/markdown à n'importe quelle page marketing et vous obtenez du markdown propre au lieu de HTML : pas de scraping, pas d'analyse du DOM. Cela suit la convention acceptmarkdown.com.
curl -H 'Accept: text/markdown' https://ivy.app/productLimites de débit
Les endpoints publics annoncent leur budget de requêtes via les en-têtes RateLimit du projet de norme IETF, afin qu'un client découvre le plafond au lieu de le constater en étant coupé. Les documents sont servis depuis le cache et revalidés toutes les heures : un client qui respecte Cache-Control ne peut donc pas épuiser le budget. Si un budget venait à être dépassé, la réponse est un 429 avec un en-tête Retry-After et un document de problème conforme à la RFC 9457.
Versionnement et dépréciation
Les endpoints agents sont versionnés dans le chemin (/api/v1/). Les changements incompatibles sortent sous une nouvelle version plutôt que de modifier une version existante. Lorsqu'une opération est retirée, elle est d'abord marquée dépréciée dans le document OpenAPI et sert des en-têtes Deprecation et Sunset pendant au moins 180 jours avant suppression, conformément aux RFC 9745 et RFC 8594.
Construire avec Ivy
Tendril est en source disponible et la couche d'orchestration s'exécute sur votre propre machine.