新闻详情

新闻详情

首页 / 资讯中心 / 详情

GitAgent Hooks钩子详解:拦截、修改和控制AI代理每个生命周期事件

发布时间:2026/11/20 18:55:37来源:尧图网络
GitAgent Hooks钩子详解:拦截、修改和控制AI代理每个生命周期事件
GitAgent Hooks钩子详解拦截、修改和控制AI代理每个生命周期事件【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengapGitAgent Hooks钩子是 GitAgent 框架中一套强大的生命周期拦截机制。GitAgent 是一个 git 原生的 AI 代理标准框架——你的代理身份、规则、记忆和工具都以版本化文件的形式保存在 git 仓库中而 Hooks 让你用简单的脚本或代码在代理运行的每个关键节点上拦截、修改和控制其行为阻止危险命令、审计日志、限流、告警全部尽在掌握。 GitAgent Hooks 是什么简单来说Hooks 就像给 AI 代理装上的安全栏杆拦截block——代理准备执行危险操作时直接叫停修改modify——在工具真正执行前悄悄替换它的参数放行allow——检查通过一切照常。与传统框架不同的是GitAgent 的钩子定义就存放在仓库的hooks/hooks.yaml文件中见 README.md随仓库一起提交、分叉、审查——你可以git log追踪每一条钩子的变更历史这正是 agents as repos 理念的体现。⏱️ 7 个生命周期事件全解析GitAgent 在代理运行的 7 个关键时刻提供钩子挂载点完整定义见 src/hooks.ts事件触发时机能否拦截能否修改参数on_session_start会话开始、代理运行前✅❌pre_tool_use每次工具调用前✅✅pre_queryLLM 调用前✅❌post_tool_failure工具执行出错后❌❌post_responseLLM 返回响应后❌❌file_changed文件写入后❌❌on_error代理发生错误时❌❌ 规律很好记事前事件pre_可以拦截和改写事后事件post_、on_*用于日志、告警和审计。 三步配置你的第一个钩子第 1 步在hooks/hooks.yaml中声明hooks: pre_tool_use: - script: validate-command.sh description: 拦截危险 CLI 命令 on_error: - script: incident-report.sh框架启动时会通过loadHooksConfig自动加载该文件src/hooks.ts#L32-L42。第 2 步编写钩子脚本JSON 进、JSON 出钩子脚本通过stdin 接收 JSON 上下文通过stdout 返回 JSON 决策任何语言都能写// stdin 输入 {event: pre_tool_use, session_id: uuid, tool: cli, args: {command: rm -rf /}} // stdout 输出 {action: block, reason: Destructive command blocked}第 3 步理解三种动作HookResult定义见 src/hooks.ts#L26-L30allow放行继续执行脚本不返回 JSON 时默认放行block立即中止reason会反馈给代理modify用返回的args字段替换原始参数后继续执行。执行引擎src/hooks.ts#L44-L117有三个值得了解的安全设计10 秒超时——钩子卡死不会拖垮代理自动SIGTERM终止路径穿越防护——脚本路径被锁定在基础目录内无法逃逸故障不阻塞——钩子自身报错只记录日志不阻断主流程fail-safe。pre_tool_use最强钩子拦截 改参数这是唯一能同时拦截和修改参数的事件。框架通过wrapToolWithHooks给每个工具的execute方法包上一层钩子逻辑执行前先跑钩子遇到block直接抛错遇到modify则换用新参数src/hooks.ts#L150-L188。典型用法黑名单拦截rm -rf、DROP TABLE等破坏性命令自动把代理要写入的路径重定向到沙箱目录记录每一次工具调用形成完整审计轨迹。多个钩子按声明顺序依次执行一旦某个返回block或modify立即短路生效src/hooks.ts#L129-L144。 编程式 Hooks用 TypeScript 写钩子不想写 shell 脚本GitAgent SDK 提供进程内回调式钩子在 src/sdk-types.ts 中定义了GCHooks接口覆盖onSessionStart、preToolUse、preQuery、postToolFailure、postResponse、fileChanged、onError全部事件。核心包装逻辑见 src/sdk-hooks.tsconst result query({ hooks: { preToolUse: async (ctx) { if (ctx.toolName cli ctx.args.command.includes(rm)) { return { action: block, reason: Blocked rm command }; } return { action: allow }; }, }, });一行判断即可拦截危险操作类型提示完整适合嵌入 Node.js 应用。 插件也能注册钩子插件通过api.registerHook(event, handler)即可为四个核心事件on_session_start、pre_tool_use、post_response、on_error注册程序化钩子src/plugin-sdk.ts#L68-L71加载时自动与仓库级钩子合并src/plugins.ts。这意味着安全护栏可以像 npm 包一样被打包、复用、分发。️ 最佳实践速查场景推荐钩子权限校验、环境检查on_session_start危险命令拦截、参数改写pre_tool_use调用限流、成本控制pre_query工具失败告警post_tool_failure响应归档、敏感词审计post_response文件变更追踪file_changed事故上报on_error记住两条原则拦截用事前事件审计用事后事件——事后钩子没有拦截权别指望它们能阻止操作钩子要快——10 秒超时的限制意味着钩子里别做重活日志和告警应异步落盘。总结GitAgent Hooks 用极简的JSON 进、JSON 出协议为 AI 代理提供了完整的生命周期控制能力7 个挂载点覆盖从会话开始到错误处理的全过程block/modify/allow三种动作既能当安全护栏也能做审计引擎而 git 原生的配置文件让每条规则都可追溯、可回滚。配合框架内置的 审计模块 与 合规检查你可以轻松构建一个受控、可观测的 AI 代理系统。更多细节请参考 Documentation.md 中的 Hooks 章节。【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengap创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/20 0:44:51

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/19 15:17:14

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/20 20:45:42

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/20 16:11:20

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/20 18:41:01

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/20 0:44:55

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉