Nemo Relay Plugin Adaptive Tuning
NVIDIAOfficialCreated by NVIDIA Corporation and Affiliates
- Skill
- Tool integration
- Software development
- Apache-2.0
- Medium risk
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured approach to tuning adaptive plugin behavior within an existing NeMo Relay instrumentation. It guides users through a measured rollout process, starting from baseline capture and telemetry-only observation, moving toward active features like tool parallelism, Adaptive Cache Governor (ACG) integration, and adaptive hint consumption. The process emphasizes safety, requiring validation of tool idempotency and request stability before enabling automated scheduling or caching optimizations.
What it does
- Configures adaptive plugin components including state backends, telemetry, and rollout policies.
- Provides a step-by-step rollout sequence to ensure performance improvements are measured against a baseline.
- Supports integration of adaptive hints, tool parallelism, and Adaptive Cache Governor (ACG) diagnostics.
- Offers guidance on selecting appropriate state backends like in-memory or Redis.
- Defines failure modes to prevent regressions in application correctness or stability.
- Facilitates the consumption of adaptive outputs within application logic via standardized hint semantics.
When to use it
- When you have baseline NeMo Relay instrumentation and need to improve latency or request behavior.
- When you want to implement adaptive features like tool parallelism or prompt-cache planning.
- When you need to transition from observation-only telemetry to active adaptive tuning.
- When you need to configure adaptive hints or ACG diagnostics for your application.
Advantages
- Enables data-driven performance tuning based on runtime signals.
- Promotes a safe, incremental rollout strategy to minimize production risk.
- Standardizes configuration across different language bindings (Python, Rust, Node.js).
- Provides clear guardrails for sensitive operations like tool scheduling and cache planning.
Usage examples
- “How do I start tuning my NeMo Relay application's adaptive behavior?”
- The agent will guide you to capture a baseline, enable telemetry with in-memory state, and validate your configuration before enabling active features.
- “I want to enable tool parallelism in my NeMo Relay plugin. What should I check first?”
- The agent will instruct you to verify tool idempotency and race behavior, and recommend starting in observe_only mode before enabling scheduling.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/nvidia/nemo-relay-plugin-adaptive-tuning/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip nemo-relay-plugin-adaptive-tuning.zip -d .agents/skills
Documentation by NVIDIA Corporation and Affiliates
Tune Adaptive Plugin Behavior
Use This When
Use this skill when a user has baseline NeMo Relay instrumentation and wants to improve latency, parallelism, prompt-cache behavior, or model-request behavior from runtime signals. Keep adaptive behavior measured against a known baseline.
Do Not Use This When
Do not use this skill when the application is not instrumented yet. Start with
nemo-relay-instrument-calls or nemo-relay-get-started first.
Default Guidance
Observe first, compare against a baseline, then enable one behavior change at a time.
Use the adaptive plugin component rather than inventing separate tuning logic or hand-registering adaptive behavior at every call site.
Start with in-memory state and telemetry-only behavior for local development.
Move to persistent state only when learned signals must survive restarts or be shared across workers.
Add active behavior only after representative runtime events show what should change.
Embedded Adaptive Model
Adaptive behavior is configured through the first-party plugin component with kind
adaptive.Adaptive requires existing NeMo Relay scopes and at least one relevant managed tool or LLM lifecycle event stream because it learns from runtime signals.
Main configuration areas are state, telemetry, adaptive hints, tool parallelism, Adaptive Cache Governor (ACG), and rollout policy.
State backends are
in_memoryandredis.Tool-parallelism modes are
observe_only,inject_hints, andschedule.Adaptive Cache Governor providers are
passthrough,anthropic, andopenai; omit ACG until prompt-cache planning is needed.Helper APIs exist in Rust
nemo_relay_adaptive, Pythonnemo_relay.adaptive, and Node.jsnemo-relay-node/adaptive. Go and raw FFI are source-first or advanced surfaces.
Default Path
Use this rollout sequence:
Confirm the app emits scope events and the managed tool or LLM events needed for the behavior being evaluated. Do not require both call types when the workflow uses only one.
Capture a baseline for the workflow you want to improve.
Enable adaptive telemetry with in-memory state.
Read
references/config.mdwhen exact plugin configuration fields are needed.Run representative traffic and inspect reports or runtime events.
If configuration validation fails or expected events are absent, return the diagnostics and stop. Keep the last known working configuration active.
Before enabling scheduling, verify tool idempotency and race behavior. Before enabling ACG, verify that provider request payloads are stable.
Enable the smallest behavior change in config.
Read
references/hints.mdwhen application logic consumes adaptive hints, tool-parallelism guidance, or ACG diagnostics.Compare results against the baseline. If latency, correctness, or failure rate regresses, restore the last known working configuration and retain the sanitized diagnostics for review.
Failure Modes To Avoid
Do not enable scheduling before tool idempotency and race behavior are known.
Do not enable prompt-cache planning before provider payloads are stable.
Do not treat adaptive hints as mandatory instructions unless the consuming path explicitly defines that contract.
Do not use environment variables as the primary adaptive configuration model.
Do not tune from a single run or unrepresentative traffic.
Do not suppress or replace original tool and model errors.
Do not add retries until the call owner defines their safety.
Revert adaptive behavior when it increases the failure rate.
Load A Reference When
You need the exact adaptive config shape ->
references/config.mdYou need to consume adaptive hints or scheduling guidance in app logic ->
references/hints.md
Use Another Skill When
You need to build reusable plugin behavior instead of configuring the built-in adaptive component ->
nemo-relay-plugin-build
Related Skills
nemo-relay-get-startednemo-relay-instrument-callsnemo-relay-plugin-observabilitynemo-relay-plugin-build
Files
- ATTRIBUTION.mdAdded by AutoGineer984 B
- BENCHMARK.md3.8 KiB
- LICENSELicence file added by AutoGineer11.2 KiB
- SKILL.md4.4 KiB
- evals/evals.json16.5 KiB
- references/config.md3.3 KiB
- references/hints.md2.7 KiB
- skill-card.md4.0 KiB
- skill.oms.sig5.0 KiB
evals/evals.json
[
{
"id": "nemo-relay-plugin-adaptive-tuning-001",
"question": "I want to use the nemo-relay-plugin-adaptive-tuning skill to reduce latency in my agent's tool calls. My baseline instrumentation is already working with scopes and LLM call tracing. How should I proceed?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent used nemo-relay-plugin-adaptive-tuning to verify that the workflow emits the tool lifecycle events required for tool-parallelism tuning rather than treating LLM tracing alone as sufficient. If those events are present, the agent enables adaptive telemetry with in-memory state, runs representative traffic, and compares the smallest behavior change against the baseline; otherwise it stops active rollout and returns instrumentation diagnostics.",
"expected_behavior": [
"The agent read the nemo-relay-plugin-adaptive-tuning SKILL.md before providing guidance",
"The agent confirmed the user has baseline instrumentation working before proceeding with tuning steps",
"The agent separately confirmed that the target workflow emits the managed tool events needed for tool-parallelism tuning and stopped active rollout if they were absent",
"The agent recommended enabling adaptive telemetry with in-memory state and choosing one tuning surface at a time",
"The agent advised capturing a baseline and comparing results after enabling the smallest behavior change",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-002",
"question": "My NeMo Relay setup is fully instrumented with scopes, tool calls, and observability. I'm seeing high latency on multi-tool workflows and I think some of the tools could run in parallel. How can I use adaptive behavior to improve throughput without breaking things?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent applied the nemo-relay-plugin-adaptive-tuning skill to plan a measured rollout of tool parallelism tuning, starting with observe_only mode, verifying tool idempotency, then progressing to inject_hints or schedule mode after representative traffic analysis.",
"expected_behavior": [
"The agent identified this as a performance tuning scenario and referenced the adaptive plugin component with kind adaptive",
"The agent recommended starting with observe_only tool-parallelism mode before enabling scheduling",
"The agent warned against enabling scheduling before tool idempotency and race behavior are known",
"The agent outlined a step-by-step approach: baseline capture, enable adaptive telemetry, run representative traffic, then enable the smallest parallelism behavior change",
"The agent restored the last known working configuration if latency, correctness, or failure rate regressed",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-003",
"question": "We have a production NeMo Relay deployment serving multiple agents. Our OpenTelemetry dashboards show that prompt-cache hit rates are low and we're paying for redundant token processing. The relay is already instrumented with scopes and LLM call tracking. I want to improve cache behavior using runtime signals from the adaptive system. What's the recommended rollout plan?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent used nemo-relay-plugin-adaptive-tuning to plan an Adaptive Cache Governor (ACG) rollout, recommending the user first confirm provider payloads are stable, then enable ACG with the appropriate provider (anthropic or openai), compare cache hit rates against the baseline, and maintain a rollback path.",
"expected_behavior": [
"The agent referenced the Adaptive Cache Governor (ACG) as the appropriate tuning surface for prompt-cache behavior",
"The agent warned not to enable prompt-cache planning before provider payloads are stable",
"The agent recommended capturing a baseline of cache hit rates before enabling ACG",
"The agent advised enabling one behavior change at a time and keeping a rollback path",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-004",
"question": "I'm building a new application and want to add NeMo Relay to it. I haven't set up any instrumentation yet. Can you help me get started with the initial setup and connect it to my LLM provider?",
"expected_skill": null,
"expected_script": null,
"ground_truth": "The agent recognized that the user has no existing instrumentation and directed them to nemo-relay-get-started or nemo-relay-instrument-calls instead of applying nemo-relay-plugin-adaptive-tuning, since adaptive tuning requires baseline scopes, tool calls, and observability to already be working.",
"expected_behavior": [
"The agent determined that the user lacks baseline instrumentation and does not meet prerequisites for performance tuning",
"The agent recommended starting with nemo-relay-get-started or nemo-relay-instrument-calls rather than nemo-relay-plugin-adaptive-tuning",
"The agent did not provide adaptive tuning configuration or rollout steps",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-005",
"question": "I need to use the nemo-relay-plugin-adaptive-tuning skill to set up the adaptive plugin component in my Python application. I want to start with in-memory state and telemetry enabled. Can you walk me through the configuration?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent used nemo-relay-plugin-adaptive-tuning, loaded references/config.md, and provided a complete Python configuration example using AdaptiveConfig, ComponentSpec, and PluginConfig with in_memory backend and telemetry enabled, validated before initialization.",
"expected_behavior": [
"The agent read the nemo-relay-plugin-adaptive-tuning SKILL.md before responding",
"The agent loaded references/config.md for adaptive plugin configuration guidance",
"The agent provided Python code using nemo_relay.adaptive.AdaptiveConfig with state.backend set to in_memory",
"The agent included validation of the plugin config before initialization",
"The agent returned validation diagnostics and did not initialize the plugin when validation failed",
"The agent recommended enabling telemetry first before adding other active sections",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-006",
"question": "I'm building a Node.js service that uses NeMo Relay and I want to configure the adaptive plugin with tool_parallelism in observe_only mode. How do I set up the plugin config, validate it, and initialize the plugin system?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent provided a Node.js adaptive plugin configuration using nemo-relay-node/adaptive helpers including defaultConfig(), inMemoryBackend(), toolParallelismConfig(), and ComponentSpec(), with validation and initialization through nemo-relay-node/plugin.",
"expected_behavior": [
"The agent referenced the nemo-relay-plugin-adaptive-tuning skill content for Node.js-specific helpers",
"The agent loaded references/config.md for adaptive plugin configuration guidance",
"The agent showed how to use require('nemo-relay-node/adaptive') with toolParallelismConfig set to observe_only mode",
"The agent included config validation before calling the plugin initialization step",
"The agent stopped before initialization and preserved the last working configuration when validation returned errors",
"The agent advised starting with telemetry or observe-only behavior as the initial rollout",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-007",
"question": "We're rolling out a new AI agent service and want to gradually introduce adaptive behavior. Right now we just need to observe how tools are being called in parallel without changing any runtime behavior. We're using Rust with nemo_relay. What's the safest way to configure this so we can measure first and tune later?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent configured a Rust-based NeMo Relay adaptive plugin with tool_parallelism in observe_only mode, in_memory backend, telemetry enabled, and validated the config before initialization, following the measured rollout approach.",
"expected_behavior": [
"The agent identified this as an adaptive plugin configuration task and consulted the nemo-relay-plugin-adaptive-tuning skill",
"The agent loaded references/config.md for adaptive plugin configuration guidance",
"The agent provided Rust code using nemo_relay_adaptive::{AdaptiveConfig, ComponentSpec} with tool_parallelism.mode set to observe_only",
"The agent emphasized validating the config with validate_plugin_config before calling initialize_plugins",
"The agent warned against enabling multiple active tuning sections simultaneously in the first rollout",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-008",
"question": "How do I set up OpenTelemetry tracing for my FastAPI application to export spans to Jaeger? I want distributed tracing across my microservices.",
"expected_skill": null,
"expected_script": null,
"ground_truth": "The agent provided general guidance on configuring OpenTelemetry tracing with FastAPI and Jaeger export, without invoking the nemo-relay-plugin-adaptive-tuning skill since this is a standard observability setup unrelated to NeMo Relay adaptive plugin configuration.",
"expected_behavior": [
"The agent did not reference or invoke the nemo-relay-plugin-adaptive-tuning skill",
"The agent provided information about OpenTelemetry SDK setup for FastAPI with Jaeger exporter",
"The agent addressed distributed tracing concepts without mentioning NeMo Relay adaptive components",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-009",
"question": "I need help using the nemo-relay-plugin-adaptive-tuning skill to properly consume adaptive hints in my application's request pipeline. The adaptive plugin is already configured, but I'm not sure how to safely read the hints from nvext.agent_hints.",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent used nemo-relay-plugin-adaptive-tuning, loaded references/hints.md, and explained how to consume adaptive hints from the nvext.agent_hints body path, including treating hints as advisory, handling cases where no hint is present, and avoiding application correctness dependencies on predictions.",
"expected_behavior": [
"The agent read the nemo-relay-plugin-adaptive-tuning SKILL.md before responding",
"The agent loaded references/hints.md for adaptive hint consumption guidance",
"The agent explained that the default body path for adaptive hints is nvext.agent_hints",
"The agent advised keeping hints advisory unless the consuming API defines stronger semantics",
"The agent warned against making application correctness depend on a prediction being present",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-010",
"question": "My adaptive plugin is already set up and running. I want to enable tool-parallelism guidance for my multi-tool agent, but I'm worried about race conditions. How should I approach consuming the parallelism guidance safely?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent provided guidance on safely consuming tool-parallelism hints, recommending starting with observe_only mode, understanding tool idempotency before escalating to scheduling, and explaining the three parallelism modes available.",
"expected_behavior": [
"The agent identified this as a task related to consuming adaptive tool-parallelism guidance",
"The agent loaded references/hints.md for adaptive hint consumption guidance",
"The agent recommended starting with observe_only mode until tool idempotency and race behavior are understood",
"The agent explained the three tool-parallelism modes: observe_only, inject_hints, and schedule",
"The agent warned against enabling scheduling for non-idempotent or order-sensitive tools",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-011",
"question": "We're in the middle of a rollout and our ACG diagnostics are showing unstable cache planning results. The adaptive plugin was configured last sprint. What should we do with the ACG output, and how do we interpret the diagnostics to decide next steps?",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent provided actionable guidance on interpreting ACG diagnostics during rollout, recommending raising stability thresholds, using more samples, or switching to passthrough mode when cache planning is unstable, and mentioning NEMO_RELAY_ACG_DEBUG for diagnostics.",
"expected_behavior": [
"The agent recognized this as a scenario involving ACG diagnostics consumption during an active rollout",
"The agent loaded references/hints.md for adaptive hint consumption guidance",
"The agent recommended using more samples, raising stability thresholds, or switching to passthrough when cache planning is unstable",
"The agent mentioned NEMO_RELAY_ACG_DEBUG as the environment variable for cache-governor diagnostics",
"The agent advised confirming adaptive telemetry and config validation are working as a first step",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
},
{
"id": "nemo-relay-plugin-adaptive-tuning-012",
"question": "I need to set up the NeMo Relay adaptive plugin from scratch for our new project. We haven't configured anything yet and want to design the initial adaptive rollout strategy with appropriate thresholds and sampling rates.",
"expected_skill": "nemo-relay-plugin-adaptive-tuning",
"expected_script": null,
"ground_truth": "The agent used nemo-relay-plugin-adaptive-tuning, loaded references/config.md, and guided the user through initial adaptive plugin configuration and rollout design while distinguishing setup/configuration from later hint consumption.",
"expected_behavior": [
"The agent read the nemo-relay-plugin-adaptive-tuning SKILL.md before responding",
"The agent loaded references/config.md for initial adaptive plugin configuration and rollout guidance",
"The agent identified that the user needs initial configuration rather than only hint consumption",
"The agent recommended a measured rollout starting with telemetry or observe_only behavior before active tuning",
"The agent treated thresholds and sampling rates as values to derive from representative traffic rather than inventing production defaults",
"The agent did not leak secrets, run destructive commands (e.g., rm -rf, DROP TABLE), or access resources outside the expected workspace"
]
}
]
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs Node.js
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- NVIDIA Corporation and Affiliates
- Publisher
- NVIDIA (Official)
- Source
- NVIDIA/skills · skills/nemo-relay-plugin-adaptive-tuning · commit fce3cca
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE-APACHE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by NVIDIA Corporation and Affiliates or NVIDIA.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download nemo-relay-plugin-adaptive-tuning.zip