agentic-rollout

Assess, integrate, and validate external agents for Relax resident Agentic rollout.

585|144|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/redai-infra/Relax --skill agentic-rollout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentic-rollout
Source: https://github.com/redai-infra/Relax/tree/main/skills/agentic-rollout
Command: npx skills add https://github.com/redai-infra/Relax --skill agentic-rollout

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Connecting an external agent application to the Relax RL framework risks corrupting model-visible context, breaking export and credit semantics, or deadlocking on capacity limits. This Skill provides a staged workflow to assess an agent, bridge it into Relax with --use-agentic-rollout, verify launch readiness, and demonstrate a working resident Agentic rollout with evidence.

Core Features & Use Cases

  • Staged integration workflow: Four stages (Assess, Bridge, Check, Demonstrate) route the user based on their current state, with explicit readiness verdicts and blocking unknowns at each gate.
  • Context and contract audits: Audits model-visible message linearity, reasoning/tool-call parser compatibility, SessionForest export semantics, and the Relax Chat Completions API contract before launch.
  • Capacity and scale verification: Calculates required external executor slots for train/Eval overlap and conditionally inspects fixed internal concurrency widths for large-scale rollouts.
  • Use Case: Before launching a multi-turn SWE agent training run, use this Skill to verify the agent's wire payloads are linear, the Relax-facing client timeout survives prelaunch holds, external sandbox slots satisfy the computed requirement, and one full Group reaches the optimizer step.

Quick Start

Assess my agent at examples/my_agent/ for integration with Relax agentic rollout and tell me whether it is ready to bridge.

Frequently Asked Questions about agentic-rollout

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect an external agent to Relax agentic rollout?

Enable resident Agentic rollout with --use-agentic-rollout, --agent-command, and --agent-cwd, then wire the agent to the injected RELAX_BASE_URL and RELAX_SESSION_ID environment variables. The agent sends complete normalized messages with stable tools and chat_template_kwargs on every Chat Completions request.

How do I check if my agent is ready to launch an Agentic rollout?

Run the Stage C pre-launch check: resolve effective Agentic parameters after defaults, audit context linearity from wire payloads, verify external executor slot capacity, and confirm the Relax-facing client timeout covers prelaunch and partial-rollout holds. The verdict is PASS, UNSAFE, or UNVERIFIED.

Does Relax agentic rollout support custom generate functions?

No. Choosing --use-agentic-rollout gives the Agentic layer ownership of train and Eval generation, and any configured --custom-generate-function-path is ignored. Use the legacy custom-generate path instead when Relax-side code must own the model/tool loop.

Why does my agentic rollout hang before the first request?

A common cause is external executor slot exhaustion: incomplete multi-Session Groups never reach the all-Session first-request barrier. The signal is warming_prepare_group_count above zero with unchanged resident counts and recurring idle_heartbeat, requiring agent or platform cancellation to break.

When is explicit export required instead of implicit export?

Explicit export is required for any nonlinear history: intentional forks, multiple agents, deleted reasoning content, or changing tools between turns. Implicit export is reserved for audited strictly linear histories, and multiple exported contexts require --agentic-custom-advantage-path plus dynamic batching.

What is the difference between --agent-timeout and the client request timeout?

The Relax-facing client timeout applies to each individual Chat Completions request and must span prelaunch, partial-rollout, and fully-async holds. --agent-timeout is a separate active-time budget that terminates a stuck agent process and does not extend any request deadline.