Tag: Agentic API

  • Agentic API Is Growing Up: From Framework to Protocol, and the Language That Binds Them

    Agentic API Is Growing Up: From Framework to Protocol, and the Language That Binds Them

    A little over a year ago, Agentic API was a proposition: that AI agents need a different kind of API surface than the CRUD-shaped interfaces we’ve been shipping to human developers for two decades. The core argument was simple. When a language model reads POST /reservations, it has to reason its way across a semantic gap — from HTTP verb to business intent — that a human developer doesn’t even notice. When it reads BOOK /reservation, the gap closes. That’s a theoretical claim, and theoretical claims don’t win engineering debates.

    We now have the evidence, the specification, and the language. Here’s where things stand.

    Agentic API Is Now a Native Component of AGTP

    The Agentic API framework has been formally integrated into the Agent Transfer Protocol (AGTP) as one of its native components. This is more than a branding exercise — it’s an architectural commitment.

    AGTP is a dedicated application-layer protocol for AI agent traffic. It sits where HTTP sits today, but it’s designed from first principles around what agents actually do: express intent, declare authority scope, delegate, escalate, confirm, and collaborate. Where HTTP gives agents a vocabulary built for document retrieval (GET, POST, PUT, DELETE), AGTP gives them a vocabulary built for the work — a Tier 1 core of twelve intent methods (QUERY, SUMMARIZE, BOOK, SCHEDULE, LEARN, DELEGATE, COLLABORATE, CONFIRM, ESCALATE, NOTIFY, DESCRIBE, SUSPEND) extended by a Tier 2 standard vocabulary organized around the ACTION taxonomy: ACQUIRE, COMPUTE, TRANSACT, INTEGRATE, COMMUNICATE, and ORCHESTRATE.

    Integrating Agentic API natively into AGTP means the semantic method naming work is no longer a design pattern sitting next to a transport protocol. It is the transport protocol’s method vocabulary. Agent identity, authority scope, delegation chains, and attribution records are carried in the headers. The intent is carried in the method. The two are now one surface.

    AGIS: The Native Language of Agent Intent

    Alongside this integration, we’ll be announcing AGIS — Agent Intent Syntax — the native language that gives AGTP its expressive power.

    AGIS is the semantic verb vocabulary that expresses what an agent is trying to do in terms the agent actually reasons in. Where REST defines operations against resources, AGIS defines operations against intents. BOOK, FIND, ANALYZE, DELEGATE, ESCALATE are not method names in a style guide; they are a standardized, extensible vocabulary registered through an IANA-managed Method Registry, discoverable via DESCRIBE, and enforceable at the protocol layer.

    The practical significance of naming this language matters. It gives architects, platform teams, and protocol implementers a shared artifact to reason about. You don’t “use semantic verbs where appropriate.” You implement AGIS. That’s the shift.

    The Research Says It Out Loud

    At API Days New York, I’ll be presenting the full benchmark results behind all of this — the numbers that turned the theoretical argument into an engineering one.

    The headline: across 7,200 controlled trials spanning four model families and eighteen experimental conditions, semantic AGIS methods outperformed CRUD by 10 to 29 percentage points on every frontier model tested — Claude Sonnet 4.6, Grok-3, and GPT-4o — with aggregate statistical significance at z = 3.77, p < 0.001. Claude gained 29 points. Grok gained 18. GPT-4o gained 10.

    But the more interesting finding is the mechanism. We ran a description-swap ablation: what happens when you give a CRUD endpoint an agentic-style description, and vice versa? CRUD endpoints with agentic descriptions collapsed by 39 to 43 percentage points. Agentic endpoints with CRUD descriptions barely moved — Claude didn’t change at all (+1 pp, statistically indistinguishable from baseline). In other words, the method name itself carries enough intent signal to survive documentation noise. Generic HTTP verbs carry none, and cannot.

    There’s also a calibration finding that matters for anyone building governance into agent systems. Under description mismatch, confidence calibration error spikes by 60 to 67 percentage points — agents become dramatically overconfident precisely when they’re most likely to be wrong. Semantic naming partially mitigates this by anchoring confidence to a corroborating intent signal.

    And there’s a boundary condition worth naming clearly: the effect is entirely absent in Llama 3.2 at 3B parameters. This is capability-conditional. Below a certain scale, models cannot leverage semantic naming at all. The design pattern lives and dies with frontier-scale reasoning — which is exactly the scale at which agent systems are being deployed.

    Why This Moment Matters

    Protocols succeed when the ecosystem needs them and the evidence is in. AGTP is at that threshold now. Agent traffic is accelerating across enterprise, research, and consumer contexts. Infrastructure components cannot distinguish it from human traffic because the methods and headers look the same. Observability, governance, and safety work is being bolted onto HTTP in ways that don’t compose.

    Agentic API, now native to AGTP, and AGIS as its expressive vocabulary, is a cleaner path. The research makes the case that it also measurably performs better at the only task that matters: giving an agent a fair chance of picking the right endpoint for the user’s actual intent.

    I’ll be in New York for API Days to walk through all of this — the protocol integration, the AGIS announcement, and the full benchmark dataset. If you’re building agent systems, working on agent governance, or just trying to figure out what the next layer of the stack looks like, come find me there.

    The agent web is being built right now. It deserves a protocol, a language, and evidence. We’ve got all three.

  • Agentic API: White paper and Implementation Strategy

    Agentic API: White paper and Implementation Strategy

    A Task-Centric Framework for Scalable Agent Integrations

    In a world where APIs power everything from mobile apps to AI-driven automation, the need for smarter, more intuitive interfaces is clear. Traditional RESTful APIs, built around CRUD (Create, Read, Update, Delete) operations, often fall short in capturing the intent behind user actions. Enter AgenticAPI, a groundbreaking framework that redefines API design with action-oriented semantics, enabling developers to build APIs that are not just data-driven but purpose-driven. Whether you’re a developer, product manager, or AI enthusiast, AgenticAPI offers a fresh approach to creating APIs that agents and humans alike can understand and leverage.

    AgenticAPI, now at version 0.4.0, introduces the ACTION framework, which shifts the focus from manipulating data models to executing intent-driven tasks. Instead of POST /users or GET /orders, AgenticAPI uses custom HTTP methods like SUMMARIZE /document, FETCH /resource, NOTIFY /user, and CHECK /weather. These verbs—aligned with categories like Compute, Acquire, and Orchestrate—make APIs more expressive and aligned with real-world workflows. For instance, a CHECK /weather request retrieves a weather forecast for party planning, while SCHEDULE /event books a date based on guest availability and conditions. This semantic clarity empowers AI agents to reason about tasks, reducing reliance on brittle natural language prompts.

    The framework’s strength lies in its semantic discoverability. Using OpenAPI extensions (e.g., x-action, x-category), AgenticAPI endpoints are self-describing, allowing agents to dynamically query available actions and their constraints. A DISCOVER /actions endpoint, planned for future releases, will list methods like SUMMARIZE or NOTIFY with required scopes, making APIs machine-readable and agent-friendly. This aligns with the Agent Experience (AX), ensuring APIs are intuitive for both human developers and autonomous systems.

    Security is a cornerstone of AgenticAPI. Version 0.4.0 integrates OAuth2 with PKCE via Auth0, restricting access to authorized clients with granular scopes (e.g., summarize:read, weather:read). This ensures that sensitive actions, like sending notifications or checking account balances, are protected while maintaining compatibility with RESTful clients through aliased endpoints (e.g., POST /documentSUMMARIZE /document). Rate limiting further enhances reliability, capping requests to prevent abuse.

    AgenticAPI excels in orchestration, a critical feature for complex workflows. The /chain endpoint allows developers to sequence methods, such as checking weather, verifying guest availability, scheduling an event, and notifying attendees—all in one request. This capability, inspired by enterprise integration patterns, makes AgenticAPI ideal for scenarios like party planning or business process automation. The framework’s Pydantic schemas ensure type-safe, unambiguous payloads, while adaptive output formats (JSON, text) cater to diverse clients.

    To dive deeper into AgenticAPI’s vision and technical details, we invite you to download our white paper. The paper explores the ACTION framework’s principles—Contextual Alignment, Semantic Discoverability, Execution Clarity, and Intent Weighting—and provides a blueprint for implementing action-oriented APIs. It’s a must-read for anyone looking to build APIs that bridge human intent and machine execution.

    Ready to explore AgenticAPI hands-on? Check out our Proof of Concept (PoC) on GitHub at https://github.com/agenticapi. The PoC, built with FastAPI, demonstrates custom methods, OAuth2 security, and chaining workflows. Follow the README to set up the PoC locally, authenticate with Auth0, and test endpoints like SUMMARIZE /document or CHECK /weather. The repository includes sample data and a UI for interactive testing, making it easy to see AgenticAPI in action.

    AgenticAPI is more than a framework, it’s a vision for the future of APIs. By prioritizing intent, security, and orchestration, it empowers developers to create APIs that are smarter, safer, and more adaptable. Download the white paper and explore the PoC today to join the movement toward action-oriented APIs. Let’s build the next generation of intelligent, agent-ready interfaces together!

  • Introducing Agentic API: A Task-Centric Revolution in API Design

    Introducing Agentic API: A Task-Centric Revolution in API Design

    In the rapidly evolving landscape of AI-driven automation, traditional APIs are struggling to keep pace with the demands of intelligent agents. The Agentic API framework offers a groundbreaking solution by reimagining APIs as task-oriented interfaces. Unlike conventional APIs rooted in CRUD (Create, Read, Update, Delete) operations, Agentic API prioritizes actionable intent, enabling AI agents to execute complex tasks with precision and efficiency. This blog post introduces the core concepts of Agentic API and its transformative potential for enterprise systems.

    The Limitations of Traditional APIs

    Traditional APIs, built on REST and CRUD, were designed for human developers and data-centric applications. They excel at exposing resources like /users or /orders but fall short when AI agents need to perform goal-oriented tasks such as “book a meeting” or “summarize a report.” These APIs lack semantic clarity, forcing agents to infer intent from vague endpoints, navigate undocumented side effects, and chain multiple calls to achieve a single objective. This mismatch creates integration bottlenecks, increasing complexity and fragility in agent-driven workflows.

    Hood’s white paper highlights that protocols like Model Context Protocol (MCP) or Agent-to-Agent (A2A) frameworks attempt to address these issues through inter-agent coordination. However, they introduce unnecessary overhead without solving the root problem: APIs that fail to express task intent. AgenticAPI takes a different approach, focusing on enhancing the API layer itself to support seamless agent interactions.

    The ACTION Framework: A New Vocabulary for APIs

    At the heart of AgenticAPI lies the ACTION taxonomy, a structured set of task categories—Acquire, Compute, Transact, Integrate, Orchestrate, and Notify. These categories replace CRUD’s data-focused operations with a verb-driven model that aligns with real-world tasks. For example:

    • Acquire: Retrieve data with intent, e.g., SEARCH /orders or EXTRACT /document.
    • Compute: Transform data, e.g., SUMMARIZE /report or VALIDATE /input.
    • Transact: Execute state-changing actions, e.g., BOOK /meeting or PURCHASE /item.
    • Integrate: Synchronize systems, e.g., SYNC /records.
    • Orchestrate: Manage workflows, e.g., SCHEDULE /task or CHAIN /actions.
    • Notify: Communicate updates, e.g., NOTIFY /user.

    Each category includes specific verbs that convey clear intent, making APIs machine-readable and discoverable. This taxonomy enables agents to understand what a system can do, under what conditions, and with what outcomes, reducing reliance on external documentation or brittle logic.

    Key Features of AgenticAPI

    AgenticAPI extends existing standards like OpenAPI to embed intent and context directly into the API surface. Key features include:

    • Semantic Discoverability: Agents can query endpoints like DISCOVER /actions to identify available capabilities dynamically.
    • Contextual Execution: APIs include metadata on preconditions, side effects, and intent weighting (e.g., priority or cost), enabling agents to make informed decisions.
    • Adaptive Outputs: Responses support multiple formats—JSON, text, or code—tailored to the agent’s needs.
    • Task-First Authentication: OAuth 2.0 scopes align with specific actions (e.g., scope: book_meeting), ensuring secure, granular access.
    • Workflow Orchestration: Verbs like CHAIN or RETRY support complex, multi-step tasks without external coordination.

    These features make AgenticAPI ideal for industries like finance, healthcare, and logistics, where precise, scalable automation is critical.

    Why Agentic API Matters

    By shifting from resource manipulation to task execution, Agentic API simplifies integration, enhances interoperability, and reduces errors. It eliminates the need for protocol layers like MCP, offering a direct, API-native solution that leverages existing infrastructure. Organizations adopting AgenticAPI can expect shorter development cycles, lower integration friction, and more reliable automation, as agents operate with clear intent and predictable outcomes.

    A proof-of-concept outlined in the white paper demonstrates Agentic API’s efficacy in tasks like booking meetings, showing reduced error rates and improved scalability. As AI agents become ubiquitous, AgenticAPI positions organizations to build resilient, intelligent systems that scale effortlessly.

    The Future of Integration

    Agentic API is more than a framework, it’s a paradigm shift toward intent-driven integration. By transforming APIs into capability surfaces, it lays the foundation for action registries, domain-specific verb libraries, and advanced developer tools. As Hood concludes, “The most valuable APIs will be those that enable execution.” For businesses aiming to harness AI at scale, Agentic API is the blueprint for a future where systems don’t just share data, they act.