🧬 AgentSpec Definitions

Details
This page shows version v0.0.0 (dev). The current version can be found here.

The Oracle AI Optimizer and Toolkit (the AI Optimizer) exposes portable AgentSpec definitions that describe agent pipelines as serializable JSON. These definitions can be inspected in the GUI, customized, and loaded into any compatible runtime.

Built-in Specifications

The AI Optimizer provides three built-in AgentSpec definitions:

NameTypeDescription
llm_onlyAgentLLM-only conversational agent with no tools
nl2sql_agentAgentNL2SQL agent with dynamic MCP tool discovery
vecsearch_flowFlowRAG pipeline: rephrase, retrieve, grade, answer

Viewing Specifications

Navigate to the Configuration page and select the AgentSpec tab.

Each specification is listed with its name and description. Click the Details button to view the full serialized JSON definition. This JSON represents the complete AgentSpec that is built from the current sample configuration and can be used as a starting point for custom agent definitions.

REST API

AgentSpec definitions are also available via the REST API:

  • GET /v1/agentspec/specs — List all available specifications
  • GET /v1/agentspec/specs/{name} — Get a specific specification by name

For more information on the agent architecture and how these specifications are used at runtime, see the Agents documentation.