> 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 full documentation content, see https://docs.nvidia.com/nemo/relay/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# Adaptive

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](/adaptive-plugin/configuration) documents the full plugin
  component shape, validation, activation, teardown, and whole-plugin settings.
* [ACG](/adaptive-plugin/acg) explains Adaptive Cache Governor configuration and what prompt
  cache planning accomplishes.
* [Adaptive Hints](/adaptive-plugin/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](/adaptive-plugin/configuration) rather
than as separate area pages.