Tight coupling Welding client and server together Server Client GET https:!"wttr.in/london?format=j1 Server implementation hardcoded in client superface.ai
API provider challenges API providers facing many problems How to version API? API design Securing APIs How to publish API? API product management What API style? REST vs GraphQL vs … How to monetize API How to discover API API testing API documentation API SDK Developer experience DX API governance Observability Operations & monitoring superface.ai
Analysis Development Testing Deployment time budget Expectation: Analysis Development … … Reality: superface.ai API consumer perspective Finding the right API Capability I need? Costs? How to get access? What are the limitations? SLAs? How to use it? How it works? How to map my data model? Why is it not doing what I want? Typical API integration project
API plumbing Manual labor needed to provide and consume capabilities ! Design API " Document # Publish $ Discover % Try &' Implement Maintain ( Build SDK ) Purchase * Test & Test ! Implement + API provider API consumer superface.ai
API documentation The centerpiece of APIs Most information needed are transferred “out of band" in human-centric API documentation* ⚠ superface.ai * - not accessible to machines until 2023
Your use-case Comlink interface # index API from plain text, readme.io, or OpenAPI Spec $ superface prepare https://resend.com/docs # create new Comlink for your use case $ superface new resend “send an email” Comlink interface superface.ai Resend API Your App
Your vocabulary Change data model, let AI to figure out the mapping # run mapping; Comlink engine will figure out how to map `from` to `sender` $ superface map send-email superface.ai
One use-case multiple APIs Unified APIs? Your app can handle it! # Index API documentations of different providers $ superface prepare https://resend.com/docs $ superface prepare https://docs.sendgrid.com/api-reference Resend API Sendgrid API Your App # Map use case to Resend API $ superface map send-email resend # Map use case to SendGrid API $ superface map send-email sendgrid superface.ai
Autonomous Agent Autonomy: freedom from external control or influence; independence Agent: a person who acts on behalf of another person, the doer of an action A software that acts on behalf of its users, that is free to make decisions. superface.ai Autonomous Agent Concept https://lilianweng.github.io/posts/2023-06-23-agent/
• Figures out at runtime how to connect API API Agent Registry I am here, and this is how agents connect I need to send email. What API is available? Here are the APIs and how to connect API Communication superface.ai
API landscape Agent Inventory 1 Inventory 2 Orders CRM PLM Agent is written for a use case, GET https:!"192.12.13.1/service/ inventory?pid=12355 “Check inventory” not for an API Use cases, not APIs superface.ai Boundary within agent navigates
Multiple API landscapes Mesh of capabilities Stripe Azure Ayden Twilio Google Fedex … Global Landscape Global capabilities Partner organization Service 2 Service 1 Service 3 Agent CRM Inventory 2 Orders Inventory 1 PLM Organization landscape Partner capabilities superface.ai
Navigation in a landscape Unknown or changing landscape of capabilities and providers Superface Hub Superface Auto Agent "Who can tell me about inventory?” List of available inventory services “What is the inventory for our product?” “The inventory for is 42” Internal inventory services superface.ai
Personal assistant Autonomous agent decides what of the available email services to use based on its configuration and your identity… “When was the last email from Edgar?” Gmail API Based on Hub configuration auto agent will ask Gmail “The last email from [email protected] was Yesterday” superface.ai
Provider selection The right capability and provider for the task Price, quality and relevancy… “Send “Greetings from Jane” to +38553694008” Infobip API Based on configuration, price, and country auto agent uses Infobip “Your message has been sent” superface.ai
zdne
ari_mharada
mitchan
twada
tajimathememer
jxmtst
murabayashi
lnit
sakurahigashi2
lhespanha
youtalk
kizuku_miyagi
mascii
jensimmons
malarkey
aleyda
jeffersonlam
philhawksworth
vanstee
lauravandoore
ddemaree
marcduiker
jcasabona
trishagee
bkeepers