agento11y

Inspect and manage Grafana Agent Observability conversations, evaluators, rules, and scores via gcx.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams running LLM-powered applications in production lack visibility into what their agents actually do and whether their outputs are good. This Skill lets you inspect recorded LLM conversations and generations, build quality evaluators, bind them to production traffic with rules, and review the resulting scores — all through the gcx CLI.

Core Features & Use Cases

  • Conversation & Generation Inspection: List, search, and filter conversations by agent, model, status, error type, and more to debug what an agent did in production.
  • Evaluator Management: Create, test, and version evaluators of four kinds (llm_judge, regex, heuristic, json_schema) using copy-paste YAML definitions with API-enforced constraints.
  • Online Evaluation Setup: Bind evaluators to live traffic with rules that control selectors, match filters, and sampling rates, then analyze pass/fail score trends.
  • Use Case: After deploying a support chatbot, create an llm_judge helpfulness evaluator, test it against a real generation, attach it to a rule matching your agent's user-visible turns, and review failing scores with explanations to find quality regressions.

Quick Start

Ask the agent to list recent Agent Observability conversations for your agent and set up an online evaluation rule with a helpfulness evaluator.

Frequently Asked Questions about agento11y

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

FAQPage Schema
How do I set up online evaluation for an LLM agent?

Pick a built-in template with gcx agento11y templates list, copy its fields into your own evaluator YAML, upsert it, test against a real generation, then create a rule binding the evaluator to traffic with a selector and sample rate. Verify with rules list and inspect scores via rules list-scores.

How do I search LLM conversations in Grafana Agent Observability?

Use gcx agento11y conversations search with space-separated filters like agent = "my-agent" status = "error". Supported keys include model, provider, agent, status, error.type, duration, and eval.score, with operators =, !=, >, <, >=, <=, and =~ for regex.

Which evaluator kind should I use for LLM output quality checks?

Use llm_judge for subjective quality like helpfulness or groundedness, json_schema for output format validation, regex for presence or absence of specific content, and heuristic for deterministic checks like non-empty or minimum length. Each kind has specific config constraints documented in the reference examples.

Why does my evaluation rule match traffic but produce zero scores?

The selector likely does not match your agent's shape. The user_visible_turn selector only matches user-facing turns, so multi-agent pipelines or single-shot agents need all_assistant_generations scoped with match.agent_name. Check eval_summary.total_scores to confirm.

Can I update an existing evaluator in Agent Observability?

There is no update command; re-run evaluators upsert with the same evaluator_id and a new version value. Re-using an existing version is rejected with a 409 error, and IDs accept only letters, digits, underscores, and dots.