agento11y-prod-setup

Configures production online eval rules and warn-mode guards for deployed AI agents in Grafana Agent Observability.

581|46|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/grafana/gcx --skill agento11y-prod-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agento11y-prod-setup
Source: https://github.com/grafana/gcx/tree/main/claude-plugin/skills/agento11y-prod-setup
Command: npx skills add https://github.com/grafana/gcx --skill agento11y-prod-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Once an AI agent is deployed, teams struggle to know which production evaluations and guardrails to set up, and risk creating duplicate, blocking, or misconfigured policies. This Skill grounds recommendations in the agent's actual source code and real ingested traffic, then safely applies only confirmed, non-blocking configurations via the gcx CLI.

Core Features & Use Cases

  • Evidence-based recommendations: Reads the agent's system prompt, tools, and entrypoint (cited as file:line) and samples live conversations and generations via gcx agento11y to decide which eval rules and guards are actually needed.
  • Duplicate detection: Inventories existing evaluators, rules, and guards and compares by semantic equivalence (surface, target, intent, action) so nothing is created twice.
  • Safe-by-default guardrails: Drafts all new guards in warn mode (never deny), starts online rules at a low sample_rate, and requires explicit confirmation of the target stack before any write.
  • Use Case: Your support agent is live in production and you want to catch quality regressions and redact PII pasted into prompts. The Skill samples a week of traffic, recommends a groundedness rule and a preflight redact guard, drafts reviewable YAML, and applies each only after your explicit yes.

Quick Start

Ask the agent to set up production evaluation and guardrails for your deployed agent, for example: "My agent is in prod — set up online evals and guards for it with gcx."

Frequently Asked Questions about agento11y-prod-setup

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

FAQPage Schema
How do I set up production evaluations for a deployed AI agent?

Use this Skill to sample the agent's live traffic via gcx agento11y, inventory existing evaluators and rules, then draft and apply online eval rules grounded in the agent's code and real conversations. Every write requires explicit confirmation of the target stack.

How do I add guardrails like PII redaction or tool blocking to my agent?

The Skill drafts guards (HookRules) in one of three shapes: redact for regex-based input redaction, tool_filter for blocking tool calls, or evaluator_ids for judge-backed policies. All new guards are created in warn mode so they record outcomes without blocking live traffic.

What is the difference between online eval rules and guards in Grafana Agent Observability?

Online rules observe: they score ingested traffic asynchronously with no agent code change. Guards intervene on the live request path and require the agent to call the hooks endpoint via the agento11y SDK, otherwise the guard never fires.

Why does my guard show enabled but never fire?

A guard is inert until the agent calls the hooks endpoint in code. The agent must evaluate the guard via the agento11y SDK with fail_open=False and pass conversation_id, otherwise deny and warn outcomes are never recorded on conversations.

Can I use this Skill before my agent has production traffic?

No. It requires at least roughly 20 recent conversations over 7 days to make grounded recommendations. For pre-ship agents without traffic, use the agento11y-test-starter skill to build an offline test suite instead.

Why does my online rule match traffic but show zero scores?

The selector likely does not match the agent's shape. Multi-agent pipelines and single-shot agents need selector all_assistant_generations rather than user_visible_turn, scoped with match.agent_name to the relevant node.