👁 28 次阅读

PydanticAI Detection Runs 如何实现 Agent 运行状态检测？

> 来源链接：https://github.com/pydantic/pydantic-ai/issues/5955

现象描述

在 pydantic/pydantic-ai 仓库中，Issue #5955 被创建用于跟踪所有在 agentic 工作流中威胁检测系统标记问题的运行记录。该 Issue 的标签为 pydanty:meta 和 agentic-workflows，当前状态为 open。从 Issue 描述看，这是由 GitHub Agentic Workflows 自动管理的追踪 Issue，每当工作流运行完成并出现检测警告或失败时，系统会自动在此 Issue 下发布评论。该 Issue 的核心功能是：为仓库维护者与贡献者提供一个集中查看威胁检测运行状态的入口。检测问题主要分为两类：一是检测到潜在安全威胁（包括 prompt 注入、秘密泄露、恶意补丁）；二是无法产生结果（包括 agent 失败、解析错误）。该 Issue 处于 open 状态，最后一条评论日期为 2026-10-21，评论总数为 44 条。但经剔除噪音后，实际有效评论为 0 条（44 条评论均为机器人或无效留言），即该追踪 Issue 中尚未出现实质性的用户讨论或维护者回复。

背景原因

该 Issue 的创建背景是 GitHub 的 Agentic Workflows 机制。在仓库中配置了威胁检测系统后，每次 workflow 运行结束，如果检测系统判定存在安全威胁或执行失败，就会自动在该 Issue 下追加一条评论记录。关键配置参数为 continue-on-error：

当设置为 true（默认值）时，检测问题会产生警告，但安全输出仍然继续执行。
当设置为 false 时，检测问题会阻止安全输出，即采用严格模式。

该 Issue 的模板信息中还包含一个到期标记：gh-aw-expires: 2026-07-16T15:08:45.123Z，即该追踪 Issue 在 2026 年 7 月 16 日到期，到期后会自动失效。

排查或量化方法

对于开发者在自己的 pydantic-ai 项目中遇到 Agent 运行状态检测需求时，可以按照以下方式理解该机制的工作方式：该 Issue 本身作为一个自动化的运行记录聚合器，不涉及具体代码改动。开发者如果想要配置威胁检测行为，需要修改 workflow 文件中的 frontmatter 配置：

safe-outputs:
  threat-detection:
    continue-on-error: true   # Warnings only (default)
    # continue-on-error: false  # Strict mode — block safe outputs

配置变更后，后续 workflow 运行会根据新的策略决定是产生警告还是阻断执行。

完整解决方案（含必要代码）

由于该 Issue 中没有任何实质性的开发者讨论或维护者回复，官方侧尚无具体的解决方案提供。从 Issue 模板本身可以提取的信息如下：该 Issue 提供了三个核心功能用途：

追踪威胁检测引发关注的工作流运行
审查检测警告或失败的模式
识别威胁检测的误报或反复出现的问题
监控威胁检测系统的健康状态

资源链接中提到了 GitHub Agentic Workflows Documentation，开发者可以查阅该文档获取更完整的配置说明。 Issue 模板还明确说明：该 Issue 由 GitHub Agentic Workflows 自动管理，不需要手动关闭，也不要分配给任何 agent。

参数或对比表格

配置项	值	行为
`continue-on-error`	`true`（默认）	检测到威胁或失败时产生警告，安全输出继续执行
`continue-on-error`	`false`	检测到威胁或失败时阻断安全输出，不继续执行
检测问题类型	安全威胁	包括 prompt 注入、秘密泄露、恶意补丁
检测问题类型	执行失败	包括 agent 失败、解析错误

常见错误排查

误以为该 Issue 提供代码级 API — 该 Issue 是自动化追踪 Issue，不包含任何 API 实现或代码改动。需要实现 Agent 运行状态检测的开发者应查看 pydantic-ai 主仓库的其它文档或功能。 忽略 continue-on-error 的语义差异 — 默认配置下，检测问题只是警告，不会阻断输出。如果需要严格模式，必须显式将 continue-on-error 设置为 false。 尝试手动关闭该 Issue — 模板明确说明该 Issue 由 GitHub Agentic Workflows 自动管理，不需要也不应该手动关闭。该 Issue 带有自动到期机制（expires 字段），到期后会自动失效。 将机器人评论误认为人工回复 — 该 Issue 中的 44 条评论全部为机器人或无效留言，没有实质性讨论。不要将其中的自动记录当作官方对某个问题的确认或回应。 在代码中引用该 Issue 的配置方式 — 该 Issue 的 frontmatter 配置是针对 GitHub Agentic Workflows 的 workflow 文件的，不适用于 pydantic-ai 的 Python 代码配置。

实践建议

对于使用 pydantic-ai 且需要监控 Agent 运行状态与安全检测的开发者，可以参考以下建议：

在项目的 workflow 配置中明确设置 continue-on-error 策略，根据项目对安全性的要求决定使用警告模式还是严格阻断模式。
定期查阅此类自动追踪 Issue 中的运行记录，识别反复出现的检测模式，判断是真实威胁还是误报。
对于检测问题较多的 workflow，优先排查 prompt 注入防护、秘密管理与补丁来源验证这三个方向。
关注到期时间字段，到期后追踪记录会停止更新，需要时重新创建追踪 Issue。

FAQ

Q：该 Issue 可以用于获取 pydantic-ai 的运行状态检测 API 吗？ A：不可以。该 Issue 仅用于追踪 GitHub Agentic Workflows 中的威胁检测运行记录，不提供任何代码级 API。目前该 Issue 中没有任何实质讨论或官方回复。 Q：检测到安全威胁时，默认行为是什么？ A：默认配置 continue-on-error: true 下，威胁检测产生警告，但安全输出仍会继续执行。只有将配置改为 false 才会阻断输出。 Q：该 Issue 为什么有 44 条评论但无法看到实质性内容？ A：据 Issue 数据，这 44 条评论均为机器人或无效留言，已剔除。当前该 Issue 中没有实质性的开发者讨论或维护者回复。 Q：该 Issue 什么时候会关闭？ A：该 Issue 当前状态为 open，带有到期标记 2026-07-16T15:08:45.123Z。到期后该追踪 Issue 会自动失效，但当前没有官方关闭或处理计划。 Q：如何在自己项目中复现类似的威胁检测追踪机制？ A：该功能由 GitHub Agentic Workflows 提供，具体实现细节参见 GitHub Agentic Workflows Documentation。该 Issue 中未提供额外的配置示例或代码。