Agentic AI Reference Architecture

Tools & Integration · Software component

REST API Adapter

Software componentTools & IntegrationOrchestration & Toolsarc:RESTAPIAdapter

A tool adapter that calls third-party services through HTTP REST or GraphQL endpoints.

Responsibility. Integrates tools with third-party HTTP APIs.

Also known as: API Gateway pattern, Third-party API connector, CRM native function

Variant of Tool Integration Adapter abstract

When to choose. Choose for synchronous CRUD operations and cloud-service integration; the most common mechanism.

reads; writesis invoked byinvokesspecializesis target of alternativeToalternative tois target of alternativeTois configured byTool Result Cache: reads; writesTool Result CacheTool Executor: is invoked byTool ExecutorExternal Service API: invokesExternal Service APITool Integration Adapter: specializesTool Integration AdapterDatabase Connector: is target of alternativeToDatabase ConnectorWebhook Receiver: alternative toWebhook ReceiverMessage Queue Adapter: is target of alternativeToMessage Queue AdapterAPI Description Document: is configured byAPI Description Document
Direct neighbourhood (hover for relationship types)

Relationships

is configured by structural

invokes dependency

is invoked by dependency

reads dependency

writes dependency

alternative to variability

Classification

Patterns
API Gateway pattern
Technologies
RESTGraphQL
Quality attributes
Compatibility (ISO/IEC 25010)

Sources

  1. Ch1.2: T. Nguyen, "Core Agent Patterns," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 1.2. ISBN: 9798244538229.
  2. Ch2.5: T. Nguyen, "Semantic Kernel," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 2.5. ISBN: 9798244538229.
  3. Ch2.6: T. Nguyen, "Tool Integration and Function Calling," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 2.6. ISBN: 9798244538229.
  4. Ch3.10: T. Nguyen, "Efficiency Metrics," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 3.10. ISBN: 9798244538229.
  5. Ch8.1: T. Nguyen, "Latency Metrics," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 8.1. ISBN: 9798244538229.