aio11y

Inspect AI Observability conversations and manage evaluators, rules, and scores via the gcx CLI.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill aio11y-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aio11y
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/aio11y
Command: npx skills add https://github.com/titaneric/dotfiles --skill aio11y-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging LLM-powered applications in production requires visibility into what agents actually did and whether their output was any good. This Skill provides command-line access to Grafana's AI Observability platform so you can search conversations, inspect individual generations, and set up automated quality scoring without leaving your terminal. ## 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 delete evaluators (LLM judge, regex, heuristic, JSON schema) using YAML definitions, with built-in templates as starting points. - Evaluation Rules & Scores: Bind evaluators to production traffic with selectors, match filters, and sampling rates, then check resulting scores per generation. - Use Case: An agent starts returning malformed JSON in production. Search conversations with status = "error" filters, inspect the failing generations, then create a json_schema evaluator and a rule to continuously score output format compliance. ## Quick Start Ask the assistant to list recent AI Observability conversations for a specific agent using the gcx aio11y conversations search command.

Frequently Asked Questions about aio11y

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

FAQPage Schema
How do I search AI Observability conversations by agent or error?

Use gcx aio11y conversations search with space-separated filters like agent = "my-agent" status = "error". It defaults to the last 24 hours and supports operators including =, !=, >, <, and =~ for regex matching.

How do I set up online evaluation for LLM generations?

Pick a template with gcx aio11y templates list, copy its kind, config, and output_keys into a new evaluator YAML, create it, test it against a real generation, then create a rule binding the evaluator to production traffic with a selector and sample rate.

Which evaluator kind should I use for LLM output checks?

Use llm_judge for quality assessments like helpfulness or groundedness, json_schema for output format validation, regex for presence or absence of specific content, and heuristic for checks like minimum length or multiple combined conditions.

Can I reuse the YAML from evaluators get to create or update?

No. The get -o yaml output emits K8s-style manifests with apiVersion, kind, metadata, and spec, while create -f and update -f expect top-level fields only. Do not round-trip get output into create or update commands.

What happens when I delete an evaluator referenced by a rule?

Deleting an evaluator that a rule references may leave the rule pointing at a missing evaluator. After running gcx aio11y evaluators delete <id> -f, check gcx aio11y rules list to verify no rules are broken.