[Tool Description] Improve Grafana tool description for better LLM selection #827
Description
Problem
The current Grafana tool description lacks the detail and clarity needed for optimal LLM tool selection, resulting in an estimated confidence score of ~0.3 (below target of ≥0.5).
Current Description Issues:
- Missing usage guidance (when to use vs when not to use)
- Limited context about Azure Managed Grafana vs other monitoring tools
- Vague description of available operations
- Poor parameter explanation
- Missing limitations/caveats
- Formatting issues (missing space after period)
- Unclear relationship to Azure Monitor and other observability tools
Current Description
Grafana workspace operations - Commands for managing and accessing Azure Managed Grafana resources and monitoring dashboards. Includes operations for listing Grafana workspaces and managing data visualization and monitoring capabilities.This tool is a hierarchical MCP command router. Sub commands are routed to MCP servers that require specific fields inside the "parameters" object. To invoke a command, set "command" and wrap its args in "parameters". Set "learn=true" to discover available sub commands.
Suggested Improvement
Grafana workspace operations - Commands for managing and accessing Azure Managed Grafana instances for creating monitoring dashboards and data visualizations from Azure Monitor, Application Insights, and other data sources. Use this tool when you need to list Grafana workspaces, access workspace configurations, manage dashboard permissions, or retrieve information about available Grafana instances for monitoring and observability. This tool focuses on Azure Managed Grafana service management rather than dashboard content creation. Do not use this tool for Azure Monitor queries, Application Insights analytics, Log Analytics workspace operations, or creating dashboard content - this tool manages the Grafana service instances themselves. This tool is a hierarchical MCP command router where sub-commands are routed to MCP servers that require specific fields inside the "parameters" object. To invoke a command, set "command" and wrap its arguments in "parameters". Set "learn=true" to discover available sub-commands for different Grafana workspace operations. Note that this tool requires appropriate Azure permissions to access Grafana workspace resources.
Acceptance Criteria
- Update tool description to include clear usage guidance
- Explain Azure Managed Grafana context and relationship to other monitoring tools
- Clarify when NOT to use this tool (vs other monitoring tools)
- Detail the specific workspace management operations available
- Fix formatting issues
- Achieve confidence score ≥0.5 in tool selection testing
Related: Tool description review for improved LLM selection accuracy
Metadata
Metadata
Assignees
Labels
No labels
Type
Projects
Status