Resurser för utvecklare och agenter
Varje maskinläsbart dokument som Ivy publicerar, på ett ställe. Ingen nyckel, ingen registrering, inget förhandlande om kvoter – varje endpoint nedan är en publik GET.
Ivy är byggt för att konsumeras av programvara lika enkelt som av människor. Webbplatsen serverar en OpenAPI 3.1-beskrivning av sin publika yta, llms.txt-sammanfattningar för svarsmotorer, upptäcktsdokument under /.well-known/ och en text/markdown-version av varje marknadssida via förhandling med Accept-huvudet. Allt på den här sidan är stabilt, versionerat och tryggt att automatisera mot.
API-specifikationer
Maskinläsbara beskrivningar av det publika API:et. Båda dokumenten genereras ur en och samma källa, så de kan aldrig glida isär.
Publikt agent-API
Fyra oautentiserade JSON-endpoints som beskriver vad Ivy är, när en agent bör använda det och var det laddas ned.
Agentens förmågor
/api/v1/agent/capabilitiesKodningsagenter och språkmodeller som stöds, med funktionsmatris för var och en.
Instruktioner för agenter
/api/v1/agent/instructionsNär Tendril ska användas, när det inte ska det, hur det anropas och hur introduktionen går till.
Företags- och produktkontext
/api/v1/agent/contextUppgifter om organisationen, produktkatalog, prisnivåer och den fullständiga endpoint-kartan.
Nedladdning av släpp
/api/v1/agent/downloadsAktuellt Tendril-släpp med installations-URL:er för varje plattform som stöds.
Resurser för svarsmotorer
Sammanfattningar i klartext skrivna för stora språkmodeller, enligt konventionen llms.txt.
llms.txt-sammanfattning
/llms.txtKortfattad översikt över Ivy, Tendril, utvecklarresurserna och hur agenter bör anropa dem.
Utökad llms-full.txt-sammanfattning
/llms-full.txtUtökad utgåva som täcker varje marknadssida, prisnivå och publicerad artikel.
agent-instructions.txt
/agent-instructions.txtDriftinstruktioner för autonoma agenter som utvärderar eller installerar Tendril.
Upptäcktsdokument
Well-known-URI:er som låter en klient konfigurera sig själv utan att få veta var något ligger.
Manifest för Model Context Protocol
/.well-known/mcp.jsonMCP-serverbeskrivning för agenter som talar Model Context Protocol.
Manifest för Universal Commerce Protocol
/.well-known/ucp/manifest.jsonLeverantörsidentitet, tjänstekategori och priser, deklarerade för handelsagenter.
security.txt
/.well-known/security.txtVar en säkerhetsbrist rapporteras, enligt RFC 9116.
Innehållsförhandling med markdown
Skicka Accept: text/markdown till vilken marknadssida som helst så får du ren markdown i stället för HTML – ingen skrapning, ingen DOM-parsning. Detta följer konventionen på acceptmarkdown.com.
curl -H 'Accept: text/markdown' https://ivy.app/productAnropsgränser
Publika endpoints annonserar sin förfrågningsbudget med RateLimit-huvudena från IETF:s utkast, så att en klient kan upptäcka taket i stället för att märka det genom att bli avstängd. Dokument serveras från cache och omvalideras varje timme, så en klient som respekterar Cache-Control kan inte göra slut på budgeten. Om en budget ändå överskrids blir svaret 429 med ett Retry-After-huvud och ett problemdokument enligt RFC 9457.
Versionering och utfasning
Agent-endpoints versioneras i sökvägen (/api/v1/). Brytande ändringar släpps under en ny version i stället för att förändra en befintlig. När en operation tas ur bruk markeras den först som deprecated i OpenAPI-dokumentet och serverar Deprecation- och Sunset-huvuden i minst 180 dagar före borttagning, enligt RFC 9745 och RFC 8594.
Bygg med Ivy
Tendril är source-available och orkestreringslagret körs på din egen maskin.