概述
Agent 是把 AI SRE 接入外部 Agent 生态的资源类别。当前支持的类型是 A2A(Agent-to-Agent)——一套让不同 Agent 相互调用的标准协议。A2A 把 AI SRE 接入外部 Agent,有两个方向:出站(Outbound)
在列表中注册的远端 A2A Agent。AI SRE 通过标准 A2A 协议把任务委派给它们——例如一个专精指标分析、或对接某个内部系统的外部 Agent。
入站(Inbound)
本平台的 AI SRE 自身也是一个 A2A Agent,对外暴露一张 Agent Card。外部 A2A 客户端把该 Card 地址填入即可反向调用 Flashduty 的 AI SRE,用于故障 / 作战室联动与双向事件流。
A2A 徽标标在该面板标题上,不在对话流这一行上。在 BYOC Runner 上执行的委派遇到连接中断或 AI SRE 实例重启也会接着跑(由另一实例接管),只有云端环境上的委派随实例一起中断,因此「中断」与「失败(含孤儿任务)」主要出现在云端环境。
A2A Agent 的列表与管理入口在 自定义 → 插件 → Agents 页面。
Agents 涵盖两类不同的概念。 本页(Agents)当前管理的是 A2A Agent(外部 Agent 互调)。另一类是 Subagent(任务子代理)——平台内置、由 AI SRE 在会话中按需派发的任务执行器,没有创建 / 编辑入口,只能在会话中观察其行为,详见下文Subagent 任务子代理。
注册出站 A2A Agent
在 A2A Agents 列表页点击 添加 A2A Agent,在表单中填写:调用说明的写法
调用说明是一份文档,最多分两部分:开头一段可选的 YAML frontmatter(只有一个summary 字段),后面是正文。
- 简介(
summary)驱动路由:AI SRE 每次决定要不要委派时,看到的只是“可用 Agent 清单”里的一行名称:简介。简介就是这一行的内容,务必写清楚什么时候该优先选它、擅长什么、不擅长什么——用具体的能力词(产品名、动词、场景),不要写空泛的宣传语。简介过长会在清单里被截断,重要信息往前写。 - 正文按需送达,不常驻清单:正文不会一直占着 AI SRE 的上下文;只有当 AI SRE 第一次把任务委派给这个 Agent 时,正文才会完整发给它(渐进式加载)。这意味着正文可以放心写得很长、很细——操作步骤、硬性规则(HARD RULE)、示例——不用担心拖慢日常对话。
- 不写
summary也兼容:如果调用说明整段是纯文本、不以---开头,全部内容都会被当作正文,AI SRE 自动截取开头一段作为简介(会被截断),旧版本写的调用说明无需改动即可继续用。但强烈建议显式写一段summary,路由效果更可控。 - 硬性限制:整份调用说明(frontmatter + 正文)不超过 50 KB;
summary不超过 1,024 个字符,且不能包含<或>;正文不能为空。 - 如果开头写了
---,就必须再用一行---把 frontmatter 闭合,否则保存会失败。
使用 FlashAI 模板
FlashAI 是 Flashcat / 快猫星云体系内的可观测分析产品,也可以作为远端 A2A Agent 供 AI SRE 调用。在 A2A Agents 页面展开 连接 FlashAI 可观测分析 折叠卡片,即可使用 FlashAI 模板创建 A2A Agent。 FlashAI 模板的定位不是“所有可观测查询都走 FlashAI”,而是把 FlashAI 配置为 Flashcat / 快猫星云来源告警与故障排查 的委派目标。对于来自 Flashcat 的事件墙 / Event Wall、灭火图 / Firemap、北极星 / Polaris 等告警或故障,AI SRE 应优先把分析任务委派给 FlashAI。 模板默认预填一份调用说明,开头的summary: 简介列出 FlashAI 擅长的 Flashcat / 快猫星云产品范围,正文给出路由规则:
- 排查明确来自 Flashcat / 快猫星云的告警、故障、事件或告警组(事件墙、灭火图、北极星)时,优先委派给 FlashAI。
- 只是泛泛询问 metrics、logs、traces 或性能问题,且没有 Flashcat / 快猫星云的告警上下文或产品标识时,不调用 FlashAI,改用当前可用工具或您实际接入的数据源。
1
确认版本
FlashAI 需为
release-24 或更新版本。2
配置 FlashAI /config
在 FlashAI / Flashcat 控制台打开
/config 页面(例如 https://demo.flashcat.cloud/config),添加 a2a_server_base_url,值填写当前 FlashAI 的访问域名,例如 https://demo.flashcat.cloud。3
确认网络可达
如果 FlashAI 使用内网地址,只有部署在该网络内的 BYOC Runner 可以访问;如果希望云 Sandbox 也能调用 FlashAI,请使用公网可达域名,并按需配置白名单。这个限制与 MCP SSE 地址在 Sandbox 中的网络可达性要求一致。
demo.flashcat.cloud),点击 使用此模板。页面会打开 添加 A2A Agent 表单并预填:
- 名称:根据域名生成,例如
flashai-demo - 调用说明:开头一行
summary:简介 + 正文,正文列出哪些 Flashcat 告警/故障应优先调用 FlashAI、哪些泛化可观测问题不应调用。 - Card URL:根据域名自动生成:
授权模式
A2A Agent 的身份由两条互相独立的轴决定,两条轴可以同时配置:- 服务授权:AI SRE 作为一个服务去访问远端 Agent 时使用的身份,账户内共用一份。可选无、Bearer Token、自定义 Header + Key。表单中标记为推荐——配置一次即可覆盖全部场景。
- 成员授权:每位成员各自持有的身份。可选无、密钥(Header)、OAuth 2.1。
这两条轴不是三选一。您可以只配服务授权、只配成员授权,也可以两者都配。两者都配时,由下面的“身份使用顺序”决定每个场景实际用哪一个。
身份使用顺序
表单底部的“身份使用顺序”面板会随两个下拉框的选择实时给出结论:
- 只配了服务授权:所有场景都使用服务授权。
- 只配了成员授权:IM 群聊会逐轮使用发言成员的个人授权。如果远端系统不接受同一会话内多人轮流的身份(会因身份校验失败而拒绝),请补配服务授权。
- 两条轴都为“无”:调用不携带任何身份。保存时需要二次确认。远端需要认证时,推荐配置服务授权。
成员授权的两种形式
密钥(Header)
密钥(Header)
每位成员在首次调用时单独提供自己的密钥,密钥加密存储在账户级别。选择此模式需在“密钥 Schema”中填写 Header 名称(必填,凭证注入到哪个 HTTP header)与帮助链接(可选,指向“如何获取该密钥”的文档),供首次调用时引导成员填写。成员在 A2A Agent 列表的“成员授权”列各自填写并管理自己的密钥。
OAuth 2.1
OAuth 2.1
成员通过 OAuth 2.1 流程各自授权;首次调用该 A2A Agent 时自动弹出授权窗口,完成后凭证按成员隔离保存。授权前需在凭证对话框选择执行环境:可选云端 Sandbox 或在线的 BYOC Runner,不能使用“自动”。OAuth 请求从所选环境发起;远端 OAuth 服务仅在内网可达时,请选择能够访问它的 BYOC Runner。
OAuth 2.1 只出现在成员授权这条轴上。服务授权是账户内共用的一份静态凭证,只提供 Bearer Token 与 API Key 两种形式。
已保存的敏感字段(如令牌、API Key、Client Secret)显示为固定的
**** 掩码,不露出首尾任何字符。编辑时把掩码原样保存表示保留原值,留空保存表示清除该字段。修改 Card URL 会作废已存的凭证
改 Card URL 等于把 Agent 指向了新的目的地,已存的凭证不会跟着搬过去:- 认证配置里的敏感字段必须在同一次编辑中重填明文:留空提交、或把掩码原样提交,保存都会失败,并列出需要重填的字段名;整个字段不提交也按“沿用旧值”处理,同样失败。报错原文:
The connection destination changed, so stored secrets are not sent to it. Re-enter these values in the same edit: <字段名>。 - 成员授权(密钥 / OAuth 2.1)下每位成员的凭证全部作废:改完 Card URL,每位成员都要重新填写自己的密钥或重新授权。作废发生在保存之前,所以即使保存失败,成员也需要重新授权。
- 只更换 OAuth 元数据、不改 Card URL:同样作废成员的凭证,但不要求重填账户内共用的值;把它清空则只按原 Card URL 重新发现元数据。
user:password 部分,每个查询参数的值替换为 ****;地址无法解析时整段不显示。
协议版本与 Agent Card 要求
平台作为 A2A 客户端调用远端 Agent,实现的是 A2A Protocol 1.0(JSONRPC 或 HTTP+JSON 协议绑定)。0.x 及其他大版本协议不受支持:远端 Agent 的 Agent Card 必须是 1.0 格式,否则委派调用会失败。
1.0 格式的 Agent Card 通过 supportedInterfaces 数组声明接入点,其中至少一项需包含 url、protocolBinding(JSONRPC 或 HTTP+JSON)和 protocolVersion: "1.0"。一张最小合法卡片如下:
卡片里的
version 字段是 Agent 自身的版本号,不是协议版本;协议版本由 supportedInterfaces 各项中的 protocolVersion 声明。创建与管理
A2A Agent 的完整生命周期可在 自定义 → 插件 → Agents 页面管理。创建
创建
点击 添加 A2A Agent,填写名称、范围、调用说明、Card URL、认证等并保存。创建时需选定一个明确的作用域(共享或团队),未选定前提交按钮保持禁用。
启用 / 禁用
启用 / 禁用
用列表中的开关切换 A2A Agent 的启用状态。仅已启用的 Agent 会进入 AI SRE 的可用清单、可被委派任务;禁用后立即对委派不可见。
检视 / 编辑
检视 / 编辑
点击列表中的任意一行打开表单,可查看与编辑名称、调用说明、范围、Card URL、服务授权、成员授权与流式设置。无编辑权限时表单显示为只读。
删除
删除
从当前范围移除一个 A2A Agent。委派给它的活跃会话将会失败。 删除有确认提示。
按范围筛选与搜索
按范围筛选与搜索
列表顶部可按范围(全部 / 共享 / 指定团队)筛选,或按名称、调用说明、Card URL 中的关键词搜索。每行标注其范围(共享 / 团队名)。
作用域
A2A Agent 与其他资源共用同一套两级作用域(共享 / 团队)。创建、编辑和运行时可见性的规则见作用域与权限。入站:让外部 Agent 调用 AI SRE
在 A2A Agents 页面顶部展开“让外部 Agent 调用 Flashduty 的 AI SRE”面板,即可获取本账户 AI SRE 的 Agent Card 地址:Fd-App-Key: <你的 app_key>(或使用 ?app_key= 查询参数)。Agent Card 对外声明的能力包括:
故障与作战室联动
当一个会话经由故障路由进入(例如从故障或作战室触发 AI SRE)时,平台会把对应的故障绑定到本次会话,并作为上下文带入,让排障从一开始就锚定在正确的故障上。基于此,AI SRE 可在对话中借助内置 Skill 进一步操作故障——读取故障详情、查询时间线、创建 / 查看作战室、关联变更等。IM 侧的作战室自动诊断详见 IM 集成。Subagent 任务子代理
Subagent 是平台内置的任务执行器。AI SRE 在排障过程中,会把自包含的子任务派发(dispatch)给 Subagent 独立完成。 平台预置了若干引导(bootstrap)Subagent,开箱即用:
会话中的呈现:每次派发在对话流里同样以一行呈现,状态与 A2A 委派相同——机器人图标 + “已派发〈子代理名〉”文案(子代理名是
agent / general 这类类型同义词时写作 subagent)+ 本次任务意图,右侧标出这次派发所在的执行环境(云端环境或 BYOC Runner 名称)与该次运行的用量、状态;点击这一行可在右侧面板里查看完整过程,Agent 徽标(A2A 委派为 A2A)标在该面板标题上。
运行约束:
- 并发上限:每个会话同一时刻最多运行 20 个 Subagent。累计派发数不限,完成一个就释放一个名额;达到上限时,AI SRE 会等运行中的任务完成后再派发其余的。
- 嵌套深度:派发链最多嵌套 3 层,防止 Subagent 无限自我派生。
相关页面
控制台对话
在会话中观察 A2A 委派及其子会话面板。
MCP(外部工具)
为 Agent 接入外部工具,扩展其在任务中的能力边界。
管理知识
用 DUTY.md 与知识为 Agent 提供团队上下文与排障经验。
IM 平台
在 IM 群里 @ AI SRE,并了解故障作战室的自动诊断。
概述
了解 AI SRE 的整体能力与定位。