本系列共 10 阶段面向有 Go 后端基础的开发者全程用 Go 手写实现。当前进度阶段三 Tool Calling · 第 4 课21上一篇接入 DeepSeek 原生 Tool Calling上一课已经接通真实模型和工具注册表。现在工具数量增加模型也可能在一轮里返回多个调用单靠工具白名单已经不够。这一课要回答一个后端工程师最关心的问题当模型选择多个工具时Go 程序怎样控制参数、权限、时间、调用次数和错误信息一、本课学习目标学完本课你应该能够处理同一响应中的多个工具调用。校验调用 ID、类型、工具名称与 JSON 参数。为单次工具设置超时为整个任务设置调用预算。区分参数错误、业务错误和内部错误。安全地把可恢复错误转换成工具结果。使用单元测试验证注册表与执行边界。二、多工具调用的真实流程用户提出帮我搜索 Go Agent 相关文章并告诉我现在的时间。模型可能返回{tool_calls:[{id:call_001,type:function,function:{name:search_articles,arguments:{\keyword\:\Go Agent\,\limit\:10}}},{id:call_002,type:function,function:{name:get_current_time,arguments:{}}}]}执行过程是检查调用 ID 和类型 ↓ 每个 ID 是否唯一 ↓ 工具是否注册 ↓ JSON 与业务参数是否合法 ↓ 调用预算是否足够 ↓ 执行工具并关联结果模型可以决定“想调用哪些工具”但程序决定“是否真的允许执行”。三、三个不能混用的边界1. 参数格式校验例如{article_id:-1}这是合法 JSON整数类型也正确但文章 ID 不应该是负数。2. 业务规则校验文章 ID 是正数也不代表文章存在、状态允许编辑或者用户能够查看。3. 权限与副作用控制即使delete_article已注册、参数也合法Go 后端仍然要检查当前用户是谁。用户是否有权删除这篇文章。是否需要再次确认。是否有幂等和审计机制。Schema、参数校验和权限系统分别解决不同问题不能互相替代。四、统一校验工具调用假设前两课已经定义typeToolCallstruct{IDstringjson:idTypestringjson:typeFunction FunctionCalljson:function}typeFunctionCallstruct{Namestringjson:nameArgumentsstringjson:arguments}先检查同一轮是否存在空 ID 或重复 IDfuncValidateToolCalls(calls[]ToolCall)error{seen:make(map[string]struct{},len(calls))for_,call:rangecalls{ifstrings.TrimSpace(call.ID){returnErrInvalidToolCall}ifcall.Type!function{returnErrInvalidToolCall}if_,exists:seen[call.ID];exists{returnErrDuplicateToolCallID}seen[call.ID]struct{}{}}returnnil}重复 ID 会让两个工具结果无法可靠对应原调用因此属于协议错误不适合交给模型自行猜测。五、带超时和边界检查的执行器定义可分类错误var(ErrInvalidToolCallerrors.New(invalid tool call)ErrDuplicateToolCallIDerrors.New(duplicate tool call ID)ErrToolNotFounderrors.New(tool not found)ErrToolTimeouterrors.New(tool timeout)ErrToolDeniederrors.New(tool permission denied))注册表增加受控执行入口func(r*Registry)ExecuteChecked(ctx context.Context,call ToolCall,timeout time.Duration,)(any,error){ifstrings.TrimSpace(call.ID)||call.Type!function||strings.TrimSpace(call.Function.Name)||!json.Valid([]byte(call.Function.Arguments)){returnnil,ErrInvalidToolCall}iftimeout0{returnnil,ErrInvalidToolCall}r.mu.RLock()tool,ok:r.tools[call.Function.Name]r.mu.RUnlock()if!ok{returnnil,ErrToolNotFound}toolCtx,cancel:context.WithTimeout(ctx,timeout)defercancel()result,err:tool.Execute(toolCtx,json.RawMessage(call.Function.Arguments),)iferr!nil{iferrors.Is(toolCtx.Err(),context.DeadlineExceeded){returnnil,fmt.Errorf(%w: %v,ErrToolTimeout,err,)}returnnil,err}returnresult,nil}json.Valid只检查参数是不是合法 JSON具体对象类型、未知字段和业务约束仍由工具执行器负责。Context 也不会强制杀死任意 goroutine。数据库查询或 HTTP 请求必须真正使用该 Context超时才能传播到下游。六、限制工具调用总次数MaxRounds只限制模型请求轮数。模型可能在一轮内返回多个工具调用因此还需要独立的累计预算。typeCallBudgetstruct{MaxintUsedint}func(b*CallBudget)Take()error{ifb.Max0{returnerrors.New(工具调用预算无效)}ifb.Usedb.Max{returnerrors.New(工具调用次数超过限制)}b.Usedreturnnil}执行前逐条调用iferr:budget.Take();err!nil{return,err}result,err:registry.ExecuteChecked(ctx,call,toolTimeout,)只要进入一次执行尝试就应该占用预算包括最终返回业务错误或超时的调用。否则模型可以不断触发失败调用绕过限制。示例结构不是 goroutine 安全的。如果 Agent 会并发执行多个工具需要改用互斥锁、原子计数或每个任务独立预算。七、安全错误映射工具可能返回三类错误类别例子处理方式参数错误字段缺失、范围非法返回明确但不泄露内部细节的提示业务错误资源不存在、用户无权访问返回稳定业务错误码内部错误数据库连接失败、内部地址记录内部日志向模型返回通用错误可以定义统一结果typeToolErrorResultstruct{Codestringjson:codeMessagestringjson:message}funcSafeToolError(errerror)ToolErrorResult{switch{caseerrors.Is(err,ErrInvalidToolCall):returnToolErrorResult{Code:INVALID_TOOL_CALL,Message:工具调用格式不正确,}caseerrors.Is(err,ErrToolNotFound):returnToolErrorResult{Code:TOOL_NOT_FOUND,Message:请求的工具不可用,}caseerrors.Is(err,ErrToolTimeout):returnToolErrorResult{Code:TOOL_TIMEOUT,Message:工具执行超时,}caseerrors.Is(err,ErrToolDenied):returnToolErrorResult{Code:PERMISSION_DENIED,Message:当前操作没有权限,}default:returnToolErrorResult{Code:TOOL_EXECUTION_FAILED,Message:工具执行失败,}}}错误码要稳定便于模型和业务层判断原始内部错误应进入脱敏后的服务端日志而不是直接进入模型上下文。八、权限必须来自可信上下文假设模型请求删除文章{name:delete_article,arguments:{\article_id\:123}}不能让模型通过参数声明user_id或role: admin。用户身份应来自已有的 Go 认证上下文、Session 或 Token 校验结果。工具内部应调用现有 BIZ 层Agent Tool ↓ 业务服务检查用户与文章归属 ↓ 数据访问层而不是让 Agent 直接拼接 SQL 或跳过业务规则。九、为执行层编写测试创建registry_test.go先测纯逻辑不请求真实模型packagemainimport(contextencoding/jsonerrorstestingtime)typeEchoToolstruct{}func(EchoTool)Name()string{returnecho}func(EchoTool)Description()string{return返回输入消息}func(EchoTool)Parameters()json.RawMessage{returnjson.RawMessage({ type: object, properties: { message: {type: string} }, required: [message], additionalProperties: false })}func(EchoTool)Execute(ctx context.Context,raw json.RawMessage,)(any,error){varargsstruct{Messagestringjson:message}iferr:json.Unmarshal(raw,args);err!nil{returnnil,ErrInvalidToolCall}ifargs.Message{returnnil,ErrInvalidToolCall}select{case-ctx.Done():returnnil,ctx.Err()default:}returnmap[string]string{message:args.Message},nil}funcTestExecuteChecked(t*testing.T){registry:NewRegistry()iferr:registry.Register(EchoTool{});err!nil{t.Fatal(err)}call:ToolCall{ID:call_001,Type:function,Function:FunctionCall{Name:echo,Arguments:{message:hello},},}result,err:registry.ExecuteChecked(context.Background(),call,time.Second,)iferr!nil{t.Fatal(err)}got:result.(map[string]string)[message]ifgot!hello{t.Fatalf(got %q, want hello,got)}}funcTestRejectUnknownTool(t*testing.T){registry:NewRegistry()call:ToolCall{ID:call_002,Type:function,Function:FunctionCall{Name:delete_everything,Arguments:{},},}_,err:registry.ExecuteChecked(context.Background(),call,time.Second,)if!errors.Is(err,ErrToolNotFound){t.Fatalf(got %v, want ErrToolNotFound,err)}}运行go test./...go test-race./...测试应继续覆盖重复注册。空 ID、重复 ID 和非function类型。无效 JSON、未知字段和错误参数范围。单次超时与父 Context 取消。累计调用次数。权限拒绝和错误脱敏。十、本课总结多个工具调用必须逐条校验并分别关联各自的tool_call_id。参数合法不代表资源存在、用户有权限或副作用允许发生。单次工具超时与总调用预算控制不同资源。重复调用 ID 是协议错误应在执行前拒绝。交给模型的错误应稳定、脱敏内部诊断留在服务端日志。工具应调用已有 BIZ 层而不是让 Agent 绕过业务权限直接访问数据库。十一、课后练习练习 1轮数与调用数MaxRounds 4模型每轮最多返回 3 个调用。只限制轮数时理论上有多少调用参考答案最多 12 次。轮数限制不等于工具次数限制仍需独立的累计预算。练习 2合法参数能否直接删除delete_article已注册article_id123也是正整数是否可以直接执行参考答案不能。还要验证当前用户、文章归属、业务状态、审批要求和幂等性。练习 3超时能否直接重试调用支付工具 10 秒后超时是否可以立即再次支付参考答案不能。超时只表示没有按时拿到结果支付可能已经成功。应先按交易号或幂等键查询状态。下一篇Go AI Agent 实战 22完善 Agent 执行循环从工具调用到最终回答专栏Go 开发者学 AI Agent从大模型到工程落地
企业数字化 ERP 产品动态
相关推荐
Adapt-CLIP 文章目录AbstractIntroductionRelated WorksMethodProblem FormulationOverViewRevisiting CLIP for Anomaly DetectionAdaptCLIP with Alternating LearningVisual AdapterTextual AdapterAdaptCLIP with Comparative LearningPrompt-Query AdapterTraining and InferenceExpe… · 2026/11/21 1:10:19
Rust “一致性”和“孤儿规则”深度解读 文章目录1. 什么是一致性?2. 孤儿规则:杜绝多重实现,维持一致性3. Fundamental Types:孤儿规则排除在外的类型4. Covered Implementations:孤儿规则特许的为外部 type 实现外部 trait 的一类 impl5. 重新认识孤儿规则5… · 2026/11/8 2:36:06
cpp算法题目整理——二分查找篇 寻找食物储量
题目描述:
你是一个冒险家,在一个危机四伏的森林里,你发现了一个隐藏的食物仓库。这个食物仓库由 n 个房间组成,每个房间都有一定数量的食物。你需要找到第一个房间,其中的食物数量大于或等于一个给定的… · 2026/11/17 12:02:53
颍上哪有考电工证的,郑州报考避坑指南这样帮你省时又省心 颍上哪有考电工证的,郑州报考避坑指南这样帮你省时又省心 工地太忙根本没时间复习考试,这几乎是每个建筑工人心照不宣的痛点。特别是像低压电工、高压电工这样的特种作业操作证,关系到日常作业安全、工地合规性,也直接影响你的职业发展和收入水平。而很多… · 2026/11/21 1:10:03
泗洪考电工证在哪里考值不值得考 泗洪考电工证在哪里考值不值得考 实操考试心里没底怕挂科,这是很多准备报考电工证的朋友最真实的感受。尤其是对于泗洪本地的学员来说,不知道在哪里考、流程如何、考试难度怎样,心里总是没底。那这证到底值不值得考?看完这篇文章,你就会有自己的答案。… · 2026/11/21 1:10:03
咸阳在哪办电工证网上查询超全攻略,上岗找工作的你别错过 咸阳在哪办电工证网上查询超全攻略,上岗找工作的你别错过 急需特种作业证才能上岗找工作,你是不是也正在为【咸阳在哪办电工证】这个问题发愁?网上查了一大堆,结果还是云里雾里?别急,这篇文章就是为像你这样的打工人量身打造的。本文结合焦作培训机构学… · 2026/11/21 1:10:03
电工证年审试题技巧千万别踩坑:实操考试心里没底怕挂科怎么办 电工证年审试题技巧千万别踩坑:实操考试心里没底怕挂科怎么办 你是不是正在为电工证年审考试发愁?实操考试心里没底怕挂科,这几乎是每个初次报考或者即将复审的学员共同的焦虑。别急,今天我就以商丘地区初次报考人员的视角,带你一步步揭开【电工证年审试… · 2026/11/21 1:10:03
电线敷设需要电工证怎么考?学历不高也能拿,含金量超高! 电线敷设需要电工证怎么考?学历不高也能拿,含金量超高! 你是不是也觉得学历不高,怕报不上名?其实电线敷设需要电工证这事, 并不看学历高低 ,重点在你有没有实际操作经验。别小看这个证, 含金量… · 2026/11/21 1:10:03
河北考电工证包通过内部消息!证书过期了不知道怎么复审延期 河北考电工证包通过内部消息!证书过期了不知道怎么复审延期 证书过期了不知道怎么复审延期?别急,我这有一手 内部消息 ,专治“证过期”焦虑。尤其是河北的电工朋友们,你们的低压电工证、高压电工证如果已经到期或快到期,千万别慌,… · 2026/11/21 1:09:02
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17
房建企业特种工考前押题怎么找?别让培训费打了水漂 房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03