Recursos para desenvolvedores e agentes
Todos os documentos legíveis por máquina que a Ivy publica, em um só lugar. Sem chave, sem cadastro, sem negociar limites — cada endpoint abaixo é um GET público.
A Ivy é construída para ser consumida por software com a mesma facilidade que por pessoas. O site serve uma descrição OpenAPI 3.1 da sua superfície pública, resumos llms.txt para motores de resposta, documentos de descoberta em /.well-known/ e uma versão em text/markdown de cada página de marketing via negociação por cabeçalho Accept. Tudo nesta página é estável, versionado e seguro para automatizar.
Especificações de API
Descrições legíveis por máquina da API pública. Os dois documentos são gerados de uma única fonte, então nunca podem divergir.
API pública de agentes
Quatro endpoints JSON sem autenticação que descrevem o que é a Ivy, quando um agente deve recorrer a ela e onde baixá-la.
Capacidades do agente
/api/v1/agent/capabilitiesAgentes de programação e modelos de linguagem suportados, com a matriz de recursos de cada um.
Instruções para agentes
/api/v1/agent/instructionsQuando usar o Tendril, quando não usar, como chamá-lo e qual é o caminho de adoção.
Contexto de empresa e produto
/api/v1/agent/contextDados da organização, catálogo de produtos, planos de preços e o mapa completo de endpoints.
Downloads de versões
/api/v1/agent/downloadsA versão atual do Tendril com as URLs de instalação para cada plataforma suportada.
Recursos para motores de resposta
Resumos em texto puro escritos para grandes modelos de linguagem, seguindo a convenção llms.txt.
Resumo llms.txt
/llms.txtVisão geral concisa da Ivy, do Tendril, dos recursos para desenvolvedores e de como os agentes devem chamá-los.
Resumo estendido llms-full.txt
/llms-full.txtEdição ampliada cobrindo cada página de marketing, plano de preços e artigo publicado.
agent-instructions.txt
/agent-instructions.txtInstruções operacionais para agentes autônomos que avaliam ou instalam o Tendril.
Documentos de descoberta
URIs well-known que permitem a um cliente se configurar sozinho, sem que ninguém precise dizer onde cada coisa está.
Manifesto do Model Context Protocol
/.well-known/mcp.jsonDescritor de servidor MCP para agentes que falam Model Context Protocol.
Manifesto do Universal Commerce Protocol
/.well-known/ucp/manifest.jsonIdentidade do provedor, categoria de serviço e preços, declarados para agentes de comércio.
security.txt
/.well-known/security.txtOnde relatar uma vulnerabilidade de segurança, conforme a RFC 9116.
Negociação de conteúdo em markdown
Envie Accept: text/markdown para qualquer página de marketing e você recebe markdown limpo em vez de HTML — sem scraping, sem parsing de DOM. Isso segue a convenção do acceptmarkdown.com.
curl -H 'Accept: text/markdown' https://ivy.app/productLimites de requisições
Endpoints públicos anunciam seu orçamento de requisições com os cabeçalhos RateLimit do rascunho de padrão da IETF, para que o cliente descubra o teto em vez de encontrá-lo ao ser cortado. Os documentos são servidos de cache e revalidados a cada hora, então um cliente que respeita Cache-Control não consegue esgotar o orçamento. Se o orçamento for excedido, a resposta é 429 com cabeçalho Retry-After e um documento de problema conforme a RFC 9457.
Versionamento e descontinuação
Os endpoints de agente são versionados no caminho (/api/v1/). Mudanças incompatíveis saem sob uma nova versão em vez de alterar uma existente. Quando uma operação é aposentada, ela primeiro é marcada como obsoleta no documento OpenAPI e serve cabeçalhos Deprecation e Sunset por pelo menos 180 dias antes da remoção, conforme as RFC 9745 e RFC 8594.
Construa com a Ivy
O Tendril tem código disponível e a camada de orquestração roda na sua própria máquina.