Configure Assistant rules
Custom rules guide how Grafana Assistant responds and behaves. Rules are automatically applied to every conversation. Due to the indeterministic nature of LLMs, there’s no guarantee they are followed exactly as specified.
You can create rules in Settings > Assistant behavior and apply them to yourself or everyone in your tenant.
Before you begin
Ensure you have RBAC permissions to manage Assistant rules for your scope.
Create a rule
- Navigate to Assistant > Settings > Assistant behavior.
- Click Create rule.
- Enter a rule name and describe the behavior you want.
- Choose the scope: Just me or Everybody.
- Select the Applications the rule applies to.
- Click Create rule.
The Assistant applies your rule automatically in new conversations.
Rule examples
Use these examples as starting points for your own rules.
Infra and app hints
Guide the Assistant to use specifics relevant to your environment:
When discussing CPU metrics, use container_cpu_usage_seconds_total instead of generic CPU references. Reference our custom service_health_score metric for overall service status. Prefer the prometheus_prod datasource when investigating issues in production.
Communication style
Define how the Assistant formats and structures responses:
Always be concise and direct in responses. Use bullet points for actionable recommendations. Avoid jargon unless specifically discussing technical implementation.
Best practices
Encode organizational standards and observability methodologies:
Use the RED method (Rate, Errors, Duration) wherever possible. Always recommend setting up SLIs before creating SLOs. Suggest using template variables for dynamic dashboards.
Workflow guidelines
Automate operational recommendations based on specific triggers:
Suggest declaring an incident if the ecommerce platform response time exceeds 5 seconds. Recommend escalating to the infrastructure team for persistent memory issues. Always ask about recent deployments when troubleshooting performance issues.
