跳转到主要内容

概述

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,用于故障 / 作战室联动与双向事件流。
委派后无需等待:AI SRE 把任务交给远端 Agent 后会立即继续当前对话,您可以继续工作或同时委派多个任务;远端完成后,其结果作为一条新消息出现在对话中。 每次 A2A 委派在对话流里以一行呈现:机器人图标 + “已派发〈远端 Agent 名〉”文案 + 本次任务意图,右侧显示运行状态(初始化 / 进行中 / 等待输入 / 等待授权 / 完成 / 失败(含孤儿任务)/ 中断 / 已终止)以及工具调用数、Token、耗时等用量;点击这一行可在右侧面板里查看该次委派的完整过程,A2A 徽标标在该面板标题上,不在对话流这一行上。在 BYOC Runner 上执行的委派遇到连接中断或 AI SRE 实例重启也会接着跑(由另一实例接管),只有云端环境上的委派随实例一起中断,因此「中断」与「失败(含孤儿任务)」主要出现在云端环境。
调用说明决定 AI SRE 会不会选中这个 Agent。 委派前,AI SRE 只看到清单里的一行 名称:简介(简介取自调用说明开头的 summary:),据此判断要不要派给它;正文只在首次委派时完整送达,可以写长写细。写法见调用说明的写法。
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 模板

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,改用当前可用工具或您实际接入的数据源。
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 中的网络可达性要求一致。
完成 FlashAI 侧配置后,在折叠卡片中填写 FlashAI 域名(例如 demo.flashcat.cloud),点击 使用此模板。页面会打开 添加 A2A Agent 表单并预填:
  • 名称:根据域名生成,例如 flashai-demo
  • 调用说明:开头一行 summary: 简介 + 正文,正文列出哪些 Flashcat 告警/故障应优先调用 FlashAI、哪些泛化可观测问题不应调用。
  • Card URL:根据域名自动生成:
模板只预填通用信息;范围(共享或团队)和认证仍需您在表单中设置。同一个 FlashAI 可以按不同范围安装多次,但 Agent 名称在账户内须唯一,重复安装时请修改名称。
不建议删除 FlashAI 模板生成的调用说明,尤其是开头的 summary: 简介——注册后 FlashAI 一定会出现在“可用 Agent 清单”里,但 AI SRE 是否把任务派给它,直接依据就是这行简介。说明过短或过于泛化时,AI SRE 可能继续在本地推理,或把普通 metrics / logs 问题错误委派给 FlashAI。

授权模式

A2A Agent 的身份由两条互相独立的轴决定,两条轴可以同时配置:
  • 服务授权:AI SRE 作为一个服务去访问远端 Agent 时使用的身份,账户内共用一份。可选无、Bearer Token、自定义 Header + Key。表单中标记为推荐——配置一次即可覆盖全部场景。
  • 成员授权:每位成员各自持有的身份。可选无、密钥(Header)、OAuth 2.1。
这两条轴不是三选一。您可以只配服务授权、只配成员授权,也可以两者都配。两者都配时,由下面的“身份使用顺序”决定每个场景实际用哪一个。

身份使用顺序

表单底部的“身份使用顺序”面板会随两个下拉框的选择实时给出结论:
  • 只配了服务授权:所有场景都使用服务授权。
  • 只配了成员授权:IM 群聊会逐轮使用发言成员的个人授权。如果远端系统不接受同一会话内多人轮流的身份(会因身份校验失败而拒绝),请补配服务授权。
  • 两条轴都为“无”:调用不携带任何身份。保存时需要二次确认。远端需要认证时,推荐配置服务授权。
服务授权意味着账户内任何团队范围会话与 IM 群聊都能以这个服务身份调用远端系统。若该系统涉及成员个人数据或高危写操作,建议同时启用成员授权。

成员授权的两种形式

每位成员在首次调用时单独提供自己的密钥,密钥加密存储在账户级别。选择此模式需在“密钥 Schema”中填写 Header 名称(必填,凭证注入到哪个 HTTP header)与帮助链接(可选,指向“如何获取该密钥”的文档),供首次调用时引导成员填写。成员在 A2A Agent 列表的“成员授权”列各自填写并管理自己的密钥。
成员通过 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 重新发现元数据。
只能查看、不能编辑 Agent 的成员拿到的 Card URL 会去掉 user:password 部分,每个查询参数的值替换为 ****;地址无法解析时整段不显示。
成员授权(OAuth 2.1)的发现地址优先使用 HTTPS。只有在受控测试环境中,才为非本地 HTTP Card URL 勾选“允许通过 HTTP 获取 OAuth 配置(仅限测试环境)”。如果 HTTPS 端点使用自签证书,也只应在可信网络内临时开启“跳过 TLS 证书校验”。

协议版本与 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 声明。
从 0.x 迁移到 1.0:如果您的 Agent Card 仍是 0.x 旧格式,请按下表调整后再接入:

创建与管理

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 地址:
把该地址填入任意 A2A 客户端,即可经 A2A 协议调用 Flashduty 的 AI SRE Agent。 鉴权:在请求头加上 Fd-App-Key: <你的 app_key>(或使用 ?app_key= 查询参数)。Agent Card 对外声明的能力包括:
Agent Card 同时声明了 Flashduty 的“运行选项”A2A 扩展:调用方可在 message.metadata 中按需覆盖 incognito(是否在会话列表中隐藏,默认隐藏)、visibility(private / account)、以及运行环境(cloud / byoc 与具体 environment_id)。该扩展为可选项,朴素的 A2A 客户端无需理会即可正常调用。

故障与作战室联动

当一个会话经由故障路由进入(例如从故障或作战室触发 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 无限自我派生。
运行环境:子任务默认与当前会话在同一个环境里运行,共用同一套文件系统,能直接看到您 workspace 里的文件。AI SRE 也可以把子任务派到一个全新的云端环境(临时容器,文件系统独立,可访问公网,访问不到您的内网),或派到一台 BYOC Runner(账户级 Runner,以及当前会话所绑定团队的 Runner)。候选清单包含所有曾连接过的 Runner(含当前离线的),从未连接的不列出;是否可达在派发时才校验。指定的 Runner 不可用时,派发会失败并说明原因,不会改派到其他环境。A2A 委派不能选环境,远端 Agent 在它自己的环境里执行。环境的区别与选择方式见运行环境(BYOC)。 跨环境派发时无法读取父会话的文件:派到其他环境的子会话使用自己的沙箱或 Runner 目录,读不到父会话的文件。因此 AI SRE 会把子任务需要的全部信息写进任务描述,结果以文本返回,或经外部系统(git、工单)流转。

相关页面

控制台对话

在会话中观察 A2A 委派及其子会话面板。

MCP(外部工具)

为 Agent 接入外部工具,扩展其在任务中的能力边界。

管理知识

用 DUTY.md 与知识为 Agent 提供团队上下文与排障经验。

IM 平台

在 IM 群里 @ AI SRE,并了解故障作战室的自动诊断。

概述

了解 AI SRE 的整体能力与定位。