用途：grafana-assistant CLI 用于通过 A2A API 与 Grafana Assistant 交互，适合在 Cursor 等编码代理中以非交互方式查询 Grafana 数据。
前提：二进制需已安装并在 $PATH 中，不要自动安装；找不到命令时应提示用户先安装。安装说明与预编译二进制见 github.com/grafana/assistant-cli，另有 Docker 镜像。
配置：配置文件查找顺序为 GRAFANA_ASSISTANT_CONFIG 环境变量、./grafana-assistant.yaml（需 --local）、~/.config/grafana-assistant/config.yaml。支持 current-instance、instances（url、token，token 支持 ${ENV} 展开）、projects、tunnel 的 filesystem/terminal 允许与拒绝列表。环境变量 GRAFANA_URL、GRAFANA_SA_TOKEN 可覆盖配置。凭据优先级：--url/--token 标志、环境变量、--instance、current-instance。
快速设置： grafana-assistant config set-instance mystack --url https://mystack.grafana.net grafana-assistant config use-instance mystack grafana-assistant auth grafana-assistant chat 浏览器认证需要 Assistant CLI User 角色，Editor 及以上自动具备；自定义角色需包含 grafana-assistant-app.tokens:access 权限。
主要能力：prompt 为非交互主模式，发送单条消息并返回响应；agents 列出智能体；agents-md 生成 AGENTS.md；chat 打开全屏 TUI；tunnel 允许 Assistant 在本地执行工具，含 daemon 管理。
上下文：每次 prompt 默认新会话，需首次用 --json 获取 contextId，后续用 -c <contextId> 串联；若串联失败，可在提示中直接包含先前发现。JSON 输出含 taskId、contextId、agentId、status、response，status 可为 completed、failed、timeout、canceled、unknown。
限制：CLI 智能体为只读，不能修改 Grafana；仪表盘创建/修改、告警规则与静默管理、页面导航仅在 Web/Slack 可用。Shell 调用建议 required_permissions: ["all"]，复杂查询 block_until_ms 至少 300000。隧道默认文件系统只读、项目范围，屏蔽敏感路径，文件上限 1MB；终端默认屏蔽危险命令。