Skip to main content

Package AI expertise with Agents and ask about delivery metrics

· 4 min read

You can now define Agents: named assistants with their own instructions and their own set of tools. Pick one from the Assistant header and it answers using only what you gave it. Separately, the Assistant can read your Development Insights dashboards, so a delivery question gets real panel data back rather than a plausible-looking number.

Define Agents for your team's workflows

An agent is an organization-scoped assistant with its own instructions, example prompts, and bindings to Venue tools, MCP server tools, and other agents.

  • Organization registry - Browse and search agents from Agents in the sidebar (under AI).
  • Custom instructions - Write what the agent does and how it should respond, in prose.
  • Capability bindings - Grant access to Venue tools, individual MCP server tools, or other agents. Use Add all to bind every tool from a server at once.
  • Templates - Start from a predefined template to pre-fill name, description, instructions, and example prompts.
  • Safety controls - Require human approval before the agent executes sensitive actions.
  • Lifecycle management - Move agents through Draft, Ready, Disabled, and Archived states. Duplicate, disable, or archive from the detail page.

Admins and Editors can create agents. Contributors, Viewers, and Demo users can browse them. The Activity Log records every create, update, and delete.

See Agents for setup details and example configurations such as an Atlassian-aware agent or a Kubernetes and Helm troubleshooting agent.

Select the right Agent in the Assistant

The Assistant now supports agent selection alongside the general Venue.sh assistant.

  • Agent selector - Choose a ready agent from the Assistant header before or during a conversation.
  • Scoped tools - Select an agent and the Assistant uses that agent's instructions and only the tools bound to it, including full MCP server tool access where configured.
  • Page context on AI pages - On supported AI pages (e.g., Agents, MCP Servers, Skills), use Add current page to context so the Assistant knows what you are looking at.

For example, select a DevOps agent and ask:

  • "Why is the payments-api pod crashing in staging?"
  • "Show me the Helm values for the checkout-service release in production."

Or ask the general assistant about your agent catalog:

  • "What agents are available in our organization?"
  • "Which agents have access to Jira tools?"

Ask the Assistant about Development Insights

The Assistant reads the same Grafana panel data you see in the Development Insights UI, so its answers match your dashboards.

Three read-only tools cover the dashboards most teams use for delivery health:

  • DORA - Deployment frequency, lead time for changes, change failure rate, and recovery time.
  • Engineering Overview - Cross-provider delivery health across Jira and Git.
  • Engineering Throughput & Cycle - Throughput, quality, and cycle-time workflow metrics.

Ask a delivery question and the Assistant calls the matching tool, applies any filters you mentioned such as project, time range, or DORA report year, then summarizes the panel data it gets back. It defaults to the last six months if you do not name a range.

Access follows your existing permissions. You need Development Insights read permission, and Development Insights enabled for your organization.

Try asking:

  • "What is our deployment frequency this quarter?"
  • "How does our lead time compare to last month?"
  • "Summarize throughput and cycle time for the platform team."

Provider-specific Git dashboards (GitLab, GitHub, Bitbucket) are not available through Assistant tools in this release. Use the dashboard UI for those views.

Updated Assistant model lineup

The built-in model catalog adds Claude Opus 4.8, Claude Sonnet 5, and GPT-5.5 Pro. Your Venue administrator controls which models appear in the Assistant model dropdown through Settings > Assistant.

See Also

  • Agents - Define agents with custom instructions and capability bindings.
  • Assistant - Ask questions about your catalog, documentation, repositories, and enabled integrations.
  • Development Insights - Enable and configure engineering metrics for your organization.
  • Dashboards - Filter, refresh, and explore your Development Insights panels.
  • MCP Servers - Register MCP servers whose tools you can bind to agents.