diff --git a/modules/terms/partials/ai-agent.adoc b/modules/terms/partials/ai-agent.adoc index d9675709da..cc06428ac6 100644 --- a/modules/terms/partials/ai-agent.adoc +++ b/modules/terms/partials/ai-agent.adoc @@ -1,6 +1,6 @@ === AI agent :term-name: AI agent -:hover-text: An autonomous program that uses AI models to interpret requests, make decisions, and interact with tools and data sources. +:hover-text: A system built around a large language model (LLM) that interprets user intent, selects the right tools, and chains multiple steps into a workflow. :category: Agentic Data Plane AI agents can understand natural language instructions, reason about tasks, invoke tools through MCP servers, and coordinate multiple operations to accomplish complex workflows. diff --git a/modules/terms/partials/byoa.adoc b/modules/terms/partials/byoa.adoc new file mode 100644 index 0000000000..7b437fce67 --- /dev/null +++ b/modules/terms/partials/byoa.adoc @@ -0,0 +1,4 @@ +=== BYOA +:term-name: BYOA +:hover-text: Bring Your Own Agent (BYOA) is an agent you build and run yourself, in your own runtime and language. You register it with ADP for governance and observability. ADP tracks and attributes its telemetry and cost but does not host or proxy it. +:category: Agentic Data Plane diff --git a/modules/terms/partials/declarative-agent.adoc b/modules/terms/partials/declarative-agent.adoc new file mode 100644 index 0000000000..ad9e31e87c --- /dev/null +++ b/modules/terms/partials/declarative-agent.adoc @@ -0,0 +1,4 @@ +=== declarative agent +:term-name: declarative agent +:hover-text: An AI agent that runs in Redpanda's managed runtime, where you configure its behavior (LLM, system prompt, and attached tools) instead of writing agent code. Contrast with a BYOA agent, which you build and run in your own runtime. +:category: Agentic Data Plane diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc new file mode 100644 index 0000000000..d65616e9a1 --- /dev/null +++ b/modules/terms/partials/governance-dashboard.adoc @@ -0,0 +1,4 @@ +=== governance dashboard +:term-name: governance dashboard +:hover-text: Cross-tenant overview for platform and finance teams showing agent activity, spending, MCP server inventory, and authorization events. It brings AI Gateway usage and agent inventory into one view, down to per-provider spending and the authorization decisions that gate each tool invocation. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-client.adoc b/modules/terms/partials/oauth-client.adoc new file mode 100644 index 0000000000..c87479dee9 --- /dev/null +++ b/modules/terms/partials/oauth-client.adoc @@ -0,0 +1,4 @@ +=== OAuth client +:term-name: OAuth client +:hover-text: An ADP resource that governs inbound authentication: an external app (Claude Desktop, ChatGPT, Copilot Studio) authenticating to AI Gateway so the app's users can invoke MCP tools. Separate from an OAuth provider, which governs outbound authentication. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-connection.adoc b/modules/terms/partials/oauth-connection.adoc new file mode 100644 index 0000000000..49247cc9f3 --- /dev/null +++ b/modules/terms/partials/oauth-connection.adoc @@ -0,0 +1,4 @@ +=== OAuth connection +:term-name: OAuth connection +:hover-text: A stored authorization that links a user to a third-party provider, created when the user completes the OAuth consent flow. OAuth connections hold access and refresh tokens in the token vault for agents to use on the user's behalf. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-provider.adoc b/modules/terms/partials/oauth-provider.adoc new file mode 100644 index 0000000000..e6e13e9591 --- /dev/null +++ b/modules/terms/partials/oauth-provider.adoc @@ -0,0 +1,4 @@ +=== OAuth provider +:term-name: OAuth provider +:hover-text: An ADP resource that governs outbound authentication: AI Gateway authenticating to an upstream system (GitHub, Slack, Salesforce, and so on) on a user's behalf so MCP servers can call it. Separate from an OAuth client, which governs inbound authentication. +:category: Agentic Data Plane diff --git a/modules/terms/partials/resource.adoc b/modules/terms/partials/resource.adoc new file mode 100644 index 0000000000..ea010e9cc9 --- /dev/null +++ b/modules/terms/partials/resource.adoc @@ -0,0 +1,4 @@ +=== resource +:term-name: resource +:hover-text: Read-only data that an MCP server exposes and agents can fetch by URI. Resources provide file contents, database rows, or API responses without performing side effects. +:category: Agentic Data Plane diff --git a/modules/terms/partials/spending-event.adoc b/modules/terms/partials/spending-event.adoc new file mode 100644 index 0000000000..50d7fdbe5d --- /dev/null +++ b/modules/terms/partials/spending-event.adoc @@ -0,0 +1,4 @@ +=== spending event +:term-name: spending event +:hover-text: A record produced by the AI Gateway for every LLM call. Each event captures input, output, and cached token counts, the total cost in microcents, request count, and the provider, model, user, and organization context that the call ran under. +:category: Agentic Data Plane diff --git a/modules/terms/partials/token-vault.adoc b/modules/terms/partials/token-vault.adoc new file mode 100644 index 0000000000..0b6f4e12bd --- /dev/null +++ b/modules/terms/partials/token-vault.adoc @@ -0,0 +1,4 @@ +=== token vault +:term-name: token vault +:hover-text: Encrypted per-user store for the OAuth access and refresh tokens used to access third-party providers. Redpanda injects a user's token at call time and refreshes it automatically; connections persist until the user revokes them. +:category: Agentic Data Plane diff --git a/modules/terms/partials/tool.adoc b/modules/terms/partials/tool.adoc new file mode 100644 index 0000000000..539efd330e --- /dev/null +++ b/modules/terms/partials/tool.adoc @@ -0,0 +1,4 @@ +=== tool +:term-name: tool +:hover-text: A capability exposed by an MCP server that an AI agent can discover at runtime and invoke through structured JSON-RPC calls. Tools encapsulate operations such as querying a database, calling an API, or sending a message. +:category: Agentic Data Plane