> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# Adaptive

> Configure the built-in Adaptive plugin for measured runtime tuning.

Use the Adaptive plugin when you want NeMo Relay to collect runtime signals and
activate measured adaptive behavior through the shared plugin system.

Adaptive is a first-party plugin component with kind `adaptive`. It uses the
same runtime model as the rest of NeMo Relay: scopes and managed calls emit
lifecycle events, subscribers and learners observe those events, intercepts can
add guidance, and plugin configuration controls what is active.

The plugin can coordinate:

* Adaptive state for learned runtime signals.
* Telemetry subscribers for adaptive learners.
* Adaptive hints injected into outgoing model requests.
* Tool-parallelism observation or scheduling behavior.
* Adaptive Cache Governor (ACG) prompt-cache planning.
* Component-local validation policy.

## Use Adaptive When

Adaptive is useful when an agent workflow repeats similar work and you want to
observe or tune behavior without hard-coding tuning logic into every
application.

Start here when you need to:

* Collect runtime signals before changing behavior.
* Add model-request hints in a controlled way.
* Plan prompt-cache breakpoints for supported providers.
* Evaluate tool parallelism opportunities.
* Share adaptive state across workers when needed.
* Roll out measured tuning as a configuration change.

If instrumentation is not in place yet, start with
[Instrument Applications](/instrument-applications/about) or
[Integrate into Frameworks](/integrate-into-frameworks/about).

## Pages

* [Adaptive Configuration](/configure-plugins/adaptive/configuration) documents the full plugin
  component shape, validation, activation, teardown, and whole-plugin settings.
* [ACG](/configure-plugins/adaptive/acg) explains Adaptive Cache Governor configuration and what prompt
  cache planning accomplishes.
* [Adaptive Hints](/configure-plugins/adaptive/adaptive-hints) explains request hint injection and how
  downstream model paths can consume the hints.

State, telemetry, tool parallelism, and policy are whole-plugin configuration
areas. They are documented on [Adaptive Configuration](/configure-plugins/adaptive/configuration) rather
than as separate area pages.