Ресурсы для разработчиков и агентов
Все машиночитаемые документы, которые публикует Ivy, в одном месте. Без ключа, без регистрации, без согласования лимитов — каждый эндпоинт ниже доступен обычным публичным GET.
Ivy сделан так, чтобы программам было так же удобно им пользоваться, как и людям. Сайт отдаёт описание публичной поверхности в формате OpenAPI 3.1, сводки llms.txt для поисково-ответных систем, документы обнаружения в /.well-known/ и версию каждой маркетинговой страницы в text/markdown через согласование по заголовку Accept. Всё на этой странице стабильно, версионировано и пригодно для автоматизации.
Спецификации API
Машиночитаемые описания публичного API. Оба документа генерируются из одного источника, поэтому разойтись не могут.
Публичный API для агентов
Четыре JSON-эндпоинта без аутентификации: что такое Ivy, когда агенту стоит к нему обратиться и где его скачать.
Возможности агента
/api/v1/agent/capabilitiesПоддерживаемые агенты для программирования и языковые модели с матрицей возможностей по каждому.
Инструкции для агентов
/api/v1/agent/instructionsКогда использовать Tendril, когда не стоит, как его вызывать и как выглядит путь внедрения.
Контекст компании и продукта
/api/v1/agent/contextСведения об организации, каталог продуктов, тарифные уровни и полная карта эндпоинтов.
Загрузка релизов
/api/v1/agent/downloadsТекущий релиз Tendril со ссылками на установщики для каждой поддерживаемой платформы.
Ресурсы для поисково-ответных систем
Текстовые сводки, написанные для больших языковых моделей по соглашению llms.txt.
Сводка llms.txt
/llms.txtКраткий обзор Ivy, Tendril, ресурсов для разработчиков и того, как агентам к ним обращаться.
Расширенная сводка llms-full.txt
/llms-full.txtРасширенная версия, охватывающая все маркетинговые страницы, тарифы и опубликованные статьи.
agent-instructions.txt
/agent-instructions.txtРабочие инструкции для автономных агентов, которые оценивают или устанавливают Tendril.
Документы обнаружения
Well-known URI, по которым клиент настраивает себя сам, без подсказок о том, где что лежит.
Манифест Model Context Protocol
/.well-known/mcp.jsonДескриптор MCP-сервера для агентов, говорящих на Model Context Protocol.
Манифест Universal Commerce Protocol
/.well-known/ucp/manifest.jsonИдентичность поставщика, категория услуги и цены, объявленные для коммерческих агентов.
security.txt
/.well-known/security.txtКуда сообщать об уязвимости, согласно RFC 9116.
Согласование контента в markdown
Отправьте Accept: text/markdown на любую маркетинговую страницу — и получите чистый markdown вместо HTML: без скрейпинга и разбора DOM. Это следует соглашению acceptmarkdown.com.
curl -H 'Accept: text/markdown' https://ivy.app/productОграничения частоты запросов
Публичные эндпоинты объявляют бюджет запросов заголовками RateLimit из черновика стандарта IETF, чтобы клиент узнавал предел заранее, а не в момент отключения. Документы отдаются из кэша и ревалидируются раз в час, поэтому клиент, соблюдающий Cache-Control, бюджет не исчерпает. Если бюджет всё же превышен, ответом будет 429 с заголовком Retry-After и документом проблемы по RFC 9457.
Версионирование и вывод из эксплуатации
Эндпоинты агента версионируются в пути (/api/v1/). Несовместимые изменения выходят под новой версией, а не меняют существующую. Когда операцию выводят из эксплуатации, её сначала помечают устаревшей в документе OpenAPI и не менее 180 дней отдают заголовки Deprecation и Sunset до удаления, согласно RFC 9745 и RFC 8594.
Разрабатывайте с Ivy
Исходный код Tendril открыт для просмотра, а слой оркестрации работает на вашей собственной машине.