Agentic AI Reference Architecture

Tools & Integration · Data artifact

API Description Document

Data artifactTools & IntegrationOrchestration & Toolsarc:APIDescriptionDocument

A machine-readable REST API description specifying operations, HTTP methods, paths, parameters, request and per-status-code response schemas, and authentication requirements.

Responsibility. Describes an external API completely enough for tools to be derived and invoked automatically.

Also known as: OpenAPI specification, OpenAPI spec

configuresis read byREST API Adapter: configuresREST API AdapterTool Schema Generator: is read byTool Schema Generator
Direct neighbourhood (hover for relationship types)

Relationships

configures structural

is read by dependency

Classification

Technologies
OpenAPI 3.0+AWS BedrockGoogle Vertex AIAzure AI Foundry
Quality attributes
Compatibility (ISO/IEC 25010)Maintainability (ISO/IEC 25010)
Frameworks & regulations
OpenAPI Specification 3.0+

Sources

  1. 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.