[{"data":1,"prerenderedAt":5555},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fagent\u002Ftool-use":886},[4,8,12,16,20,24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,159,162,165,169,172,175,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,269,273,277,281,285,288,291,294,298,301,304,307,310,313,316,319,322,325,329,332,336,340,344,348,352,356,359,362,365,368,371,374,377,380,383,386,389,393,396,399,402,405,408,411,414,417,420,424,428,432,435,438,442,446,450,454,458,462,466,470,474,477,480,483,487,491,494,497,500,504,507,511,515,518,521,524,527,530,533,536,539,542,545,548,551,554,557,560,563,566,569,572,575,579,583,587,591,595,599,603,606,610,614,617,620,623,626,629,633,637,640,643,646,649,652,655,658,661,664,667,670,673,676,679,682,685,688,691,694,697,700,703,706,709,712,716,720,724,728,732,736,740,744,748,752,756,760,764,768,772,775,779,783,787,790,793,796,799,802,805,808,811,814,818,822,825,829,832,835,838,841,844,848,851,854,858,862,865,869,873,876,879,882],{"path":5,"title":6,"description":7},"\u002Fabout\u002Fauthor","作者相关","只想纯粹的做一个程序员...",{"path":9,"title":10,"description":11},"\u002Fabout\u002Fjourney","心路历程","",{"path":13,"title":14,"description":15},"\u002Fai\u002Fagent\u002Fframeworks","Agent 框架","主流 Agent 框架：LangChain、LlamaIndex、AutoGen、CrewAI",{"path":17,"title":18,"description":19},"\u002Fai\u002Fagent\u002Fhooks","Agent Hooks 与自动化","Claude Agent 的 Hooks 生命周期、事件类型、典型自动化场景",{"path":21,"title":22,"description":23},"\u002Fai\u002Fagent\u002Fintroduction","AI Agent 概述","AI Agent 核心概念：感知、规划、执行、记忆",{"path":25,"title":26,"description":27},"\u002Fai\u002Fagent\u002Fpractice","Agent 实战","AI Agent 实战：构建自主任务执行系统",{"path":29,"title":30,"description":31},"\u002Fai\u002Fagent\u002Fsdk","Claude Agent SDK 开发","使用 Claude Agent SDK 构建自定义 AI Agent：架构、API、生命周期",{"path":33,"title":34,"description":35},"\u002Fai\u002Fagent\u002Fsubagents","Subagents 子代理","用 Subagents 分解复杂任务、并发执行、隔离上下文",{"path":37,"title":38,"description":39},"\u002Fai\u002Fagent\u002Ftool-use","工具调用","AI Agent 工具调用：Function Calling、Tool Use 原理与实践",{"path":41,"title":42,"description":43},"\u002Fai\u002Ffundamentals\u002Fdeep-learning","深度学习入门","深度学习基础知识：前向传播、反向传播、损失函数、优化器",{"path":45,"title":46,"description":47},"\u002Fai\u002Ffundamentals\u002Fml-basics","机器学习基础","机器学习核心概念：监督学习、无监督学习、强化学习",{"path":49,"title":50,"description":51},"\u002Fai\u002Ffundamentals\u002Fneural-networks","神经网络原理","神经网络架构：CNN、RNN、注意力机制",{"path":53,"title":54,"description":55},"\u002Fai\u002Fgetting-started","AI 学习路线","AI 技术学习路线图，从基础到实战的完整指南",{"path":57,"title":58,"description":59},"\u002Fai\u002Fllm\u002Ffine-tuning","模型微调","大模型微调技术：LoRA、QLoRA、全量微调、RLHF",{"path":61,"title":62,"description":63},"\u002Fai\u002Fllm\u002Fintroduction","大模型概述","大语言模型发展历程、核心能力与主流模型对比",{"path":65,"title":66,"description":67},"\u002Fai\u002Fllm\u002Flocal-deploy","本地部署","大模型本地部署：Ollama、vLLM、llama.cpp",{"path":69,"title":70,"description":71},"\u002Fai\u002Fllm\u002Ftransformer","Transformer 架构","Transformer 架构详解：自注意力机制、位置编码、多头注意力",{"path":73,"title":74,"description":75},"\u002Fai\u002Fmcp\u002Fclient","MCP Client 开发","MCP Client 开发指南：连接、调用、集成",{"path":77,"title":78,"description":79},"\u002Fai\u002Fmcp\u002Fdebugging","MCP 调试与排错","MCP Server 开发与集成过程中的常见问题、日志分析、诊断工具",{"path":81,"title":82,"description":83},"\u002Fai\u002Fmcp\u002Fintroduction","MCP 概述","Model Context Protocol 协议概述：架构、核心概念、应用场景",{"path":85,"title":86,"description":87},"\u002Fai\u002Fmcp\u002Fserver","MCP Server 开发","MCP Server 开发指南：资源、工具、提示词的实现",{"path":89,"title":90,"description":91},"\u002Fai\u002Fmcp\u002Ftools","MCP Tools 深入","深入理解 MCP Tools：与 Resources\u002FPrompts 的差异、Schema 设计、Annotations 与权限控制",{"path":93,"title":94,"description":95},"\u002Fai\u002Fprompt\u002Fadvanced","高级 Prompt 模式","高级 Prompt 设计模式：Tree-of-Thought、自我反思、多轮对话策略",{"path":97,"title":98,"description":99},"\u002Fai\u002Fprompt\u002Fbasics","Prompt 基础","Prompt Engineering 入门：基本概念、角色设定、输出格式控制",{"path":101,"title":102,"description":103},"\u002Fai\u002Fprompt\u002Ftechniques","提示词技巧","常用提示词技巧：Few-shot、Chain-of-Thought、ReAct",{"path":105,"title":106,"description":107},"\u002Fai\u002Frag\u002Fembedding","文本嵌入","文本嵌入模型：Embedding 原理、模型选择、相似度计算",{"path":109,"title":110,"description":111},"\u002Fai\u002Frag\u002Fintroduction","RAG 概述","检索增强生成（RAG）架构原理、优势与应用场景",{"path":113,"title":114,"description":115},"\u002Fai\u002Frag\u002Fpractice","RAG 实战","RAG 应用实战：文档问答系统、知识库搭建",{"path":117,"title":118,"description":119},"\u002Fai\u002Frag\u002Fvector-database","向量数据库","主流向量数据库对比：Milvus、Pinecone、Chroma、Weaviate",{"path":121,"title":122,"description":123},"\u002Fai\u002Fskills\u002Fbest-practices","Skill 最佳实践","编写高质量 Skill 的设计原则、常见陷阱与优化技巧",{"path":125,"title":126,"description":127},"\u002Fai\u002Fskills\u002Fcreating","创建自定义 Skill","从零编写一个可被 Agent 自动发现和调用的 Skill",{"path":129,"title":130,"description":131},"\u002Fai\u002Fskills\u002Fintroduction","Agent Skills 概述","Claude Agent Skills 概念、工作原理、与 Tools\u002FMCP 的区别",{"path":133,"title":134,"description":135},"\u002Fgolang\u002Fadvanced\u002Fconcurrency","Go - 并发深入","深入理解 Go 并发编程的核心机制。",{"path":137,"title":138,"description":139},"\u002Fgolang\u002Fadvanced\u002Fgc","Go - 垃圾回收","理解 Go 的垃圾回收机制，掌握 GC 调优方法。",{"path":141,"title":142,"description":143},"\u002Fgolang\u002Fadvanced\u002Fgmp","Go - GMP 调度模型","GMP 是 Go 运行时调度器的核心模型，理解它对于编写高性能 Go 程序至关重要。",{"path":145,"title":146,"description":147},"\u002Fgolang\u002Fadvanced\u002Fgo-concurrency","Go - 并发编程","Go 的并发是其核心特性之一，通过 Goroutine 和 Channel 实现。",{"path":149,"title":150,"description":151},"\u002Fgolang\u002Fadvanced\u002Fmemory","Go - 内存模型","理解 Go 的内存分配机制和内存模型。",{"path":153,"title":154,"description":155},"\u002Fgolang\u002Fadvanced\u002Fprofiling","Go - 性能分析","掌握 Go 的性能分析工具：pprof、trace、benchmark。",{"path":157,"title":158,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-basic","Go - 基础语法",{"path":160,"title":161,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-composite","Go - 复合类型",{"path":163,"title":164,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-control","Go - 流程控制",{"path":166,"title":167,"description":168},"\u002Fgolang\u002Fcore\u002Fgo-error","Go - 错误处理","Go 使用显式的错误返回值来处理错误，而不是异常机制。",{"path":170,"title":171,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-function","Go - 函数",{"path":173,"title":174,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-install","Go - 环境搭建",{"path":176,"title":177,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-interface","Go - 接口",{"path":179,"title":180,"description":181},"\u002Fgolang\u002Fcore\u002Fgo-module","Go - 包管理","Go Modules 是 Go 1.11 引入的官方依赖管理方案，Go 1.16 后成为默认模式。",{"path":183,"title":184,"description":185},"\u002Fgolang\u002Fdistributed\u002Fgrpc","Go - gRPC","gRPC 是 Google 开发的高性能 RPC 框架，使用 Protocol Buffers 作为序列化协议。",{"path":187,"title":188,"description":189},"\u002Fgolang\u002Fdistributed\u002Fmicroservice","Go - 微服务","微服务架构的核心组件：服务发现、负载均衡、熔断降级。",{"path":191,"title":192,"description":193},"\u002Fgolang\u002Fdistributed\u002Fmq","Go - 消息队列","使用 Go 操作 Kafka 和 RabbitMQ。",{"path":195,"title":196,"description":197},"\u002Fgolang\u002Fdistributed\u002Fredis","Go - Redis","使用 go-redis 操作 Redis，实现缓存、分布式锁等功能。",{"path":199,"title":200,"description":201},"\u002Fgolang\u002Fengineering\u002Fconfig","Go - 配置管理","使用 viper 进行配置管理，支持多种配置格式和配置中心。",{"path":203,"title":204,"description":205},"\u002Fgolang\u002Fengineering\u002Fdocker","Go - Docker 部署","使用 Docker 容器化部署 Go 应用。",{"path":207,"title":208,"description":209},"\u002Fgolang\u002Fengineering\u002Fkubernetes","Go - Kubernetes 部署","在 Kubernetes 上部署和管理 Go 应用。",{"path":211,"title":212,"description":213},"\u002Fgolang\u002Fengineering\u002Flogging","Go - 日志系统","使用 zap 和 logrus 构建高性能结构化日志系统。",{"path":215,"title":216,"description":217},"\u002Fgolang\u002Fengineering\u002Ftesting","Go - 单元测试","Go 内置了强大的测试框架，掌握测试是编写高质量代码的基础。",{"path":219,"title":220,"description":221},"\u002Fgolang\u002Fstdlib\u002Fbufio","bufio","在 Go 语言中，bufio 包提供了带缓冲的 I\u002FO 操作，能够提高读写性能。以下是一些常用的 bufio 包 API 及其详细说明：",{"path":223,"title":224,"description":225},"\u002Fgolang\u002Fstdlib\u002Fcontainer","container","在Go语言标准库中，container 包提供了几种常用的数据结构实现，这些数据结构对于高效地管理和操作数据非常有用。以下是 container 包中主要的数据结构：",{"path":227,"title":228,"description":229},"\u002Fgolang\u002Fstdlib\u002Fcrypto","crypto","在 Go 语言中，crypto 包提供了一组用于加密和解密的功能。以下是一些常用的 crypto 包及其子包的 API 及其详细说明：",{"path":231,"title":232,"description":233},"\u002Fgolang\u002Fstdlib\u002Fencoding-csv","encoding\u002Fcsv","在 Go 语言中，encoding\u002Fcsv 包提供了对 CSV（逗号分隔值）文件进行读写的功能。以下是一些常用的 encoding\u002Fcsv 包的 API 及其详细说明：",{"path":235,"title":236,"description":237},"\u002Fgolang\u002Fstdlib\u002Fencoding-json","encoding\u002Fjson","在 Go 语言中，encoding\u002Fjson 包提供了对 JSON 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fjson 包的 API 及其详细说明：",{"path":239,"title":240,"description":241},"\u002Fgolang\u002Fstdlib\u002Fencoding-xml","encoding\u002Fxml","在 Go 语言中，encoding\u002Fxml 包提供了对 XML 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fxml 包的 API 及其详细说明：",{"path":243,"title":244,"description":245},"\u002Fgolang\u002Fstdlib\u002Fflag","flag","在Go语言中，flag 包是用于处理命令行参数的标准库，它提供了一种简单而直接的方式来解析和使用命令行参数。下面是关于 flag 包的一些基本介绍和常用功能：",{"path":247,"title":248,"description":249},"\u002Fgolang\u002Fstdlib\u002Ffmt","fmt","在 Go 语言的标准库中，fmt 包是非常重要的，它提供了处理格式化输入和输出的基本工具。以下是一些 fmt 包内常用的API：",{"path":251,"title":252,"description":253},"\u002Fgolang\u002Fstdlib\u002Fhttp","net\u002Fhttp","在 Go 语言中，net\u002Fhttp 包提供了用于构建 HTTP 客户端和服务器的强大工具。以下是一些常用的 net\u002Fhttp 包的 API 及其详细说明：",{"path":255,"title":256,"description":257},"\u002Fgolang\u002Fstdlib\u002Fio","io","在 Go 语言中，io 包提供了基本的输入输出功能。以下是一些常用的 io 包的 API 及其详细说明：",{"path":259,"title":260,"description":261},"\u002Fgolang\u002Fstdlib\u002Flog","log","在 Go 语言中，log 包提供了简单的日志记录功能。以下是一些常用的 log 包的 API 及其详细说明：",{"path":263,"title":264,"description":265},"\u002Fgolang\u002Fstdlib\u002Fmath","math","在 Go 语言中，math 包提供了基本的数学函数和常量。以下是一些常用的 math 包的 API 及其详细说明：",{"path":267,"title":268,"description":11},"\u002Fgolang\u002Fstdlib\u002Fnet","net",{"path":270,"title":271,"description":272},"\u002Fgolang\u002Fstdlib\u002Fos","os","在Go语言中，os 包是一个非常重要且常用的标准库，它提供了与操作系统交互的功能，包括文件操作、环境变量管理、进程管理等。下面是一些 os 包中常用的功能和API：",{"path":274,"title":275,"description":276},"\u002Fgolang\u002Fstdlib\u002Fsort","order","在 Go 语言中，sort 包提供了对切片和用户定义的集合进行排序的函数。它实现了常见的排序算法，如快速排序（Quicksort）和堆排序（Heapsort），并且为自定义集合提供了接口，使得用户可以根据特定的需求进行排序。",{"path":278,"title":279,"description":280},"\u002Fgolang\u002Fstdlib\u002Fstrconv","strconv","在 Go 语言中，strconv 包提供了字符串和基本数据类型之间的转换函数，例如将整数转换为字符串、字符串转换为整数，以及其他类型之间的转换。这些功能非常有用，特别是在处理用户输入或从外部数据源读取数据时。",{"path":282,"title":283,"description":284},"\u002Fgolang\u002Fstdlib\u002Ftime","time","在 Go 语言中，time 包提供了处理时间和日期的功能。以下是一些常用的 time 包的 API 及其详细说明：",{"path":286,"title":287,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ferror","Gin - 错误处理",{"path":289,"title":290,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ffile","Gin - 文件处理",{"path":292,"title":293,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fmiddleware","Gin - 中间件",{"path":295,"title":296,"description":297},"\u002Fgolang\u002Fweb\u002Fgin\u002Fquickstart","Gin - 快速开始","Gin 是目前最流行的 Go Web 框架，以高性能和简洁 API 著称。",{"path":299,"title":300,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frequest","Gin - 请求处理",{"path":302,"title":303,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fresponse","Gin - 响应处理",{"path":305,"title":306,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frouter","Gin - 路由",{"path":308,"title":309,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fvalidation","Gin - 参数校验",{"path":311,"title":312,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fassociation","GORM - 关联关系",{"path":314,"title":315,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fcrud","GORM - CRUD 操作",{"path":317,"title":318,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fmodel","GORM - 模型定义",{"path":320,"title":321,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fperformance","GORM - 日志与性能",{"path":323,"title":324,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquery","GORM - 高级查询",{"path":326,"title":327,"description":328},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquickstart","GORM - 快速开始","GORM 是 Go 语言最流行的 ORM 库，功能强大，使用简单。",{"path":330,"title":331,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Ftransaction","GORM - 事务与 Hook",{"path":333,"title":334,"description":335},"\u002Finterview\u002Fbasic","计算机基础面经","本章节汇总了面试中常见的通用技术概念，不局限于特定语言或数据库，是考察技术内功的关键考点。",{"path":337,"title":338,"description":339},"\u002Finterview\u002Fgolang","Golang 面试题","Go 语言面试高频考点，覆盖基础语法、数据结构、并发编程、内存管理、GC、调度器等核心知识。",{"path":341,"title":342,"description":343},"\u002Finterview\u002Fk8s","Kubernetes 面试题","Kubernetes（K8s）面试高频考点，覆盖架构原理、核心资源、网络存储、调度策略、运维监控等核心知识。",{"path":345,"title":346,"description":347},"\u002Finterview\u002Fmysql","MySQL 面试题","MySQL 数据库面试高频考点，覆盖索引、事务、锁、优化、主从复制等核心知识。",{"path":349,"title":350,"description":351},"\u002Finterview\u002Fredis","Redis 面试题","Redis 面试高频考点，覆盖数据结构、持久化、集群、缓存一致性、性能优化等核心知识。",{"path":353,"title":354,"description":355},"\u002Finterview\u002Frocketmq","RocketMQ 面试题","RocketMQ 面试高频考点，覆盖消息模型、可靠性、顺序消息、事务消息、存储与高可用等核心知识。",{"path":357,"title":358,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-arraylist","List - ArrayList 源码解析",{"path":360,"title":361,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-linkedlist","List - LinkedList 源码解析",{"path":363,"title":364,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-stack","List - Satck源码解析",{"path":366,"title":367,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-vectore","List - Vector 源码解析",{"path":369,"title":370,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-hashmap","Map - HashMap 源码解析",{"path":372,"title":373,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-linkedhashmap","Map - LinkedHashMap 源码解析",{"path":375,"title":376,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-treemap","Map - TreeMap 源码解析",{"path":378,"title":379,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-deque","Queue - Deque 接口解析",{"path":381,"title":382,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-queue","Queue - Queue 接口解析",{"path":384,"title":385,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-hashset","Set - HashSet源码解析",{"path":387,"title":388,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-linkedhashset","Set - LinkedHashSet 源码解析",{"path":390,"title":391,"description":392},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-treeset","Set - TreeSet源码解析","TreeSet 是一个 Set 集合接口的实现类，与 HashSet 类似，其底层也是通过维护了一个 TreeMap 对象来封装了一些实现方法，故本篇不再对 TreeSet 的底层原理进行详细说明，仅对常用 API 做简单介绍，如需了解 TreeMap 的底层实现原理，请移步 Map - HashMap 源码解析",{"path":394,"title":395,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fannotation","Java核心 - 注解",{"path":397,"title":398,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fbasic-grammar","Java核心 - 基础语法",{"path":400,"title":401,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fclass-and-object","Java核心 - 面向对象",{"path":403,"title":404,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fcommon-classes","Java核心 - 常用类",{"path":406,"title":407,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fexception","Java核心 - 异常处理",{"path":409,"title":410,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fgenerics","Java核心 - 泛型",{"path":412,"title":413,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fjdk-env-path","Java核心 - 环境搭建",{"path":415,"title":416,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Freflection","Java核心 - 反射",{"path":418,"title":419,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fstring","Java核心 - String 字符串",{"path":421,"title":422,"description":423},"\u002Fother\u002Fjava\u002Fio\u002Fbuffer-stream","Java IO - 缓冲流","缓冲流是对基本流的包装，通过内置缓冲区减少系统调用次数，大幅提升读写效率。",{"path":425,"title":426,"description":427},"\u002Fother\u002Fjava\u002Fio\u002Fbyte-stream","Java IO - 字节流","字节流是 Java IO 中最基本的流类型，以字节（byte）为单位进行数据读写，可以处理任意类型的文件。",{"path":429,"title":430,"description":431},"\u002Fother\u002Fjava\u002Fio\u002Fchar-stream","Java IO - 字符流","字符流以字符为单位进行读写，专门用于处理文本文件。相比字节流，字符流能够正确处理字符编码，避免中文乱码问题。",{"path":433,"title":434,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Ffile","Java IO - File 类",{"path":436,"title":437,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Fio-stream-system","Java IO - IO流概述",{"path":439,"title":440,"description":441},"\u002Fother\u002Fjava\u002Fio\u002Fnio","Java IO - NIO","NIO（New IO）是 JDK 1.4 引入的新 IO 模型，提供了更高效的 IO 操作方式，支持非阻塞 IO 和多路复用。",{"path":443,"title":444,"description":445},"\u002Fother\u002Fjava\u002Fjvm\u002Fclass-loading","类加载机制","类加载机制是 JVM 将 .class 文件加载到内存，并对数据进行校验、转换解析和初始化，最终形成可被 JVM 直接使用的 Java 类型的过程。",{"path":447,"title":448,"description":449},"\u002Fother\u002Fjava\u002Fjvm\u002Fgarbage-collection","垃圾回收","垃圾回收（Garbage Collection，GC）是 JVM 自动管理内存的机制，负责回收不再使用的对象所占用的内存。",{"path":451,"title":452,"description":453},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-memory","JVM 内存结构","JVM 在执行 Java 程序时，会把它管理的内存划分为若干个不同的数据区域。这些区域有各自的用途、创建和销毁时间。",{"path":455,"title":456,"description":457},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-tuning","JVM 调优","JVM 调优是优化 Java 应用性能的重要手段，主要包括参数配置、性能监控和问题排查。",{"path":459,"title":460,"description":461},"\u002Fother\u002Fjava\u002Fthread\u002Fatomic","原子类","Java 原子类（Atomic Classes）提供了一种无锁的线程安全方式，基于 CAS（Compare-And-Swap）操作实现。",{"path":463,"title":464,"description":465},"\u002Fother\u002Fjava\u002Fthread\u002Fcompletable-future","CompletableFuture","CompletableFuture 是 JDK 8 引入的异步编程工具，实现了 Future 和 CompletionStage 接口，支持函数式编程和链式调用。",{"path":467,"title":468,"description":469},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-collections","并发集合","Java 并发包提供了多种线程安全的集合类，用于替代传统的同步集合（如 Collections.synchronizedList）。",{"path":471,"title":472,"description":473},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-utils","并发工具类","Java 并发包提供了多种实用的并发工具类，用于控制线程之间的协调与同步。",{"path":475,"title":476,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fsynchronized-lock","同步机制",{"path":478,"title":479,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-basic","线程基础",{"path":481,"title":482,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-pool","线程池",{"path":484,"title":485,"description":486},"\u002Fother\u002Fspring-series\u002Fspring\u002Fannotations-beans","Spring - 基于注解管理Bean","从 Java 5 开始，Java 增加了对注解（Annotation）的支持，它是代码中的一种特殊标记，可以在编译、类加载和运行时被读取，执行相应的处理。开发人员可以通过注解在不改变原有代码和逻辑的情况下，在源代码中嵌入补充信息。",{"path":488,"title":489,"description":490},"\u002Fother\u002Fspring-series\u002Fspring\u002Fimplement-ioc","Spring - 原理手写IoC","Spring 框架的 IOC 是基于 Java 反射机制实现的，在学习手写 IoC 之前，你需要具备一定的 Java 反射相关的知识，参考本站内的 Java 教程。",{"path":492,"title":493,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fintroduction-case","Spring - 入门案例",{"path":495,"title":496,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aop","Spring - 面向切面AOP",{"path":498,"title":499,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aot","Spring - AOT提前编译",{"path":501,"title":502,"description":503},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-data-validation","Spring - 数据校验","在开发中，我们经常遇到参数校验的需求，比如用户注册的时候，要校验用户名不能为空、用户名长度不超过20个字符、手机号是合法的手机号格式等等。如果使用普通方式，我们会把校验的代码和真正的业务处理逻辑耦合在一起，而且如果未来要新增一种校验逻辑也需要在修改多个地方。而spring validation允许通过注解的方式来定义对象校验规则，把校验和业务逻辑分离开，让代码编写更加方便。Spring Validation其实就是对Hibernate Validator进一步的封装，方便在Spring中使用。",{"path":505,"title":506,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-i18n","Spring - 国际化i18n",{"path":508,"title":509,"description":510},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-ioc","Spring - IOC容器","IoC 是 Inversion of Control 的简写，译为“控制反转”，它不是一门技术，而是一种设计思想，是一个重要的面向对象编程法则，能够指导我们如何设计出松耦合、更优良的程序。",{"path":512,"title":513,"description":514},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-junit","Spring - 单元测试JUnit","在之前的测试方法中，几乎都能看到以下的两行代码：",{"path":516,"title":517,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-resources","Spring - 资源操作",{"path":519,"title":520,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-summarize","Spring - Spring概述",{"path":522,"title":523,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-transaction","Spring - 事务",{"path":525,"title":526,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fxml-beans","Spring - 基于XML管理Bean",{"path":528,"title":529,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-config","SpringBoot - 配置详解",{"path":531,"title":532,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-data","SpringBoot - 数据访问",{"path":534,"title":535,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-quickstart","SpringBoot - 快速入门",{"path":537,"title":538,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-web","SpringBoot - Web 开发",{"path":540,"title":541,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-config","SpringCloud - 配置中心",{"path":543,"title":544,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-discovery","SpringCloud - 服务注册与发现",{"path":546,"title":547,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-feign","SpringCloud - 服务调用",{"path":549,"title":550,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-gateway","SpringCloud - 服务网关",{"path":552,"title":553,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-introduction","SpringCloud - 微服务概述",{"path":555,"title":556,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-sentinel","SpringCloud - 服务保护",{"path":558,"title":559,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-databind","SpringMVC - 数据绑定与转换",{"path":561,"title":562,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-exception","SpringMVC - 异常处理",{"path":564,"title":565,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-interceptor","SpringMVC - 拦截器",{"path":567,"title":568,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-introduction","SpringMVC - 简介与环境搭建",{"path":570,"title":571,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-request","SpringMVC - 请求处理",{"path":573,"title":574,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-response","SpringMVC - 响应处理",{"path":576,"title":577,"description":578},"\u002Fproject\u002Frocket-leaf\u002Farchitecture","项目架构","Rocket-Leaf 的目录结构、模块划分、数据流向，以及各层之间的依赖关系。",{"path":580,"title":581,"description":582},"\u002Fproject\u002Frocket-leaf\u002Fbackend-layers","后端分层设计","Rocket-Leaf 的 model \u002F rocketmq \u002F service 三层结构，以及服务之间的依赖关系与设计取舍。",{"path":584,"title":585,"description":586},"\u002Fproject\u002Frocket-leaf\u002Fclient-manager","RocketMQ 客户端管理器","AdminClientManager 的多客户端池、默认连接懒加载、自动重连重试的设计与实现。",{"path":588,"title":589,"description":590},"\u002Fproject\u002Frocket-leaf\u002Fencryption","连接信息加密存储","AES-256-GCM + SHA-256 字段级派生密钥的实现，以及如何在不破坏兼容性的前提下为历史明文数据做透明迁移。",{"path":592,"title":593,"description":594},"\u002Fproject\u002Frocket-leaf\u002Ffrontend","前端结构与类型绑定","React + Vite 目录组织、自动生成的 Wails 绑定、api 薄封装与自定义 hooks 的职责划分。",{"path":596,"title":597,"description":598},"\u002Fproject\u002Frocket-leaf","项目简介","Rocket-Leaf 是一款基于 Wails v3 构建的跨平台 RocketMQ 桌面管理客户端，Go 后端 + React 前端。本文档系列拆解它的架构与关键实现。",{"path":600,"title":601,"description":602},"\u002Fproject\u002Frocket-leaf\u002Fwails-v3","Wails v3 入门","Wails v3 的核心概念、Service 绑定机制，以及 Rocket-Leaf 是如何用它把 Go 后端和 React 前端打通的。",{"path":604,"title":605,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-basic","Docker - 入门基础",{"path":607,"title":608,"description":609},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-compose","Docker - Compose","在部署应用时，常常使用到不止一个容器，那么在部署容器的时候就需要一个一个进行部署，这样的部署过程也相对来说比较繁琐复杂，也容易出问题，那么有没有一种更为简单的方法呢？",{"path":611,"title":612,"description":613},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-container-connection","Docker - 容器互联","在上一个章节中我们学习了 Docker 容器的端口映射，可以将 Docker 容器和本地以及网络中的端口进行连接起来。",{"path":615,"title":616,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-dockerfile","Docker - Dockerfile",{"path":618,"title":619,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-helloworld","Docker - HelloWorld",{"path":621,"title":622,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-install","Docker - 安装",{"path":624,"title":625,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-introduce","Docker - 简介",{"path":627,"title":628,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-object","Docker - 镜像、容器、仓库",{"path":630,"title":631,"description":632},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-warehouse","Docker - 仓库管理","仓库是集中存放资源的地方，代码仓库是存放代码的，那么Docker 中的仓库就是存放 Docker 镜像的。",{"path":634,"title":635,"description":636},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-web-containers","Docker - WEB应用实例","在之前的章节中，仅对普通容器进行了演示，但在实际中常常使用到 Docker 容器中的 WEB 应用程序。",{"path":638,"title":639,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-config","Kubernetes - ConfigMap 与 Secret",{"path":641,"title":642,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-helm","Kubernetes - Helm 包管理",{"path":644,"title":645,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-install","Kubernetes - 集群安装",{"path":647,"title":648,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-introduction","Kubernetes - 简介与架构",{"path":650,"title":651,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-kubectl","Kubernetes - kubectl 命令行工具",{"path":653,"title":654,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-monitoring","Kubernetes - 监控与日志",{"path":656,"title":657,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-network-security","Kubernetes - 网络与安全",{"path":659,"title":660,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-service","Kubernetes - Service 与 Ingress",{"path":662,"title":663,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-storage","Kubernetes - 持久化存储",{"path":665,"title":666,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-workload","Kubernetes - 工作负载资源",{"path":668,"title":669,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-bash","Linux - Bash 基础语法",{"path":671,"title":672,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-file-directory","Linux - 文件与目录操作",{"path":674,"title":675,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-network","Linux - 网络配置",{"path":677,"title":678,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-package","Linux - 软件包管理",{"path":680,"title":681,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-process","Linux - 进程管理",{"path":683,"title":684,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-scripts","Linux - 常用脚本示例",{"path":686,"title":687,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-service","Linux - 服务管理",{"path":689,"title":690,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-user-permission","Linux - 用户与权限管理",{"path":692,"title":693,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-https","Nginx - HTTPS 配置",{"path":695,"title":696,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-install","Nginx - 安装与配置",{"path":698,"title":699,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-loadbalance","Nginx - 负载均衡",{"path":701,"title":702,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-optimization","Nginx - 性能优化",{"path":704,"title":705,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-proxy","Nginx - 反向代理",{"path":707,"title":708,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-static","Nginx - 静态资源服务",{"path":710,"title":711,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-vhost","Nginx - 虚拟主机配置",{"path":713,"title":714,"description":715},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-architecture","MySQL 高可用架构","主从复制、读写分离、分库分表。",{"path":717,"title":718,"description":719},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-index","MySQL 索引","索引是帮助 MySQL 高效获取数据的有序数据结构。",{"path":721,"title":722,"description":723},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-lock","MySQL 锁","锁用于解决并发访问时的数据一致性问题。",{"path":725,"title":726,"description":727},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-optimize","MySQL 性能优化","SQL 优化是后端开发必备技能。",{"path":729,"title":730,"description":731},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-transaction","MySQL 事务","事务是一组不可分割的操作，要么全部成功，要么全部失败。",{"path":733,"title":734,"description":735},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-advanced","SQL 进阶","多表查询、子查询、函数、视图、存储过程。",{"path":737,"title":738,"description":739},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-basic","SQL 基础","SQL（Structured Query Language）是操作关系型数据库的标准语言。",{"path":741,"title":742,"description":743},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-advanced","Redis 进阶功能","事务、发布订阅、Lua 脚本、Pipeline。",{"path":745,"title":746,"description":747},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-basic","Redis 基础","Redis 安装配置与基本命令。",{"path":749,"title":750,"description":751},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-cluster","Redis 高可用","主从复制、哨兵、Cluster 集群。",{"path":753,"title":754,"description":755},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-datatype","Redis 数据类型","Redis 5 种基本数据类型 + 4 种特殊类型。",{"path":757,"title":758,"description":759},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-optimize","Redis 性能优化","内存优化、缓存问题、最佳实践。",{"path":761,"title":762,"description":763},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-persistence","Redis 持久化","Redis 提供 RDB 和 AOF 两种持久化方式。",{"path":765,"title":766,"description":767},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-principle","Redis 底层原理","数据结构、线程模型、网络模型。",{"path":769,"title":770,"description":771},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fbehaiver-patterns\u002Fobserver-pattern","观察者模式","观察者模式属于行为型模式，定义了对象之间的一对多的依赖关系，在这种模式中，当一个对象的状态发生变化时，所有依赖于它的对象都会得到通知，并且执行相关操作。观察者模式又被成为“发布—订阅模式”，即发布者发生改变后，会通知所有订阅者。",{"path":773,"title":774,"description":11},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Ffactory-pattern","工厂模式",{"path":776,"title":777,"description":778},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Fsingleton-pattern","单例模式","单例模式是最常用的设计模式之一，他可以保证在整个应用中，某个类只存在一个实例化对象，即全局使用到该类的只有一个对象，这种模式在需要限制某些类的实例数量时非常有用，通常全局只需要一个该对象即可，如一些配置文件映射对象、数据库连接对象等。",{"path":780,"title":781,"description":782},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fstructural-patterns\u002Fadapter-pattern","适配器模式","适配器模式是一种结构型模式，可以将一个类的接口转换成客户端所期望的另一种接口，适配器模式可以帮助开发人员在不修改现有代码的情况下，将不兼容的类组合在一起。",{"path":784,"title":785,"description":786},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-basic-operations","Git 创建版本库","在 Git 上创建版本库有两种方式，一种是直接拷贝远程 Git 仓库到本地，另外一种是我们自己创建本地的版本库。",{"path":788,"title":789,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-branch-manage","Git 分支管理",{"path":791,"title":792,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-content-operations","Git 仓库内容操作",{"path":794,"title":795,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-introduce-install","Git 介绍和安装",{"path":797,"title":798,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-remote-manage","Git 远程管理",{"path":800,"title":801,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-workspace-index-repo","Git 工作原理",{"path":803,"title":804,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fhomebrew","HomeBrew 教程",{"path":806,"title":807,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fidea\u002Fshortcuts","快捷键",{"path":809,"title":810,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fmaven\u002Fintroduce-install-config","Maven - 介绍、安装、配置",{"path":812,"title":813,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fbasic-knowledge","2. 基础知识",{"path":815,"title":816,"description":817},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomponent-communication","9. 组件通信","在前面的章节内，介绍了 Vue 中最核心的内容——组件的介绍和使用，和 Java 等编程语言相反，组件并不近似于这些变成语言中的类，类可以通过类或者其实例化的对象来相互交互，但 Vue 组件之间的作用域是相互独立的，这就意味着不同组件之间的数据无法相互引用。",{"path":819,"title":820,"description":821},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomputed","4. 计算属性","虽然直接在模板中使用表达式方便，但是如果在模板中添加很多逻辑，会让模板变的臃肿且难维护，耦合度较高。有没有一种简单的方式来实现呢？答案是有的。",{"path":823,"title":824,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcreate-vue-project","1. 环境搭建及安装",{"path":826,"title":827,"description":828},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Flife-cycle","6. 生命周期","生命周期是指组件从创建、挂载、更新到销毁的整个过程中所经历的一系列阶段。在 Vue 中，每个组件都有自己的生命周期，可以通过生命周期钩子函数来监听和处理组件在不同阶段的行为和状态。",{"path":830,"title":831,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fother-api","10. 其他 API",{"path":833,"title":834,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fpinia","8. Pinia",{"path":836,"title":837,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Frouter","7. 路由",{"path":839,"title":840,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Ftemplate-grammar","3. 指令及模板语法",{"path":842,"title":843,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fvue3-new-component","11. Vue3 新组件",{"path":845,"title":846,"description":847},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fwatch","5. 监视","Watch 是 Vue 提供的一个用于监视响应式数据变化并执行相应操作的 API，能够对响应式数据的变化做出一些操作的功能。Vue3 中的 Watch 支持多种用法，包括监视响应式对象、ref 对象、数组、函数等。",{"path":849,"title":850,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-introduction","Kafka 简介与安装",{"path":852,"title":853,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-producer-consumer","Kafka 生产者与消费者",{"path":855,"title":856,"description":857},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-springboot","Spring Boot 整合 Kafka","Spring Kafka 提供了对 Apache Kafka 的便捷集成。",{"path":859,"title":860,"description":861},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-exchange","RabbitMQ Exchange 详解","Exchange（交换机）是 RabbitMQ 的核心组件，负责接收生产者发送的消息，并根据规则将消息路由到一个或多个队列。",{"path":863,"title":864,"description":11},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-introduction","RabbitMQ 简介与安装",{"path":866,"title":867,"description":868},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-reliability","RabbitMQ 消息可靠性","消息可靠性是消息队列的核心要求，RabbitMQ 提供了多种机制来保证消息不丢失。",{"path":870,"title":871,"description":872},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-springboot","Spring Boot 整合 RabbitMQ","Spring AMQP 提供了对 RabbitMQ 的便捷集成，大大简化了开发工作。",{"path":874,"title":875,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-client","RocketMQ 客户端使用",{"path":877,"title":878,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-concepts","RocketMQ 核心概念",{"path":880,"title":881,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-installation","RocketMQ 安装部署",{"path":883,"title":884,"description":885},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-message-type","RocketMQ 消息类型","RocketMQ 支持多种消息类型，满足不同业务场景需求。",{"id":887,"title":38,"body":888,"description":39,"extension":5550,"meta":5551,"navigation":1301,"path":37,"seo":5552,"stem":5553,"__hash__":5554},"docs\u002Fai\u002Fagent\u002Ftool-use.md",{"type":889,"value":890,"toc":5532},"minimark",[891,895,904,907,918,921,924,964,968,972,975,996,1257,1261,1265,1268,2439,2443,2447,2450,3334,3338,3462,3465,3468,3858,3861,3864,3869,4022,4026,4125,4129,4285,4289,4490,4494,4540,4543,4546,4549,5493,5496,5499,5525,5528],[892,893,894],"h2",{"id":894},"什么是工具调用",[896,897,898,899,903],"p",{},"工具调用（Tool Use \u002F Function Calling）是 AI Agent 最核心的能力之一。它允许大语言模型在推理过程中",[900,901,902],"strong",{},"调用外部工具","来获取信息、执行操作、与外部系统交互，从而突破纯文本生成的局限。",[896,905,906],{},"简单来说，工具调用让 LLM 从一个\"只会说话\"的模型，变成一个\"能动手做事\"的 Agent。",[908,909,915],"pre",{"className":910,"code":912,"language":913,"meta":914},[911],"language-text","flowchart TD\n    U1[\"用户: 北京今天天气怎么样？\"] --> LLM1[\"LLM\u003Cbr\u002F>判断需要调用天气工具\"]\n    LLM1 -->|生成结构化工具调用请求| Call[\"get_weather#40;city=北京#41;\"]\n    Call -->|系统执行工具调用| API[\"天气 API 返回：晴，25°C\"]\n    API -->|将结果反馈给 LLM| LLM2[\"LLM\u003Cbr\u002F>根据工具结果生成回复\"]\n    LLM2 --> U2[\"用户: 北京今天天气晴朗，气温 25°C，适合户外活动。\"]\n","text","mermaid",[916,917,912],"code",{"__ignoreMap":11},[892,919,920],{"id":920},"工具调用的工作原理",[896,922,923],{},"工具调用的完整流程分为以下几个步骤：",[925,926,927,934,940,946,952,958],"ol",{},[928,929,930,933],"li",{},[900,931,932],{},"工具定义","：开发者定义可用工具的名称、描述和参数 Schema",[928,935,936,939],{},[900,937,938],{},"模型决策","：LLM 根据用户输入和工具描述，决定是否需要调用工具，以及调用哪个工具",[928,941,942,945],{},[900,943,944],{},"结构化输出","：模型生成符合 Schema 的工具调用请求（JSON 格式）",[928,947,948,951],{},[900,949,950],{},"工具执行","：应用层解析请求并实际执行工具",[928,953,954,957],{},[900,955,956],{},"结果回传","：将工具执行结果作为新的上下文传回模型",[928,959,960,963],{},[900,961,962],{},"最终生成","：模型结合工具结果生成最终回复",[965,966,967],"warning",{},"\n模型本身**并不执行**工具调用，它只是生成结构化的调用请求。实际的工具执行由应用层代码负责。这是很多初学者容易混淆的地方。\n",[892,969,971],{"id":970},"工具定义json-schema","工具定义：JSON Schema",[896,973,974],{},"无论使用哪个 LLM 提供商，工具定义的核心都是使用 JSON Schema 来描述工具的参数。一个好的工具定义包含：",[976,977,978,984,990],"ul",{},[928,979,980,983],{},[900,981,982],{},"名称（name）","：简洁明确的工具标识",[928,985,986,989],{},[900,987,988],{},"描述（description）","：详细说明工具的用途和使用场景",[928,991,992,995],{},[900,993,994],{},"参数（parameters）","：使用 JSON Schema 定义输入参数",[908,997,1001],{"className":998,"code":999,"language":1000,"meta":11,"style":11},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"name\": \"search_database\",\n  \"description\": \"在公司内部数据库中搜索员工信息。当用户询问关于员工、部门或组织结构相关问题时使用此工具。\",\n  \"parameters\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"query\": {\n        \"type\": \"string\",\n        \"description\": \"搜索关键词，如员工姓名、工号或部门名称\"\n      },\n      \"department\": {\n        \"type\": \"string\",\n        \"description\": \"按部门筛选，可选\",\n        \"enum\": [\"engineering\", \"marketing\", \"sales\", \"hr\"]\n      },\n      \"limit\": {\n        \"type\": \"integer\",\n        \"description\": \"返回结果的最大数量，默认为 10\",\n        \"default\": 10\n      }\n    },\n    \"required\": [\"query\"]\n  }\n}\n","json",[916,1002,1003,1012,1029,1042,1051,1064,1072,1080,1093,1104,1110,1118,1129,1141,1172,1177,1185,1197,1209,1220,1226,1232,1245,1251],{"__ignoreMap":11},[1004,1005,1008],"span",{"class":1006,"line":1007},"line",1,[1004,1009,1011],{"class":1010},"sxrX7","{\n",[1004,1013,1015,1019,1022,1026],{"class":1006,"line":1014},2,[1004,1016,1018],{"class":1017},"sBjJW","  \"name\"",[1004,1020,1021],{"class":1010},": ",[1004,1023,1025],{"class":1024},"sIIMD","\"search_database\"",[1004,1027,1028],{"class":1010},",\n",[1004,1030,1032,1035,1037,1040],{"class":1006,"line":1031},3,[1004,1033,1034],{"class":1017},"  \"description\"",[1004,1036,1021],{"class":1010},[1004,1038,1039],{"class":1024},"\"在公司内部数据库中搜索员工信息。当用户询问关于员工、部门或组织结构相关问题时使用此工具。\"",[1004,1041,1028],{"class":1010},[1004,1043,1045,1048],{"class":1006,"line":1044},4,[1004,1046,1047],{"class":1017},"  \"parameters\"",[1004,1049,1050],{"class":1010},": {\n",[1004,1052,1054,1057,1059,1062],{"class":1006,"line":1053},5,[1004,1055,1056],{"class":1017},"    \"type\"",[1004,1058,1021],{"class":1010},[1004,1060,1061],{"class":1024},"\"object\"",[1004,1063,1028],{"class":1010},[1004,1065,1067,1070],{"class":1006,"line":1066},6,[1004,1068,1069],{"class":1017},"    \"properties\"",[1004,1071,1050],{"class":1010},[1004,1073,1075,1078],{"class":1006,"line":1074},7,[1004,1076,1077],{"class":1017},"      \"query\"",[1004,1079,1050],{"class":1010},[1004,1081,1083,1086,1088,1091],{"class":1006,"line":1082},8,[1004,1084,1085],{"class":1017},"        \"type\"",[1004,1087,1021],{"class":1010},[1004,1089,1090],{"class":1024},"\"string\"",[1004,1092,1028],{"class":1010},[1004,1094,1096,1099,1101],{"class":1006,"line":1095},9,[1004,1097,1098],{"class":1017},"        \"description\"",[1004,1100,1021],{"class":1010},[1004,1102,1103],{"class":1024},"\"搜索关键词，如员工姓名、工号或部门名称\"\n",[1004,1105,1107],{"class":1006,"line":1106},10,[1004,1108,1109],{"class":1010},"      },\n",[1004,1111,1113,1116],{"class":1006,"line":1112},11,[1004,1114,1115],{"class":1017},"      \"department\"",[1004,1117,1050],{"class":1010},[1004,1119,1121,1123,1125,1127],{"class":1006,"line":1120},12,[1004,1122,1085],{"class":1017},[1004,1124,1021],{"class":1010},[1004,1126,1090],{"class":1024},[1004,1128,1028],{"class":1010},[1004,1130,1132,1134,1136,1139],{"class":1006,"line":1131},13,[1004,1133,1098],{"class":1017},[1004,1135,1021],{"class":1010},[1004,1137,1138],{"class":1024},"\"按部门筛选，可选\"",[1004,1140,1028],{"class":1010},[1004,1142,1144,1147,1150,1153,1156,1159,1161,1164,1166,1169],{"class":1006,"line":1143},14,[1004,1145,1146],{"class":1017},"        \"enum\"",[1004,1148,1149],{"class":1010},": [",[1004,1151,1152],{"class":1024},"\"engineering\"",[1004,1154,1155],{"class":1010},", ",[1004,1157,1158],{"class":1024},"\"marketing\"",[1004,1160,1155],{"class":1010},[1004,1162,1163],{"class":1024},"\"sales\"",[1004,1165,1155],{"class":1010},[1004,1167,1168],{"class":1024},"\"hr\"",[1004,1170,1171],{"class":1010},"]\n",[1004,1173,1175],{"class":1006,"line":1174},15,[1004,1176,1109],{"class":1010},[1004,1178,1180,1183],{"class":1006,"line":1179},16,[1004,1181,1182],{"class":1017},"      \"limit\"",[1004,1184,1050],{"class":1010},[1004,1186,1188,1190,1192,1195],{"class":1006,"line":1187},17,[1004,1189,1085],{"class":1017},[1004,1191,1021],{"class":1010},[1004,1193,1194],{"class":1024},"\"integer\"",[1004,1196,1028],{"class":1010},[1004,1198,1200,1202,1204,1207],{"class":1006,"line":1199},18,[1004,1201,1098],{"class":1017},[1004,1203,1021],{"class":1010},[1004,1205,1206],{"class":1024},"\"返回结果的最大数量，默认为 10\"",[1004,1208,1028],{"class":1010},[1004,1210,1212,1215,1217],{"class":1006,"line":1211},19,[1004,1213,1214],{"class":1017},"        \"default\"",[1004,1216,1021],{"class":1010},[1004,1218,1219],{"class":1017},"10\n",[1004,1221,1223],{"class":1006,"line":1222},20,[1004,1224,1225],{"class":1010},"      }\n",[1004,1227,1229],{"class":1006,"line":1228},21,[1004,1230,1231],{"class":1010},"    },\n",[1004,1233,1235,1238,1240,1243],{"class":1006,"line":1234},22,[1004,1236,1237],{"class":1017},"    \"required\"",[1004,1239,1149],{"class":1010},[1004,1241,1242],{"class":1024},"\"query\"",[1004,1244,1171],{"class":1010},[1004,1246,1248],{"class":1006,"line":1247},23,[1004,1249,1250],{"class":1010},"  }\n",[1004,1252,1254],{"class":1006,"line":1253},24,[1004,1255,1256],{"class":1010},"}\n",[1258,1259,1260],"tip",{},"\n工具的 **description** 字段非常重要——它直接影响模型能否正确选择和使用工具。描述应该包含：这个工具做什么、什么情况下应该使用、输入输出是什么格式。\n",[892,1262,1264],{"id":1263},"openai-function-calling-实践","OpenAI Function Calling 实践",[896,1266,1267],{},"OpenAI 是最早推出 Function Calling 功能的 LLM 提供商之一。以下是完整的实践示例：",[908,1269,1273],{"className":1270,"code":1271,"language":1272,"meta":11,"style":11},"language-python shiki shiki-themes github-light github-light github-dark","import json\nfrom openai import OpenAI\n\nclient = OpenAI()\n\n# 1. 定义工具\ntools = [\n    {\n        \"type\": \"function\",\n        \"function\": {\n            \"name\": \"get_weather\",\n            \"description\": \"获取指定城市的当前天气信息\",\n            \"parameters\": {\n                \"type\": \"object\",\n                \"properties\": {\n                    \"city\": {\n                        \"type\": \"string\",\n                        \"description\": \"城市名称，如 北京、上海\"\n                    },\n                    \"unit\": {\n                        \"type\": \"string\",\n                        \"enum\": [\"celsius\", \"fahrenheit\"],\n                        \"description\": \"温度单位\"\n                    }\n                },\n                \"required\": [\"city\"]\n            }\n        }\n    },\n    {\n        \"type\": \"function\",\n        \"function\": {\n            \"name\": \"search_products\",\n            \"description\": \"在商品数据库中搜索产品信息\",\n            \"parameters\": {\n                \"type\": \"object\",\n                \"properties\": {\n                    \"keyword\": {\n                        \"type\": \"string\",\n                        \"description\": \"搜索关键词\"\n                    },\n                    \"category\": {\n                        \"type\": \"string\",\n                        \"description\": \"商品类别\"\n                    },\n                    \"max_price\": {\n                        \"type\": \"number\",\n                        \"description\": \"最高价格\"\n                    }\n                },\n                \"required\": [\"keyword\"]\n            }\n        }\n    }\n]\n\n# 2. 实际的工具实现\ndef get_weather(city: str, unit: str = \"celsius\") -> dict:\n    \"\"\"实际调用天气 API\"\"\"\n    # 这里替换为真实的 API 调用\n    return {\n        \"city\": city,\n        \"temperature\": 25,\n        \"unit\": unit,\n        \"condition\": \"晴\"\n    }\n\ndef search_products(keyword: str, category: str = None, max_price: float = None) -> list:\n    \"\"\"实际查询商品数据库\"\"\"\n    # 这里替换为真实的数据库查询\n    return [\n        {\"name\": f\"{keyword}商品A\", \"price\": 99.0, \"category\": category or \"通用\"},\n        {\"name\": f\"{keyword}商品B\", \"price\": 199.0, \"category\": category or \"通用\"}\n    ]\n\n# 工具名称到函数的映射\ntool_functions = {\n    \"get_weather\": get_weather,\n    \"search_products\": search_products,\n}\n\n# 3. 发送请求\nmessages = [\n    {\"role\": \"user\", \"content\": \"北京今天天气怎么样？另外帮我搜一下价格在500以内的机械键盘\"}\n]\n\nresponse = client.chat.completions.create(\n    model=\"gpt-4o\",\n    messages=messages,\n    tools=tools,\n    tool_choice=\"auto\"  # 让模型自行决定是否调用工具\n)\n\n# 4. 处理工具调用\nassistant_message = response.choices[0].message\nmessages.append(assistant_message)\n\nif assistant_message.tool_calls:\n    for tool_call in assistant_message.tool_calls:\n        function_name = tool_call.function.name\n        arguments = json.loads(tool_call.function.arguments)\n\n        # 执行工具\n        result = tool_functions[function_name](**arguments)\n\n        # 将结果回传\n        messages.append({\n            \"role\": \"tool\",\n            \"tool_call_id\": tool_call.id,\n            \"content\": json.dumps(result, ensure_ascii=False)\n        })\n\n    # 5. 让模型根据工具结果生成最终回复\n    final_response = client.chat.completions.create(\n        model=\"gpt-4o\",\n        messages=messages,\n        tools=tools\n    )\n    print(final_response.choices[0].message.content)\n","python",[916,1274,1275,1284,1297,1303,1314,1318,1324,1334,1339,1350,1357,1369,1381,1388,1399,1406,1413,1424,1434,1439,1446,1456,1474,1483,1488,1494,1507,1513,1519,1524,1529,1540,1547,1559,1571,1578,1589,1596,1604,1615,1625,1630,1638,1649,1659,1664,1672,1684,1694,1699,1704,1716,1721,1726,1732,1737,1742,1748,1784,1790,1796,1805,1814,1827,1836,1847,1852,1857,1897,1903,1909,1916,1972,2015,2021,2026,2032,2042,2051,2060,2065,2070,2076,2086,2112,2117,2122,2133,2147,2158,2169,2183,2189,2194,2200,2217,2223,2228,2237,2251,2262,2273,2278,2284,2301,2306,2312,2318,2331,2340,2359,2365,2370,2376,2386,2398,2408,2419,2425],{"__ignoreMap":11},[1004,1276,1277,1281],{"class":1006,"line":1007},[1004,1278,1280],{"class":1279},"s8jYJ","import",[1004,1282,1283],{"class":1010}," json\n",[1004,1285,1286,1289,1292,1294],{"class":1006,"line":1014},[1004,1287,1288],{"class":1279},"from",[1004,1290,1291],{"class":1010}," openai ",[1004,1293,1280],{"class":1279},[1004,1295,1296],{"class":1010}," OpenAI\n",[1004,1298,1299],{"class":1006,"line":1031},[1004,1300,1302],{"emptyLinePlaceholder":1301},true,"\n",[1004,1304,1305,1308,1311],{"class":1006,"line":1044},[1004,1306,1307],{"class":1010},"client ",[1004,1309,1310],{"class":1279},"=",[1004,1312,1313],{"class":1010}," OpenAI()\n",[1004,1315,1316],{"class":1006,"line":1053},[1004,1317,1302],{"emptyLinePlaceholder":1301},[1004,1319,1320],{"class":1006,"line":1066},[1004,1321,1323],{"class":1322},"sCsY4","# 1. 定义工具\n",[1004,1325,1326,1329,1331],{"class":1006,"line":1074},[1004,1327,1328],{"class":1010},"tools ",[1004,1330,1310],{"class":1279},[1004,1332,1333],{"class":1010}," [\n",[1004,1335,1336],{"class":1006,"line":1082},[1004,1337,1338],{"class":1010},"    {\n",[1004,1340,1341,1343,1345,1348],{"class":1006,"line":1095},[1004,1342,1085],{"class":1024},[1004,1344,1021],{"class":1010},[1004,1346,1347],{"class":1024},"\"function\"",[1004,1349,1028],{"class":1010},[1004,1351,1352,1355],{"class":1006,"line":1106},[1004,1353,1354],{"class":1024},"        \"function\"",[1004,1356,1050],{"class":1010},[1004,1358,1359,1362,1364,1367],{"class":1006,"line":1112},[1004,1360,1361],{"class":1024},"            \"name\"",[1004,1363,1021],{"class":1010},[1004,1365,1366],{"class":1024},"\"get_weather\"",[1004,1368,1028],{"class":1010},[1004,1370,1371,1374,1376,1379],{"class":1006,"line":1120},[1004,1372,1373],{"class":1024},"            \"description\"",[1004,1375,1021],{"class":1010},[1004,1377,1378],{"class":1024},"\"获取指定城市的当前天气信息\"",[1004,1380,1028],{"class":1010},[1004,1382,1383,1386],{"class":1006,"line":1131},[1004,1384,1385],{"class":1024},"            \"parameters\"",[1004,1387,1050],{"class":1010},[1004,1389,1390,1393,1395,1397],{"class":1006,"line":1143},[1004,1391,1392],{"class":1024},"                \"type\"",[1004,1394,1021],{"class":1010},[1004,1396,1061],{"class":1024},[1004,1398,1028],{"class":1010},[1004,1400,1401,1404],{"class":1006,"line":1174},[1004,1402,1403],{"class":1024},"                \"properties\"",[1004,1405,1050],{"class":1010},[1004,1407,1408,1411],{"class":1006,"line":1179},[1004,1409,1410],{"class":1024},"                    \"city\"",[1004,1412,1050],{"class":1010},[1004,1414,1415,1418,1420,1422],{"class":1006,"line":1187},[1004,1416,1417],{"class":1024},"                        \"type\"",[1004,1419,1021],{"class":1010},[1004,1421,1090],{"class":1024},[1004,1423,1028],{"class":1010},[1004,1425,1426,1429,1431],{"class":1006,"line":1199},[1004,1427,1428],{"class":1024},"                        \"description\"",[1004,1430,1021],{"class":1010},[1004,1432,1433],{"class":1024},"\"城市名称，如 北京、上海\"\n",[1004,1435,1436],{"class":1006,"line":1211},[1004,1437,1438],{"class":1010},"                    },\n",[1004,1440,1441,1444],{"class":1006,"line":1222},[1004,1442,1443],{"class":1024},"                    \"unit\"",[1004,1445,1050],{"class":1010},[1004,1447,1448,1450,1452,1454],{"class":1006,"line":1228},[1004,1449,1417],{"class":1024},[1004,1451,1021],{"class":1010},[1004,1453,1090],{"class":1024},[1004,1455,1028],{"class":1010},[1004,1457,1458,1461,1463,1466,1468,1471],{"class":1006,"line":1234},[1004,1459,1460],{"class":1024},"                        \"enum\"",[1004,1462,1149],{"class":1010},[1004,1464,1465],{"class":1024},"\"celsius\"",[1004,1467,1155],{"class":1010},[1004,1469,1470],{"class":1024},"\"fahrenheit\"",[1004,1472,1473],{"class":1010},"],\n",[1004,1475,1476,1478,1480],{"class":1006,"line":1247},[1004,1477,1428],{"class":1024},[1004,1479,1021],{"class":1010},[1004,1481,1482],{"class":1024},"\"温度单位\"\n",[1004,1484,1485],{"class":1006,"line":1253},[1004,1486,1487],{"class":1010},"                    }\n",[1004,1489,1491],{"class":1006,"line":1490},25,[1004,1492,1493],{"class":1010},"                },\n",[1004,1495,1497,1500,1502,1505],{"class":1006,"line":1496},26,[1004,1498,1499],{"class":1024},"                \"required\"",[1004,1501,1149],{"class":1010},[1004,1503,1504],{"class":1024},"\"city\"",[1004,1506,1171],{"class":1010},[1004,1508,1510],{"class":1006,"line":1509},27,[1004,1511,1512],{"class":1010},"            }\n",[1004,1514,1516],{"class":1006,"line":1515},28,[1004,1517,1518],{"class":1010},"        }\n",[1004,1520,1522],{"class":1006,"line":1521},29,[1004,1523,1231],{"class":1010},[1004,1525,1527],{"class":1006,"line":1526},30,[1004,1528,1338],{"class":1010},[1004,1530,1532,1534,1536,1538],{"class":1006,"line":1531},31,[1004,1533,1085],{"class":1024},[1004,1535,1021],{"class":1010},[1004,1537,1347],{"class":1024},[1004,1539,1028],{"class":1010},[1004,1541,1543,1545],{"class":1006,"line":1542},32,[1004,1544,1354],{"class":1024},[1004,1546,1050],{"class":1010},[1004,1548,1550,1552,1554,1557],{"class":1006,"line":1549},33,[1004,1551,1361],{"class":1024},[1004,1553,1021],{"class":1010},[1004,1555,1556],{"class":1024},"\"search_products\"",[1004,1558,1028],{"class":1010},[1004,1560,1562,1564,1566,1569],{"class":1006,"line":1561},34,[1004,1563,1373],{"class":1024},[1004,1565,1021],{"class":1010},[1004,1567,1568],{"class":1024},"\"在商品数据库中搜索产品信息\"",[1004,1570,1028],{"class":1010},[1004,1572,1574,1576],{"class":1006,"line":1573},35,[1004,1575,1385],{"class":1024},[1004,1577,1050],{"class":1010},[1004,1579,1581,1583,1585,1587],{"class":1006,"line":1580},36,[1004,1582,1392],{"class":1024},[1004,1584,1021],{"class":1010},[1004,1586,1061],{"class":1024},[1004,1588,1028],{"class":1010},[1004,1590,1592,1594],{"class":1006,"line":1591},37,[1004,1593,1403],{"class":1024},[1004,1595,1050],{"class":1010},[1004,1597,1599,1602],{"class":1006,"line":1598},38,[1004,1600,1601],{"class":1024},"                    \"keyword\"",[1004,1603,1050],{"class":1010},[1004,1605,1607,1609,1611,1613],{"class":1006,"line":1606},39,[1004,1608,1417],{"class":1024},[1004,1610,1021],{"class":1010},[1004,1612,1090],{"class":1024},[1004,1614,1028],{"class":1010},[1004,1616,1618,1620,1622],{"class":1006,"line":1617},40,[1004,1619,1428],{"class":1024},[1004,1621,1021],{"class":1010},[1004,1623,1624],{"class":1024},"\"搜索关键词\"\n",[1004,1626,1628],{"class":1006,"line":1627},41,[1004,1629,1438],{"class":1010},[1004,1631,1633,1636],{"class":1006,"line":1632},42,[1004,1634,1635],{"class":1024},"                    \"category\"",[1004,1637,1050],{"class":1010},[1004,1639,1641,1643,1645,1647],{"class":1006,"line":1640},43,[1004,1642,1417],{"class":1024},[1004,1644,1021],{"class":1010},[1004,1646,1090],{"class":1024},[1004,1648,1028],{"class":1010},[1004,1650,1652,1654,1656],{"class":1006,"line":1651},44,[1004,1653,1428],{"class":1024},[1004,1655,1021],{"class":1010},[1004,1657,1658],{"class":1024},"\"商品类别\"\n",[1004,1660,1662],{"class":1006,"line":1661},45,[1004,1663,1438],{"class":1010},[1004,1665,1667,1670],{"class":1006,"line":1666},46,[1004,1668,1669],{"class":1024},"                    \"max_price\"",[1004,1671,1050],{"class":1010},[1004,1673,1675,1677,1679,1682],{"class":1006,"line":1674},47,[1004,1676,1417],{"class":1024},[1004,1678,1021],{"class":1010},[1004,1680,1681],{"class":1024},"\"number\"",[1004,1683,1028],{"class":1010},[1004,1685,1687,1689,1691],{"class":1006,"line":1686},48,[1004,1688,1428],{"class":1024},[1004,1690,1021],{"class":1010},[1004,1692,1693],{"class":1024},"\"最高价格\"\n",[1004,1695,1697],{"class":1006,"line":1696},49,[1004,1698,1487],{"class":1010},[1004,1700,1702],{"class":1006,"line":1701},50,[1004,1703,1493],{"class":1010},[1004,1705,1707,1709,1711,1714],{"class":1006,"line":1706},51,[1004,1708,1499],{"class":1024},[1004,1710,1149],{"class":1010},[1004,1712,1713],{"class":1024},"\"keyword\"",[1004,1715,1171],{"class":1010},[1004,1717,1719],{"class":1006,"line":1718},52,[1004,1720,1512],{"class":1010},[1004,1722,1724],{"class":1006,"line":1723},53,[1004,1725,1518],{"class":1010},[1004,1727,1729],{"class":1006,"line":1728},54,[1004,1730,1731],{"class":1010},"    }\n",[1004,1733,1735],{"class":1006,"line":1734},55,[1004,1736,1171],{"class":1010},[1004,1738,1740],{"class":1006,"line":1739},56,[1004,1741,1302],{"emptyLinePlaceholder":1301},[1004,1743,1745],{"class":1006,"line":1744},57,[1004,1746,1747],{"class":1322},"# 2. 实际的工具实现\n",[1004,1749,1751,1754,1758,1761,1764,1767,1769,1772,1775,1778,1781],{"class":1006,"line":1750},58,[1004,1752,1753],{"class":1279},"def",[1004,1755,1757],{"class":1756},"snPdu"," get_weather",[1004,1759,1760],{"class":1010},"(city: ",[1004,1762,1763],{"class":1017},"str",[1004,1765,1766],{"class":1010},", unit: ",[1004,1768,1763],{"class":1017},[1004,1770,1771],{"class":1279}," =",[1004,1773,1774],{"class":1024}," \"celsius\"",[1004,1776,1777],{"class":1010},") -> ",[1004,1779,1780],{"class":1017},"dict",[1004,1782,1783],{"class":1010},":\n",[1004,1785,1787],{"class":1006,"line":1786},59,[1004,1788,1789],{"class":1024},"    \"\"\"实际调用天气 API\"\"\"\n",[1004,1791,1793],{"class":1006,"line":1792},60,[1004,1794,1795],{"class":1322},"    # 这里替换为真实的 API 调用\n",[1004,1797,1799,1802],{"class":1006,"line":1798},61,[1004,1800,1801],{"class":1279},"    return",[1004,1803,1804],{"class":1010}," {\n",[1004,1806,1808,1811],{"class":1006,"line":1807},62,[1004,1809,1810],{"class":1024},"        \"city\"",[1004,1812,1813],{"class":1010},": city,\n",[1004,1815,1817,1820,1822,1825],{"class":1006,"line":1816},63,[1004,1818,1819],{"class":1024},"        \"temperature\"",[1004,1821,1021],{"class":1010},[1004,1823,1824],{"class":1017},"25",[1004,1826,1028],{"class":1010},[1004,1828,1830,1833],{"class":1006,"line":1829},64,[1004,1831,1832],{"class":1024},"        \"unit\"",[1004,1834,1835],{"class":1010},": unit,\n",[1004,1837,1839,1842,1844],{"class":1006,"line":1838},65,[1004,1840,1841],{"class":1024},"        \"condition\"",[1004,1843,1021],{"class":1010},[1004,1845,1846],{"class":1024},"\"晴\"\n",[1004,1848,1850],{"class":1006,"line":1849},66,[1004,1851,1731],{"class":1010},[1004,1853,1855],{"class":1006,"line":1854},67,[1004,1856,1302],{"emptyLinePlaceholder":1301},[1004,1858,1860,1862,1865,1868,1870,1873,1875,1877,1880,1883,1886,1888,1890,1892,1895],{"class":1006,"line":1859},68,[1004,1861,1753],{"class":1279},[1004,1863,1864],{"class":1756}," search_products",[1004,1866,1867],{"class":1010},"(keyword: ",[1004,1869,1763],{"class":1017},[1004,1871,1872],{"class":1010},", category: ",[1004,1874,1763],{"class":1017},[1004,1876,1771],{"class":1279},[1004,1878,1879],{"class":1017}," None",[1004,1881,1882],{"class":1010},", max_price: ",[1004,1884,1885],{"class":1017},"float",[1004,1887,1771],{"class":1279},[1004,1889,1879],{"class":1017},[1004,1891,1777],{"class":1010},[1004,1893,1894],{"class":1017},"list",[1004,1896,1783],{"class":1010},[1004,1898,1900],{"class":1006,"line":1899},69,[1004,1901,1902],{"class":1024},"    \"\"\"实际查询商品数据库\"\"\"\n",[1004,1904,1906],{"class":1006,"line":1905},70,[1004,1907,1908],{"class":1322},"    # 这里替换为真实的数据库查询\n",[1004,1910,1912,1914],{"class":1006,"line":1911},71,[1004,1913,1801],{"class":1279},[1004,1915,1333],{"class":1010},[1004,1917,1919,1922,1925,1927,1930,1933,1936,1939,1942,1945,1947,1950,1952,1955,1957,1960,1963,1966,1969],{"class":1006,"line":1918},72,[1004,1920,1921],{"class":1010},"        {",[1004,1923,1924],{"class":1024},"\"name\"",[1004,1926,1021],{"class":1010},[1004,1928,1929],{"class":1279},"f",[1004,1931,1932],{"class":1024},"\"",[1004,1934,1935],{"class":1017},"{",[1004,1937,1938],{"class":1010},"keyword",[1004,1940,1941],{"class":1017},"}",[1004,1943,1944],{"class":1024},"商品A\"",[1004,1946,1155],{"class":1010},[1004,1948,1949],{"class":1024},"\"price\"",[1004,1951,1021],{"class":1010},[1004,1953,1954],{"class":1017},"99.0",[1004,1956,1155],{"class":1010},[1004,1958,1959],{"class":1024},"\"category\"",[1004,1961,1962],{"class":1010},": category ",[1004,1964,1965],{"class":1279},"or",[1004,1967,1968],{"class":1024}," \"通用\"",[1004,1970,1971],{"class":1010},"},\n",[1004,1973,1975,1977,1979,1981,1983,1985,1987,1989,1991,1994,1996,1998,2000,2003,2005,2007,2009,2011,2013],{"class":1006,"line":1974},73,[1004,1976,1921],{"class":1010},[1004,1978,1924],{"class":1024},[1004,1980,1021],{"class":1010},[1004,1982,1929],{"class":1279},[1004,1984,1932],{"class":1024},[1004,1986,1935],{"class":1017},[1004,1988,1938],{"class":1010},[1004,1990,1941],{"class":1017},[1004,1992,1993],{"class":1024},"商品B\"",[1004,1995,1155],{"class":1010},[1004,1997,1949],{"class":1024},[1004,1999,1021],{"class":1010},[1004,2001,2002],{"class":1017},"199.0",[1004,2004,1155],{"class":1010},[1004,2006,1959],{"class":1024},[1004,2008,1962],{"class":1010},[1004,2010,1965],{"class":1279},[1004,2012,1968],{"class":1024},[1004,2014,1256],{"class":1010},[1004,2016,2018],{"class":1006,"line":2017},74,[1004,2019,2020],{"class":1010},"    ]\n",[1004,2022,2024],{"class":1006,"line":2023},75,[1004,2025,1302],{"emptyLinePlaceholder":1301},[1004,2027,2029],{"class":1006,"line":2028},76,[1004,2030,2031],{"class":1322},"# 工具名称到函数的映射\n",[1004,2033,2035,2038,2040],{"class":1006,"line":2034},77,[1004,2036,2037],{"class":1010},"tool_functions ",[1004,2039,1310],{"class":1279},[1004,2041,1804],{"class":1010},[1004,2043,2045,2048],{"class":1006,"line":2044},78,[1004,2046,2047],{"class":1024},"    \"get_weather\"",[1004,2049,2050],{"class":1010},": get_weather,\n",[1004,2052,2054,2057],{"class":1006,"line":2053},79,[1004,2055,2056],{"class":1024},"    \"search_products\"",[1004,2058,2059],{"class":1010},": search_products,\n",[1004,2061,2063],{"class":1006,"line":2062},80,[1004,2064,1256],{"class":1010},[1004,2066,2068],{"class":1006,"line":2067},81,[1004,2069,1302],{"emptyLinePlaceholder":1301},[1004,2071,2073],{"class":1006,"line":2072},82,[1004,2074,2075],{"class":1322},"# 3. 发送请求\n",[1004,2077,2079,2082,2084],{"class":1006,"line":2078},83,[1004,2080,2081],{"class":1010},"messages ",[1004,2083,1310],{"class":1279},[1004,2085,1333],{"class":1010},[1004,2087,2089,2092,2095,2097,2100,2102,2105,2107,2110],{"class":1006,"line":2088},84,[1004,2090,2091],{"class":1010},"    {",[1004,2093,2094],{"class":1024},"\"role\"",[1004,2096,1021],{"class":1010},[1004,2098,2099],{"class":1024},"\"user\"",[1004,2101,1155],{"class":1010},[1004,2103,2104],{"class":1024},"\"content\"",[1004,2106,1021],{"class":1010},[1004,2108,2109],{"class":1024},"\"北京今天天气怎么样？另外帮我搜一下价格在500以内的机械键盘\"",[1004,2111,1256],{"class":1010},[1004,2113,2115],{"class":1006,"line":2114},85,[1004,2116,1171],{"class":1010},[1004,2118,2120],{"class":1006,"line":2119},86,[1004,2121,1302],{"emptyLinePlaceholder":1301},[1004,2123,2125,2128,2130],{"class":1006,"line":2124},87,[1004,2126,2127],{"class":1010},"response ",[1004,2129,1310],{"class":1279},[1004,2131,2132],{"class":1010}," client.chat.completions.create(\n",[1004,2134,2136,2140,2142,2145],{"class":1006,"line":2135},88,[1004,2137,2139],{"class":2138},"sP4rz","    model",[1004,2141,1310],{"class":1279},[1004,2143,2144],{"class":1024},"\"gpt-4o\"",[1004,2146,1028],{"class":1010},[1004,2148,2150,2153,2155],{"class":1006,"line":2149},89,[1004,2151,2152],{"class":2138},"    messages",[1004,2154,1310],{"class":1279},[1004,2156,2157],{"class":1010},"messages,\n",[1004,2159,2161,2164,2166],{"class":1006,"line":2160},90,[1004,2162,2163],{"class":2138},"    tools",[1004,2165,1310],{"class":1279},[1004,2167,2168],{"class":1010},"tools,\n",[1004,2170,2172,2175,2177,2180],{"class":1006,"line":2171},91,[1004,2173,2174],{"class":2138},"    tool_choice",[1004,2176,1310],{"class":1279},[1004,2178,2179],{"class":1024},"\"auto\"",[1004,2181,2182],{"class":1322},"  # 让模型自行决定是否调用工具\n",[1004,2184,2186],{"class":1006,"line":2185},92,[1004,2187,2188],{"class":1010},")\n",[1004,2190,2192],{"class":1006,"line":2191},93,[1004,2193,1302],{"emptyLinePlaceholder":1301},[1004,2195,2197],{"class":1006,"line":2196},94,[1004,2198,2199],{"class":1322},"# 4. 处理工具调用\n",[1004,2201,2203,2206,2208,2211,2214],{"class":1006,"line":2202},95,[1004,2204,2205],{"class":1010},"assistant_message ",[1004,2207,1310],{"class":1279},[1004,2209,2210],{"class":1010}," response.choices[",[1004,2212,2213],{"class":1017},"0",[1004,2215,2216],{"class":1010},"].message\n",[1004,2218,2220],{"class":1006,"line":2219},96,[1004,2221,2222],{"class":1010},"messages.append(assistant_message)\n",[1004,2224,2226],{"class":1006,"line":2225},97,[1004,2227,1302],{"emptyLinePlaceholder":1301},[1004,2229,2231,2234],{"class":1006,"line":2230},98,[1004,2232,2233],{"class":1279},"if",[1004,2235,2236],{"class":1010}," assistant_message.tool_calls:\n",[1004,2238,2240,2243,2246,2249],{"class":1006,"line":2239},99,[1004,2241,2242],{"class":1279},"    for",[1004,2244,2245],{"class":1010}," tool_call ",[1004,2247,2248],{"class":1279},"in",[1004,2250,2236],{"class":1010},[1004,2252,2254,2257,2259],{"class":1006,"line":2253},100,[1004,2255,2256],{"class":1010},"        function_name ",[1004,2258,1310],{"class":1279},[1004,2260,2261],{"class":1010}," tool_call.function.name\n",[1004,2263,2265,2268,2270],{"class":1006,"line":2264},101,[1004,2266,2267],{"class":1010},"        arguments ",[1004,2269,1310],{"class":1279},[1004,2271,2272],{"class":1010}," json.loads(tool_call.function.arguments)\n",[1004,2274,2276],{"class":1006,"line":2275},102,[1004,2277,1302],{"emptyLinePlaceholder":1301},[1004,2279,2281],{"class":1006,"line":2280},103,[1004,2282,2283],{"class":1322},"        # 执行工具\n",[1004,2285,2287,2290,2292,2295,2298],{"class":1006,"line":2286},104,[1004,2288,2289],{"class":1010},"        result ",[1004,2291,1310],{"class":1279},[1004,2293,2294],{"class":1010}," tool_functions[function_name](",[1004,2296,2297],{"class":1279},"**",[1004,2299,2300],{"class":1010},"arguments)\n",[1004,2302,2304],{"class":1006,"line":2303},105,[1004,2305,1302],{"emptyLinePlaceholder":1301},[1004,2307,2309],{"class":1006,"line":2308},106,[1004,2310,2311],{"class":1322},"        # 将结果回传\n",[1004,2313,2315],{"class":1006,"line":2314},107,[1004,2316,2317],{"class":1010},"        messages.append({\n",[1004,2319,2321,2324,2326,2329],{"class":1006,"line":2320},108,[1004,2322,2323],{"class":1024},"            \"role\"",[1004,2325,1021],{"class":1010},[1004,2327,2328],{"class":1024},"\"tool\"",[1004,2330,1028],{"class":1010},[1004,2332,2334,2337],{"class":1006,"line":2333},109,[1004,2335,2336],{"class":1024},"            \"tool_call_id\"",[1004,2338,2339],{"class":1010},": tool_call.id,\n",[1004,2341,2343,2346,2349,2352,2354,2357],{"class":1006,"line":2342},110,[1004,2344,2345],{"class":1024},"            \"content\"",[1004,2347,2348],{"class":1010},": json.dumps(result, ",[1004,2350,2351],{"class":2138},"ensure_ascii",[1004,2353,1310],{"class":1279},[1004,2355,2356],{"class":1017},"False",[1004,2358,2188],{"class":1010},[1004,2360,2362],{"class":1006,"line":2361},111,[1004,2363,2364],{"class":1010},"        })\n",[1004,2366,2368],{"class":1006,"line":2367},112,[1004,2369,1302],{"emptyLinePlaceholder":1301},[1004,2371,2373],{"class":1006,"line":2372},113,[1004,2374,2375],{"class":1322},"    # 5. 让模型根据工具结果生成最终回复\n",[1004,2377,2379,2382,2384],{"class":1006,"line":2378},114,[1004,2380,2381],{"class":1010},"    final_response ",[1004,2383,1310],{"class":1279},[1004,2385,2132],{"class":1010},[1004,2387,2389,2392,2394,2396],{"class":1006,"line":2388},115,[1004,2390,2391],{"class":2138},"        model",[1004,2393,1310],{"class":1279},[1004,2395,2144],{"class":1024},[1004,2397,1028],{"class":1010},[1004,2399,2401,2404,2406],{"class":1006,"line":2400},116,[1004,2402,2403],{"class":2138},"        messages",[1004,2405,1310],{"class":1279},[1004,2407,2157],{"class":1010},[1004,2409,2411,2414,2416],{"class":1006,"line":2410},117,[1004,2412,2413],{"class":2138},"        tools",[1004,2415,1310],{"class":1279},[1004,2417,2418],{"class":1010},"tools\n",[1004,2420,2422],{"class":1006,"line":2421},118,[1004,2423,2424],{"class":1010},"    )\n",[1004,2426,2428,2431,2434,2436],{"class":1006,"line":2427},119,[1004,2429,2430],{"class":1017},"    print",[1004,2432,2433],{"class":1010},"(final_response.choices[",[1004,2435,2213],{"class":1017},[1004,2437,2438],{"class":1010},"].message.content)\n",[2440,2441,2442],"note",{},"\nOpenAI 支持**并行工具调用**——模型可以在一次回复中生成多个工具调用请求（如上例中同时查天气和搜商品），应用层需要逐一执行并将所有结果回传。\n",[892,2444,2446],{"id":2445},"anthropic-tool-use-实践","Anthropic Tool Use 实践",[896,2448,2449],{},"Anthropic 的 Claude 模型提供了类似但格式略有不同的工具调用 API：",[908,2451,2453],{"className":1270,"code":2452,"language":1272,"meta":11,"style":11},"import anthropic\nimport json\n\nclient = anthropic.Anthropic()\n\n# 1. 定义工具\ntools = [\n    {\n        \"name\": \"get_stock_price\",\n        \"description\": \"获取指定股票的实时价格。输入股票代码（如 AAPL、GOOGL），返回当前价格和涨跌幅。\",\n        \"input_schema\": {\n            \"type\": \"object\",\n            \"properties\": {\n                \"symbol\": {\n                    \"type\": \"string\",\n                    \"description\": \"股票代码，如 AAPL、TSLA、GOOGL\"\n                }\n            },\n            \"required\": [\"symbol\"]\n        }\n    },\n    {\n        \"name\": \"calculate\",\n        \"description\": \"执行数学计算。支持基本运算和常用数学函数。\",\n        \"input_schema\": {\n            \"type\": \"object\",\n            \"properties\": {\n                \"expression\": {\n                    \"type\": \"string\",\n                    \"description\": \"数学表达式，如 '2 + 3 * 4' 或 'sqrt(144)'\"\n                }\n            },\n            \"required\": [\"expression\"]\n        }\n    }\n]\n\n# 2. 工具实现\ndef get_stock_price(symbol: str) -> dict:\n    # 替换为真实 API 调用\n    return {\"symbol\": symbol, \"price\": 178.52, \"change\": \"+1.23%\"}\n\ndef calculate(expression: str) -> str:\n    import math\n    try:\n        # 安全的数学计算环境\n        allowed = {\"sqrt\": math.sqrt, \"sin\": math.sin, \"cos\": math.cos,\n                   \"pi\": math.pi, \"e\": math.e, \"abs\": abs, \"pow\": pow}\n        result = eval(expression, {\"__builtins__\": {}}, allowed)\n        return str(result)\n    except Exception as e:\n        return f\"计算错误: {e}\"\n\ntool_functions = {\n    \"get_stock_price\": get_stock_price,\n    \"calculate\": calculate,\n}\n\n# 3. 对话循环\nmessages = [\n    {\"role\": \"user\", \"content\": \"帮我查一下苹果公司的股价，然后计算如果买100股需要多少钱\"}\n]\n\n# 循环处理，直到模型不再需要调用工具\nwhile True:\n    response = client.messages.create(\n        model=\"claude-sonnet-4-20250514\",\n        max_tokens=4096,\n        tools=tools,\n        messages=messages\n    )\n\n    # 检查是否有工具调用\n    if response.stop_reason == \"tool_use\":\n        # 将助手回复添加到消息中\n        messages.append({\"role\": \"assistant\", \"content\": response.content})\n\n        # 处理所有工具调用\n        tool_results = []\n        for block in response.content:\n            if block.type == \"tool_use\":\n                result = tool_functions[block.name](**block.input)\n                tool_results.append({\n                    \"type\": \"tool_result\",\n                    \"tool_use_id\": block.id,\n                    \"content\": json.dumps(result, ensure_ascii=False)\n                })\n\n        messages.append({\"role\": \"user\", \"content\": tool_results})\n    else:\n        # 模型生成了最终回复\n        final_text = \"\".join(\n            block.text for block in response.content if hasattr(block, \"text\")\n        )\n        print(final_text)\n        break\n",[916,2454,2455,2462,2468,2472,2481,2485,2489,2497,2501,2513,2524,2531,2542,2549,2556,2567,2577,2582,2587,2599,2603,2607,2611,2622,2633,2639,2649,2655,2662,2672,2681,2685,2689,2700,2704,2708,2712,2716,2721,2739,2744,2775,2779,2797,2805,2812,2817,2844,2878,2896,2907,2921,2941,2945,2953,2961,2969,2973,2977,2982,2990,3011,3015,3019,3024,3034,3044,3055,3067,3075,3084,3088,3092,3097,3113,3118,3137,3141,3146,3156,3169,3183,3198,3203,3214,3222,3237,3242,3246,3263,3270,3275,3288,3316,3321,3329],{"__ignoreMap":11},[1004,2456,2457,2459],{"class":1006,"line":1007},[1004,2458,1280],{"class":1279},[1004,2460,2461],{"class":1010}," anthropic\n",[1004,2463,2464,2466],{"class":1006,"line":1014},[1004,2465,1280],{"class":1279},[1004,2467,1283],{"class":1010},[1004,2469,2470],{"class":1006,"line":1031},[1004,2471,1302],{"emptyLinePlaceholder":1301},[1004,2473,2474,2476,2478],{"class":1006,"line":1044},[1004,2475,1307],{"class":1010},[1004,2477,1310],{"class":1279},[1004,2479,2480],{"class":1010}," anthropic.Anthropic()\n",[1004,2482,2483],{"class":1006,"line":1053},[1004,2484,1302],{"emptyLinePlaceholder":1301},[1004,2486,2487],{"class":1006,"line":1066},[1004,2488,1323],{"class":1322},[1004,2490,2491,2493,2495],{"class":1006,"line":1074},[1004,2492,1328],{"class":1010},[1004,2494,1310],{"class":1279},[1004,2496,1333],{"class":1010},[1004,2498,2499],{"class":1006,"line":1082},[1004,2500,1338],{"class":1010},[1004,2502,2503,2506,2508,2511],{"class":1006,"line":1095},[1004,2504,2505],{"class":1024},"        \"name\"",[1004,2507,1021],{"class":1010},[1004,2509,2510],{"class":1024},"\"get_stock_price\"",[1004,2512,1028],{"class":1010},[1004,2514,2515,2517,2519,2522],{"class":1006,"line":1106},[1004,2516,1098],{"class":1024},[1004,2518,1021],{"class":1010},[1004,2520,2521],{"class":1024},"\"获取指定股票的实时价格。输入股票代码（如 AAPL、GOOGL），返回当前价格和涨跌幅。\"",[1004,2523,1028],{"class":1010},[1004,2525,2526,2529],{"class":1006,"line":1112},[1004,2527,2528],{"class":1024},"        \"input_schema\"",[1004,2530,1050],{"class":1010},[1004,2532,2533,2536,2538,2540],{"class":1006,"line":1120},[1004,2534,2535],{"class":1024},"            \"type\"",[1004,2537,1021],{"class":1010},[1004,2539,1061],{"class":1024},[1004,2541,1028],{"class":1010},[1004,2543,2544,2547],{"class":1006,"line":1131},[1004,2545,2546],{"class":1024},"            \"properties\"",[1004,2548,1050],{"class":1010},[1004,2550,2551,2554],{"class":1006,"line":1143},[1004,2552,2553],{"class":1024},"                \"symbol\"",[1004,2555,1050],{"class":1010},[1004,2557,2558,2561,2563,2565],{"class":1006,"line":1174},[1004,2559,2560],{"class":1024},"                    \"type\"",[1004,2562,1021],{"class":1010},[1004,2564,1090],{"class":1024},[1004,2566,1028],{"class":1010},[1004,2568,2569,2572,2574],{"class":1006,"line":1179},[1004,2570,2571],{"class":1024},"                    \"description\"",[1004,2573,1021],{"class":1010},[1004,2575,2576],{"class":1024},"\"股票代码，如 AAPL、TSLA、GOOGL\"\n",[1004,2578,2579],{"class":1006,"line":1187},[1004,2580,2581],{"class":1010},"                }\n",[1004,2583,2584],{"class":1006,"line":1199},[1004,2585,2586],{"class":1010},"            },\n",[1004,2588,2589,2592,2594,2597],{"class":1006,"line":1211},[1004,2590,2591],{"class":1024},"            \"required\"",[1004,2593,1149],{"class":1010},[1004,2595,2596],{"class":1024},"\"symbol\"",[1004,2598,1171],{"class":1010},[1004,2600,2601],{"class":1006,"line":1222},[1004,2602,1518],{"class":1010},[1004,2604,2605],{"class":1006,"line":1228},[1004,2606,1231],{"class":1010},[1004,2608,2609],{"class":1006,"line":1234},[1004,2610,1338],{"class":1010},[1004,2612,2613,2615,2617,2620],{"class":1006,"line":1247},[1004,2614,2505],{"class":1024},[1004,2616,1021],{"class":1010},[1004,2618,2619],{"class":1024},"\"calculate\"",[1004,2621,1028],{"class":1010},[1004,2623,2624,2626,2628,2631],{"class":1006,"line":1253},[1004,2625,1098],{"class":1024},[1004,2627,1021],{"class":1010},[1004,2629,2630],{"class":1024},"\"执行数学计算。支持基本运算和常用数学函数。\"",[1004,2632,1028],{"class":1010},[1004,2634,2635,2637],{"class":1006,"line":1490},[1004,2636,2528],{"class":1024},[1004,2638,1050],{"class":1010},[1004,2640,2641,2643,2645,2647],{"class":1006,"line":1496},[1004,2642,2535],{"class":1024},[1004,2644,1021],{"class":1010},[1004,2646,1061],{"class":1024},[1004,2648,1028],{"class":1010},[1004,2650,2651,2653],{"class":1006,"line":1509},[1004,2652,2546],{"class":1024},[1004,2654,1050],{"class":1010},[1004,2656,2657,2660],{"class":1006,"line":1515},[1004,2658,2659],{"class":1024},"                \"expression\"",[1004,2661,1050],{"class":1010},[1004,2663,2664,2666,2668,2670],{"class":1006,"line":1521},[1004,2665,2560],{"class":1024},[1004,2667,1021],{"class":1010},[1004,2669,1090],{"class":1024},[1004,2671,1028],{"class":1010},[1004,2673,2674,2676,2678],{"class":1006,"line":1526},[1004,2675,2571],{"class":1024},[1004,2677,1021],{"class":1010},[1004,2679,2680],{"class":1024},"\"数学表达式，如 '2 + 3 * 4' 或 'sqrt(144)'\"\n",[1004,2682,2683],{"class":1006,"line":1531},[1004,2684,2581],{"class":1010},[1004,2686,2687],{"class":1006,"line":1542},[1004,2688,2586],{"class":1010},[1004,2690,2691,2693,2695,2698],{"class":1006,"line":1549},[1004,2692,2591],{"class":1024},[1004,2694,1149],{"class":1010},[1004,2696,2697],{"class":1024},"\"expression\"",[1004,2699,1171],{"class":1010},[1004,2701,2702],{"class":1006,"line":1561},[1004,2703,1518],{"class":1010},[1004,2705,2706],{"class":1006,"line":1573},[1004,2707,1731],{"class":1010},[1004,2709,2710],{"class":1006,"line":1580},[1004,2711,1171],{"class":1010},[1004,2713,2714],{"class":1006,"line":1591},[1004,2715,1302],{"emptyLinePlaceholder":1301},[1004,2717,2718],{"class":1006,"line":1598},[1004,2719,2720],{"class":1322},"# 2. 工具实现\n",[1004,2722,2723,2725,2728,2731,2733,2735,2737],{"class":1006,"line":1606},[1004,2724,1753],{"class":1279},[1004,2726,2727],{"class":1756}," get_stock_price",[1004,2729,2730],{"class":1010},"(symbol: ",[1004,2732,1763],{"class":1017},[1004,2734,1777],{"class":1010},[1004,2736,1780],{"class":1017},[1004,2738,1783],{"class":1010},[1004,2740,2741],{"class":1006,"line":1617},[1004,2742,2743],{"class":1322},"    # 替换为真实 API 调用\n",[1004,2745,2746,2748,2751,2753,2756,2758,2760,2763,2765,2768,2770,2773],{"class":1006,"line":1627},[1004,2747,1801],{"class":1279},[1004,2749,2750],{"class":1010}," {",[1004,2752,2596],{"class":1024},[1004,2754,2755],{"class":1010},": symbol, ",[1004,2757,1949],{"class":1024},[1004,2759,1021],{"class":1010},[1004,2761,2762],{"class":1017},"178.52",[1004,2764,1155],{"class":1010},[1004,2766,2767],{"class":1024},"\"change\"",[1004,2769,1021],{"class":1010},[1004,2771,2772],{"class":1024},"\"+1.23%\"",[1004,2774,1256],{"class":1010},[1004,2776,2777],{"class":1006,"line":1632},[1004,2778,1302],{"emptyLinePlaceholder":1301},[1004,2780,2781,2783,2786,2789,2791,2793,2795],{"class":1006,"line":1640},[1004,2782,1753],{"class":1279},[1004,2784,2785],{"class":1756}," calculate",[1004,2787,2788],{"class":1010},"(expression: ",[1004,2790,1763],{"class":1017},[1004,2792,1777],{"class":1010},[1004,2794,1763],{"class":1017},[1004,2796,1783],{"class":1010},[1004,2798,2799,2802],{"class":1006,"line":1651},[1004,2800,2801],{"class":1279},"    import",[1004,2803,2804],{"class":1010}," math\n",[1004,2806,2807,2810],{"class":1006,"line":1661},[1004,2808,2809],{"class":1279},"    try",[1004,2811,1783],{"class":1010},[1004,2813,2814],{"class":1006,"line":1666},[1004,2815,2816],{"class":1322},"        # 安全的数学计算环境\n",[1004,2818,2819,2822,2824,2826,2829,2832,2835,2838,2841],{"class":1006,"line":1674},[1004,2820,2821],{"class":1010},"        allowed ",[1004,2823,1310],{"class":1279},[1004,2825,2750],{"class":1010},[1004,2827,2828],{"class":1024},"\"sqrt\"",[1004,2830,2831],{"class":1010},": math.sqrt, ",[1004,2833,2834],{"class":1024},"\"sin\"",[1004,2836,2837],{"class":1010},": math.sin, ",[1004,2839,2840],{"class":1024},"\"cos\"",[1004,2842,2843],{"class":1010},": math.cos,\n",[1004,2845,2846,2849,2852,2855,2858,2861,2863,2866,2868,2871,2873,2876],{"class":1006,"line":1686},[1004,2847,2848],{"class":1024},"                   \"pi\"",[1004,2850,2851],{"class":1010},": math.pi, ",[1004,2853,2854],{"class":1024},"\"e\"",[1004,2856,2857],{"class":1010},": math.e, ",[1004,2859,2860],{"class":1024},"\"abs\"",[1004,2862,1021],{"class":1010},[1004,2864,2865],{"class":1017},"abs",[1004,2867,1155],{"class":1010},[1004,2869,2870],{"class":1024},"\"pow\"",[1004,2872,1021],{"class":1010},[1004,2874,2875],{"class":1017},"pow",[1004,2877,1256],{"class":1010},[1004,2879,2880,2882,2884,2887,2890,2893],{"class":1006,"line":1696},[1004,2881,2289],{"class":1010},[1004,2883,1310],{"class":1279},[1004,2885,2886],{"class":1017}," eval",[1004,2888,2889],{"class":1010},"(expression, {",[1004,2891,2892],{"class":1024},"\"__builtins__\"",[1004,2894,2895],{"class":1010},": {}}, allowed)\n",[1004,2897,2898,2901,2904],{"class":1006,"line":1701},[1004,2899,2900],{"class":1279},"        return",[1004,2902,2903],{"class":1017}," str",[1004,2905,2906],{"class":1010},"(result)\n",[1004,2908,2909,2912,2915,2918],{"class":1006,"line":1706},[1004,2910,2911],{"class":1279},"    except",[1004,2913,2914],{"class":1017}," Exception",[1004,2916,2917],{"class":1279}," as",[1004,2919,2920],{"class":1010}," e:\n",[1004,2922,2923,2925,2928,2931,2933,2936,2938],{"class":1006,"line":1718},[1004,2924,2900],{"class":1279},[1004,2926,2927],{"class":1279}," f",[1004,2929,2930],{"class":1024},"\"计算错误: ",[1004,2932,1935],{"class":1017},[1004,2934,2935],{"class":1010},"e",[1004,2937,1941],{"class":1017},[1004,2939,2940],{"class":1024},"\"\n",[1004,2942,2943],{"class":1006,"line":1723},[1004,2944,1302],{"emptyLinePlaceholder":1301},[1004,2946,2947,2949,2951],{"class":1006,"line":1728},[1004,2948,2037],{"class":1010},[1004,2950,1310],{"class":1279},[1004,2952,1804],{"class":1010},[1004,2954,2955,2958],{"class":1006,"line":1734},[1004,2956,2957],{"class":1024},"    \"get_stock_price\"",[1004,2959,2960],{"class":1010},": get_stock_price,\n",[1004,2962,2963,2966],{"class":1006,"line":1739},[1004,2964,2965],{"class":1024},"    \"calculate\"",[1004,2967,2968],{"class":1010},": calculate,\n",[1004,2970,2971],{"class":1006,"line":1744},[1004,2972,1256],{"class":1010},[1004,2974,2975],{"class":1006,"line":1750},[1004,2976,1302],{"emptyLinePlaceholder":1301},[1004,2978,2979],{"class":1006,"line":1786},[1004,2980,2981],{"class":1322},"# 3. 对话循环\n",[1004,2983,2984,2986,2988],{"class":1006,"line":1792},[1004,2985,2081],{"class":1010},[1004,2987,1310],{"class":1279},[1004,2989,1333],{"class":1010},[1004,2991,2992,2994,2996,2998,3000,3002,3004,3006,3009],{"class":1006,"line":1798},[1004,2993,2091],{"class":1010},[1004,2995,2094],{"class":1024},[1004,2997,1021],{"class":1010},[1004,2999,2099],{"class":1024},[1004,3001,1155],{"class":1010},[1004,3003,2104],{"class":1024},[1004,3005,1021],{"class":1010},[1004,3007,3008],{"class":1024},"\"帮我查一下苹果公司的股价，然后计算如果买100股需要多少钱\"",[1004,3010,1256],{"class":1010},[1004,3012,3013],{"class":1006,"line":1807},[1004,3014,1171],{"class":1010},[1004,3016,3017],{"class":1006,"line":1816},[1004,3018,1302],{"emptyLinePlaceholder":1301},[1004,3020,3021],{"class":1006,"line":1829},[1004,3022,3023],{"class":1322},"# 循环处理，直到模型不再需要调用工具\n",[1004,3025,3026,3029,3032],{"class":1006,"line":1838},[1004,3027,3028],{"class":1279},"while",[1004,3030,3031],{"class":1017}," True",[1004,3033,1783],{"class":1010},[1004,3035,3036,3039,3041],{"class":1006,"line":1849},[1004,3037,3038],{"class":1010},"    response ",[1004,3040,1310],{"class":1279},[1004,3042,3043],{"class":1010}," client.messages.create(\n",[1004,3045,3046,3048,3050,3053],{"class":1006,"line":1854},[1004,3047,2391],{"class":2138},[1004,3049,1310],{"class":1279},[1004,3051,3052],{"class":1024},"\"claude-sonnet-4-20250514\"",[1004,3054,1028],{"class":1010},[1004,3056,3057,3060,3062,3065],{"class":1006,"line":1859},[1004,3058,3059],{"class":2138},"        max_tokens",[1004,3061,1310],{"class":1279},[1004,3063,3064],{"class":1017},"4096",[1004,3066,1028],{"class":1010},[1004,3068,3069,3071,3073],{"class":1006,"line":1899},[1004,3070,2413],{"class":2138},[1004,3072,1310],{"class":1279},[1004,3074,2168],{"class":1010},[1004,3076,3077,3079,3081],{"class":1006,"line":1905},[1004,3078,2403],{"class":2138},[1004,3080,1310],{"class":1279},[1004,3082,3083],{"class":1010},"messages\n",[1004,3085,3086],{"class":1006,"line":1911},[1004,3087,2424],{"class":1010},[1004,3089,3090],{"class":1006,"line":1918},[1004,3091,1302],{"emptyLinePlaceholder":1301},[1004,3093,3094],{"class":1006,"line":1974},[1004,3095,3096],{"class":1322},"    # 检查是否有工具调用\n",[1004,3098,3099,3102,3105,3108,3111],{"class":1006,"line":2017},[1004,3100,3101],{"class":1279},"    if",[1004,3103,3104],{"class":1010}," response.stop_reason ",[1004,3106,3107],{"class":1279},"==",[1004,3109,3110],{"class":1024}," \"tool_use\"",[1004,3112,1783],{"class":1010},[1004,3114,3115],{"class":1006,"line":2023},[1004,3116,3117],{"class":1322},"        # 将助手回复添加到消息中\n",[1004,3119,3120,3123,3125,3127,3130,3132,3134],{"class":1006,"line":2028},[1004,3121,3122],{"class":1010},"        messages.append({",[1004,3124,2094],{"class":1024},[1004,3126,1021],{"class":1010},[1004,3128,3129],{"class":1024},"\"assistant\"",[1004,3131,1155],{"class":1010},[1004,3133,2104],{"class":1024},[1004,3135,3136],{"class":1010},": response.content})\n",[1004,3138,3139],{"class":1006,"line":2034},[1004,3140,1302],{"emptyLinePlaceholder":1301},[1004,3142,3143],{"class":1006,"line":2044},[1004,3144,3145],{"class":1322},"        # 处理所有工具调用\n",[1004,3147,3148,3151,3153],{"class":1006,"line":2053},[1004,3149,3150],{"class":1010},"        tool_results ",[1004,3152,1310],{"class":1279},[1004,3154,3155],{"class":1010}," []\n",[1004,3157,3158,3161,3164,3166],{"class":1006,"line":2062},[1004,3159,3160],{"class":1279},"        for",[1004,3162,3163],{"class":1010}," block ",[1004,3165,2248],{"class":1279},[1004,3167,3168],{"class":1010}," response.content:\n",[1004,3170,3171,3174,3177,3179,3181],{"class":1006,"line":2067},[1004,3172,3173],{"class":1279},"            if",[1004,3175,3176],{"class":1010}," block.type ",[1004,3178,3107],{"class":1279},[1004,3180,3110],{"class":1024},[1004,3182,1783],{"class":1010},[1004,3184,3185,3188,3190,3193,3195],{"class":1006,"line":2072},[1004,3186,3187],{"class":1010},"                result ",[1004,3189,1310],{"class":1279},[1004,3191,3192],{"class":1010}," tool_functions[block.name](",[1004,3194,2297],{"class":1279},[1004,3196,3197],{"class":1010},"block.input)\n",[1004,3199,3200],{"class":1006,"line":2078},[1004,3201,3202],{"class":1010},"                tool_results.append({\n",[1004,3204,3205,3207,3209,3212],{"class":1006,"line":2088},[1004,3206,2560],{"class":1024},[1004,3208,1021],{"class":1010},[1004,3210,3211],{"class":1024},"\"tool_result\"",[1004,3213,1028],{"class":1010},[1004,3215,3216,3219],{"class":1006,"line":2114},[1004,3217,3218],{"class":1024},"                    \"tool_use_id\"",[1004,3220,3221],{"class":1010},": block.id,\n",[1004,3223,3224,3227,3229,3231,3233,3235],{"class":1006,"line":2119},[1004,3225,3226],{"class":1024},"                    \"content\"",[1004,3228,2348],{"class":1010},[1004,3230,2351],{"class":2138},[1004,3232,1310],{"class":1279},[1004,3234,2356],{"class":1017},[1004,3236,2188],{"class":1010},[1004,3238,3239],{"class":1006,"line":2124},[1004,3240,3241],{"class":1010},"                })\n",[1004,3243,3244],{"class":1006,"line":2135},[1004,3245,1302],{"emptyLinePlaceholder":1301},[1004,3247,3248,3250,3252,3254,3256,3258,3260],{"class":1006,"line":2149},[1004,3249,3122],{"class":1010},[1004,3251,2094],{"class":1024},[1004,3253,1021],{"class":1010},[1004,3255,2099],{"class":1024},[1004,3257,1155],{"class":1010},[1004,3259,2104],{"class":1024},[1004,3261,3262],{"class":1010},": tool_results})\n",[1004,3264,3265,3268],{"class":1006,"line":2160},[1004,3266,3267],{"class":1279},"    else",[1004,3269,1783],{"class":1010},[1004,3271,3272],{"class":1006,"line":2171},[1004,3273,3274],{"class":1322},"        # 模型生成了最终回复\n",[1004,3276,3277,3280,3282,3285],{"class":1006,"line":2185},[1004,3278,3279],{"class":1010},"        final_text ",[1004,3281,1310],{"class":1279},[1004,3283,3284],{"class":1024}," \"\"",[1004,3286,3287],{"class":1010},".join(\n",[1004,3289,3290,3293,3296,3298,3300,3303,3305,3308,3311,3314],{"class":1006,"line":2191},[1004,3291,3292],{"class":1010},"            block.text ",[1004,3294,3295],{"class":1279},"for",[1004,3297,3163],{"class":1010},[1004,3299,2248],{"class":1279},[1004,3301,3302],{"class":1010}," response.content ",[1004,3304,2233],{"class":1279},[1004,3306,3307],{"class":1017}," hasattr",[1004,3309,3310],{"class":1010},"(block, ",[1004,3312,3313],{"class":1024},"\"text\"",[1004,3315,2188],{"class":1010},[1004,3317,3318],{"class":1006,"line":2196},[1004,3319,3320],{"class":1010},"        )\n",[1004,3322,3323,3326],{"class":1006,"line":2202},[1004,3324,3325],{"class":1017},"        print",[1004,3327,3328],{"class":1010},"(final_text)\n",[1004,3330,3331],{"class":1006,"line":2219},[1004,3332,3333],{"class":1279},"        break\n",[892,3335,3337],{"id":3336},"两种-api-的对比","两种 API 的对比",[3339,3340,3341,3357],"table",{},[3342,3343,3344],"thead",{},[3345,3346,3347,3351,3354],"tr",{},[3348,3349,3350],"th",{},"特性",[3348,3352,3353],{},"OpenAI",[3348,3355,3356],{},"Anthropic",[3358,3359,3360,3378,3401,3422,3439,3451],"tbody",{},[3345,3361,3362,3368,3373],{},[3363,3364,3365],"td",{},[900,3366,3367],{},"工具定义字段",[3363,3369,3370],{},[916,3371,3372],{},"parameters",[3363,3374,3375],{},[916,3376,3377],{},"input_schema",[3345,3379,3380,3385,3391],{},[3363,3381,3382],{},[900,3383,3384],{},"工具调用标识",[3363,3386,3387,3390],{},[916,3388,3389],{},"tool_calls"," 列表",[3363,3392,3393,3396,3397,3400],{},[916,3394,3395],{},"content"," 中的 ",[916,3398,3399],{},"tool_use"," 块",[3345,3402,3403,3408,3413],{},[3363,3404,3405],{},[900,3406,3407],{},"结果回传角色",[3363,3409,3410],{},[916,3411,3412],{},"role: \"tool\"",[3363,3414,3415,3418,3419],{},[916,3416,3417],{},"role: \"user\""," 中嵌套 ",[916,3420,3421],{},"tool_result",[3345,3423,3424,3429,3434],{},[3363,3425,3426],{},[900,3427,3428],{},"停止原因",[3363,3430,3431],{},[916,3432,3433],{},"finish_reason: \"tool_calls\"",[3363,3435,3436],{},[916,3437,3438],{},"stop_reason: \"tool_use\"",[3345,3440,3441,3446,3449],{},[3363,3442,3443],{},[900,3444,3445],{},"并行调用",[3363,3447,3448],{},"支持",[3363,3450,3448],{},[3345,3452,3453,3458,3460],{},[3363,3454,3455],{},[900,3456,3457],{},"流式输出",[3363,3459,3448],{},[3363,3461,3448],{},[892,3463,3464],{"id":3464},"错误处理",[896,3466,3467],{},"工具调用中的错误处理至关重要。常见的错误场景和处理策略：",[908,3469,3471],{"className":1270,"code":3470,"language":1272,"meta":11,"style":11},"def safe_tool_execution(tool_name: str, arguments: dict, tool_functions: dict) -> str:\n    \"\"\"安全的工具执行封装\"\"\"\n    try:\n        # 检查工具是否存在\n        if tool_name not in tool_functions:\n            return json.dumps({\n                \"error\": f\"未知工具: {tool_name}\",\n                \"available_tools\": list(tool_functions.keys())\n            })\n\n        # 执行工具（设置超时）\n        import signal\n\n        def timeout_handler(signum, frame):\n            raise TimeoutError(\"工具执行超时\")\n\n        signal.signal(signal.SIGALRM, timeout_handler)\n        signal.alarm(30)  # 30 秒超时\n\n        result = tool_functions[tool_name](**arguments)\n\n        signal.alarm(0)  # 取消超时\n        return json.dumps(result, ensure_ascii=False)\n\n    except TypeError as e:\n        # 参数类型错误\n        return json.dumps({\n            \"error\": f\"参数错误: {e}\",\n            \"hint\": \"请检查参数类型和必填项\"\n        })\n\n    except TimeoutError:\n        return json.dumps({\n            \"error\": \"工具执行超时，请稍后重试\"\n        })\n\n    except Exception as e:\n        # 兜底异常处理\n        return json.dumps({\n            \"error\": f\"工具执行失败: {type(e).__name__}: {e}\"\n        })\n",[916,3472,3473,3501,3506,3512,3517,3534,3542,3565,3577,3582,3586,3591,3599,3603,3614,3630,3634,3645,3659,3663,3676,3680,3691,3706,3710,3721,3726,3732,3754,3764,3768,3772,3780,3786,3795,3799,3803,3813,3818,3824,3854],{"__ignoreMap":11},[1004,3474,3475,3477,3480,3483,3485,3488,3490,3493,3495,3497,3499],{"class":1006,"line":1007},[1004,3476,1753],{"class":1279},[1004,3478,3479],{"class":1756}," safe_tool_execution",[1004,3481,3482],{"class":1010},"(tool_name: ",[1004,3484,1763],{"class":1017},[1004,3486,3487],{"class":1010},", arguments: ",[1004,3489,1780],{"class":1017},[1004,3491,3492],{"class":1010},", tool_functions: ",[1004,3494,1780],{"class":1017},[1004,3496,1777],{"class":1010},[1004,3498,1763],{"class":1017},[1004,3500,1783],{"class":1010},[1004,3502,3503],{"class":1006,"line":1014},[1004,3504,3505],{"class":1024},"    \"\"\"安全的工具执行封装\"\"\"\n",[1004,3507,3508,3510],{"class":1006,"line":1031},[1004,3509,2809],{"class":1279},[1004,3511,1783],{"class":1010},[1004,3513,3514],{"class":1006,"line":1044},[1004,3515,3516],{"class":1322},"        # 检查工具是否存在\n",[1004,3518,3519,3522,3525,3528,3531],{"class":1006,"line":1053},[1004,3520,3521],{"class":1279},"        if",[1004,3523,3524],{"class":1010}," tool_name ",[1004,3526,3527],{"class":1279},"not",[1004,3529,3530],{"class":1279}," in",[1004,3532,3533],{"class":1010}," tool_functions:\n",[1004,3535,3536,3539],{"class":1006,"line":1066},[1004,3537,3538],{"class":1279},"            return",[1004,3540,3541],{"class":1010}," json.dumps({\n",[1004,3543,3544,3547,3549,3551,3554,3556,3559,3561,3563],{"class":1006,"line":1074},[1004,3545,3546],{"class":1024},"                \"error\"",[1004,3548,1021],{"class":1010},[1004,3550,1929],{"class":1279},[1004,3552,3553],{"class":1024},"\"未知工具: ",[1004,3555,1935],{"class":1017},[1004,3557,3558],{"class":1010},"tool_name",[1004,3560,1941],{"class":1017},[1004,3562,1932],{"class":1024},[1004,3564,1028],{"class":1010},[1004,3566,3567,3570,3572,3574],{"class":1006,"line":1082},[1004,3568,3569],{"class":1024},"                \"available_tools\"",[1004,3571,1021],{"class":1010},[1004,3573,1894],{"class":1017},[1004,3575,3576],{"class":1010},"(tool_functions.keys())\n",[1004,3578,3579],{"class":1006,"line":1095},[1004,3580,3581],{"class":1010},"            })\n",[1004,3583,3584],{"class":1006,"line":1106},[1004,3585,1302],{"emptyLinePlaceholder":1301},[1004,3587,3588],{"class":1006,"line":1112},[1004,3589,3590],{"class":1322},"        # 执行工具（设置超时）\n",[1004,3592,3593,3596],{"class":1006,"line":1120},[1004,3594,3595],{"class":1279},"        import",[1004,3597,3598],{"class":1010}," signal\n",[1004,3600,3601],{"class":1006,"line":1131},[1004,3602,1302],{"emptyLinePlaceholder":1301},[1004,3604,3605,3608,3611],{"class":1006,"line":1143},[1004,3606,3607],{"class":1279},"        def",[1004,3609,3610],{"class":1756}," timeout_handler",[1004,3612,3613],{"class":1010},"(signum, frame):\n",[1004,3615,3616,3619,3622,3625,3628],{"class":1006,"line":1174},[1004,3617,3618],{"class":1279},"            raise",[1004,3620,3621],{"class":1017}," TimeoutError",[1004,3623,3624],{"class":1010},"(",[1004,3626,3627],{"class":1024},"\"工具执行超时\"",[1004,3629,2188],{"class":1010},[1004,3631,3632],{"class":1006,"line":1179},[1004,3633,1302],{"emptyLinePlaceholder":1301},[1004,3635,3636,3639,3642],{"class":1006,"line":1187},[1004,3637,3638],{"class":1010},"        signal.signal(signal.",[1004,3640,3641],{"class":1017},"SIGALRM",[1004,3643,3644],{"class":1010},", timeout_handler)\n",[1004,3646,3647,3650,3653,3656],{"class":1006,"line":1199},[1004,3648,3649],{"class":1010},"        signal.alarm(",[1004,3651,3652],{"class":1017},"30",[1004,3654,3655],{"class":1010},")  ",[1004,3657,3658],{"class":1322},"# 30 秒超时\n",[1004,3660,3661],{"class":1006,"line":1211},[1004,3662,1302],{"emptyLinePlaceholder":1301},[1004,3664,3665,3667,3669,3672,3674],{"class":1006,"line":1222},[1004,3666,2289],{"class":1010},[1004,3668,1310],{"class":1279},[1004,3670,3671],{"class":1010}," tool_functions[tool_name](",[1004,3673,2297],{"class":1279},[1004,3675,2300],{"class":1010},[1004,3677,3678],{"class":1006,"line":1228},[1004,3679,1302],{"emptyLinePlaceholder":1301},[1004,3681,3682,3684,3686,3688],{"class":1006,"line":1234},[1004,3683,3649],{"class":1010},[1004,3685,2213],{"class":1017},[1004,3687,3655],{"class":1010},[1004,3689,3690],{"class":1322},"# 取消超时\n",[1004,3692,3693,3695,3698,3700,3702,3704],{"class":1006,"line":1247},[1004,3694,2900],{"class":1279},[1004,3696,3697],{"class":1010}," json.dumps(result, ",[1004,3699,2351],{"class":2138},[1004,3701,1310],{"class":1279},[1004,3703,2356],{"class":1017},[1004,3705,2188],{"class":1010},[1004,3707,3708],{"class":1006,"line":1253},[1004,3709,1302],{"emptyLinePlaceholder":1301},[1004,3711,3712,3714,3717,3719],{"class":1006,"line":1490},[1004,3713,2911],{"class":1279},[1004,3715,3716],{"class":1017}," TypeError",[1004,3718,2917],{"class":1279},[1004,3720,2920],{"class":1010},[1004,3722,3723],{"class":1006,"line":1496},[1004,3724,3725],{"class":1322},"        # 参数类型错误\n",[1004,3727,3728,3730],{"class":1006,"line":1509},[1004,3729,2900],{"class":1279},[1004,3731,3541],{"class":1010},[1004,3733,3734,3737,3739,3741,3744,3746,3748,3750,3752],{"class":1006,"line":1515},[1004,3735,3736],{"class":1024},"            \"error\"",[1004,3738,1021],{"class":1010},[1004,3740,1929],{"class":1279},[1004,3742,3743],{"class":1024},"\"参数错误: ",[1004,3745,1935],{"class":1017},[1004,3747,2935],{"class":1010},[1004,3749,1941],{"class":1017},[1004,3751,1932],{"class":1024},[1004,3753,1028],{"class":1010},[1004,3755,3756,3759,3761],{"class":1006,"line":1521},[1004,3757,3758],{"class":1024},"            \"hint\"",[1004,3760,1021],{"class":1010},[1004,3762,3763],{"class":1024},"\"请检查参数类型和必填项\"\n",[1004,3765,3766],{"class":1006,"line":1526},[1004,3767,2364],{"class":1010},[1004,3769,3770],{"class":1006,"line":1531},[1004,3771,1302],{"emptyLinePlaceholder":1301},[1004,3773,3774,3776,3778],{"class":1006,"line":1542},[1004,3775,2911],{"class":1279},[1004,3777,3621],{"class":1017},[1004,3779,1783],{"class":1010},[1004,3781,3782,3784],{"class":1006,"line":1549},[1004,3783,2900],{"class":1279},[1004,3785,3541],{"class":1010},[1004,3787,3788,3790,3792],{"class":1006,"line":1561},[1004,3789,3736],{"class":1024},[1004,3791,1021],{"class":1010},[1004,3793,3794],{"class":1024},"\"工具执行超时，请稍后重试\"\n",[1004,3796,3797],{"class":1006,"line":1573},[1004,3798,2364],{"class":1010},[1004,3800,3801],{"class":1006,"line":1580},[1004,3802,1302],{"emptyLinePlaceholder":1301},[1004,3804,3805,3807,3809,3811],{"class":1006,"line":1591},[1004,3806,2911],{"class":1279},[1004,3808,2914],{"class":1017},[1004,3810,2917],{"class":1279},[1004,3812,2920],{"class":1010},[1004,3814,3815],{"class":1006,"line":1598},[1004,3816,3817],{"class":1322},"        # 兜底异常处理\n",[1004,3819,3820,3822],{"class":1006,"line":1606},[1004,3821,2900],{"class":1279},[1004,3823,3541],{"class":1010},[1004,3825,3826,3828,3830,3832,3835,3838,3841,3844,3846,3848,3850,3852],{"class":1006,"line":1617},[1004,3827,3736],{"class":1024},[1004,3829,1021],{"class":1010},[1004,3831,1929],{"class":1279},[1004,3833,3834],{"class":1024},"\"工具执行失败: ",[1004,3836,3837],{"class":1017},"{type",[1004,3839,3840],{"class":1010},"(e).",[1004,3842,3843],{"class":1017},"__name__}",[1004,3845,1021],{"class":1024},[1004,3847,1935],{"class":1017},[1004,3849,2935],{"class":1010},[1004,3851,1941],{"class":1017},[1004,3853,2940],{"class":1024},[1004,3855,3856],{"class":1006,"line":1627},[1004,3857,2364],{"class":1010},[965,3859,3860],{},"\n永远不要将工具执行中的原始异常堆栈直接暴露给终端用户或模型。应该将错误封装为结构化的错误信息，既方便模型理解和重试，也避免泄露系统内部信息。\n",[892,3862,3863],{"id":3863},"工具设计最佳实践",[3865,3866,3868],"h3",{"id":3867},"_1-工具粒度适中","1. 工具粒度适中",[908,3870,3872],{"className":1270,"code":3871,"language":1272,"meta":11,"style":11},"# 不好：工具粒度太大，做了太多事情\n@tool\ndef manage_user(action, user_id, name, email, role, department):\n    \"\"\"管理用户的所有操作\"\"\"\n    ...\n\n# 好：拆分为职责单一的小工具\n@tool\ndef get_user(user_id: str) -> dict:\n    \"\"\"根据用户 ID 查询用户信息\"\"\"\n    ...\n\n@tool\ndef update_user_email(user_id: str, new_email: str) -> dict:\n    \"\"\"更新指定用户的邮箱地址\"\"\"\n    ...\n\n@tool\ndef assign_user_role(user_id: str, role: str) -> dict:\n    \"\"\"为用户分配角色权限\"\"\"\n    ...\n",[916,3873,3874,3879,3884,3894,3899,3904,3908,3913,3917,3935,3940,3944,3948,3952,3974,3979,3983,3987,3991,4013,4018],{"__ignoreMap":11},[1004,3875,3876],{"class":1006,"line":1007},[1004,3877,3878],{"class":1322},"# 不好：工具粒度太大，做了太多事情\n",[1004,3880,3881],{"class":1006,"line":1014},[1004,3882,3883],{"class":1756},"@tool\n",[1004,3885,3886,3888,3891],{"class":1006,"line":1031},[1004,3887,1753],{"class":1279},[1004,3889,3890],{"class":1756}," manage_user",[1004,3892,3893],{"class":1010},"(action, user_id, name, email, role, department):\n",[1004,3895,3896],{"class":1006,"line":1044},[1004,3897,3898],{"class":1024},"    \"\"\"管理用户的所有操作\"\"\"\n",[1004,3900,3901],{"class":1006,"line":1053},[1004,3902,3903],{"class":1017},"    ...\n",[1004,3905,3906],{"class":1006,"line":1066},[1004,3907,1302],{"emptyLinePlaceholder":1301},[1004,3909,3910],{"class":1006,"line":1074},[1004,3911,3912],{"class":1322},"# 好：拆分为职责单一的小工具\n",[1004,3914,3915],{"class":1006,"line":1082},[1004,3916,3883],{"class":1756},[1004,3918,3919,3921,3924,3927,3929,3931,3933],{"class":1006,"line":1095},[1004,3920,1753],{"class":1279},[1004,3922,3923],{"class":1756}," get_user",[1004,3925,3926],{"class":1010},"(user_id: ",[1004,3928,1763],{"class":1017},[1004,3930,1777],{"class":1010},[1004,3932,1780],{"class":1017},[1004,3934,1783],{"class":1010},[1004,3936,3937],{"class":1006,"line":1106},[1004,3938,3939],{"class":1024},"    \"\"\"根据用户 ID 查询用户信息\"\"\"\n",[1004,3941,3942],{"class":1006,"line":1112},[1004,3943,3903],{"class":1017},[1004,3945,3946],{"class":1006,"line":1120},[1004,3947,1302],{"emptyLinePlaceholder":1301},[1004,3949,3950],{"class":1006,"line":1131},[1004,3951,3883],{"class":1756},[1004,3953,3954,3956,3959,3961,3963,3966,3968,3970,3972],{"class":1006,"line":1143},[1004,3955,1753],{"class":1279},[1004,3957,3958],{"class":1756}," update_user_email",[1004,3960,3926],{"class":1010},[1004,3962,1763],{"class":1017},[1004,3964,3965],{"class":1010},", new_email: ",[1004,3967,1763],{"class":1017},[1004,3969,1777],{"class":1010},[1004,3971,1780],{"class":1017},[1004,3973,1783],{"class":1010},[1004,3975,3976],{"class":1006,"line":1174},[1004,3977,3978],{"class":1024},"    \"\"\"更新指定用户的邮箱地址\"\"\"\n",[1004,3980,3981],{"class":1006,"line":1179},[1004,3982,3903],{"class":1017},[1004,3984,3985],{"class":1006,"line":1187},[1004,3986,1302],{"emptyLinePlaceholder":1301},[1004,3988,3989],{"class":1006,"line":1199},[1004,3990,3883],{"class":1756},[1004,3992,3993,3995,3998,4000,4002,4005,4007,4009,4011],{"class":1006,"line":1211},[1004,3994,1753],{"class":1279},[1004,3996,3997],{"class":1756}," assign_user_role",[1004,3999,3926],{"class":1010},[1004,4001,1763],{"class":1017},[1004,4003,4004],{"class":1010},", role: ",[1004,4006,1763],{"class":1017},[1004,4008,1777],{"class":1010},[1004,4010,1780],{"class":1017},[1004,4012,1783],{"class":1010},[1004,4014,4015],{"class":1006,"line":1222},[1004,4016,4017],{"class":1024},"    \"\"\"为用户分配角色权限\"\"\"\n",[1004,4019,4020],{"class":1006,"line":1228},[1004,4021,3903],{"class":1017},[3865,4023,4025],{"id":4024},"_2-描述要详细且准确","2. 描述要详细且准确",[908,4027,4029],{"className":1270,"code":4028,"language":1272,"meta":11,"style":11},"# 不好：描述模糊\n@tool\ndef search(q: str):\n    \"\"\"搜索\"\"\"\n    ...\n\n# 好：描述清晰，说明使用场景\n@tool\ndef search_documentation(query: str, language: str = \"zh\"):\n    \"\"\"在官方技术文档中搜索信息。\n    当用户询问 API 用法、配置参数、最佳实践等技术问题时使用。\n    返回最相关的文档片段和链接。\n    \"\"\"\n    ...\n",[916,4030,4031,4036,4040,4055,4060,4064,4068,4073,4077,4101,4106,4111,4116,4121],{"__ignoreMap":11},[1004,4032,4033],{"class":1006,"line":1007},[1004,4034,4035],{"class":1322},"# 不好：描述模糊\n",[1004,4037,4038],{"class":1006,"line":1014},[1004,4039,3883],{"class":1756},[1004,4041,4042,4044,4047,4050,4052],{"class":1006,"line":1031},[1004,4043,1753],{"class":1279},[1004,4045,4046],{"class":1756}," search",[1004,4048,4049],{"class":1010},"(q: ",[1004,4051,1763],{"class":1017},[1004,4053,4054],{"class":1010},"):\n",[1004,4056,4057],{"class":1006,"line":1044},[1004,4058,4059],{"class":1024},"    \"\"\"搜索\"\"\"\n",[1004,4061,4062],{"class":1006,"line":1053},[1004,4063,3903],{"class":1017},[1004,4065,4066],{"class":1006,"line":1066},[1004,4067,1302],{"emptyLinePlaceholder":1301},[1004,4069,4070],{"class":1006,"line":1074},[1004,4071,4072],{"class":1322},"# 好：描述清晰，说明使用场景\n",[1004,4074,4075],{"class":1006,"line":1082},[1004,4076,3883],{"class":1756},[1004,4078,4079,4081,4084,4087,4089,4092,4094,4096,4099],{"class":1006,"line":1095},[1004,4080,1753],{"class":1279},[1004,4082,4083],{"class":1756}," search_documentation",[1004,4085,4086],{"class":1010},"(query: ",[1004,4088,1763],{"class":1017},[1004,4090,4091],{"class":1010},", language: ",[1004,4093,1763],{"class":1017},[1004,4095,1771],{"class":1279},[1004,4097,4098],{"class":1024}," \"zh\"",[1004,4100,4054],{"class":1010},[1004,4102,4103],{"class":1006,"line":1106},[1004,4104,4105],{"class":1024},"    \"\"\"在官方技术文档中搜索信息。\n",[1004,4107,4108],{"class":1006,"line":1112},[1004,4109,4110],{"class":1024},"    当用户询问 API 用法、配置参数、最佳实践等技术问题时使用。\n",[1004,4112,4113],{"class":1006,"line":1120},[1004,4114,4115],{"class":1024},"    返回最相关的文档片段和链接。\n",[1004,4117,4118],{"class":1006,"line":1131},[1004,4119,4120],{"class":1024},"    \"\"\"\n",[1004,4122,4123],{"class":1006,"line":1143},[1004,4124,3903],{"class":1017},[3865,4126,4128],{"id":4127},"_3-返回结构化结果","3. 返回结构化结果",[908,4130,4132],{"className":1270,"code":4131,"language":1272,"meta":11,"style":11},"# 不好：返回非结构化文本\ndef get_order(order_id):\n    return f\"订单{order_id}状态：已发货，预计明天到达\"\n\n# 好：返回结构化数据\ndef get_order(order_id: str) -> dict:\n    return {\n        \"order_id\": order_id,\n        \"status\": \"shipped\",\n        \"estimated_delivery\": \"2025-03-15\",\n        \"tracking_number\": \"SF1234567890\",\n        \"items\": [{\"name\": \"机械键盘\", \"quantity\": 1, \"price\": 399.0}]\n    }\n",[916,4133,4134,4139,4149,4168,4172,4177,4194,4200,4208,4220,4232,4244,4281],{"__ignoreMap":11},[1004,4135,4136],{"class":1006,"line":1007},[1004,4137,4138],{"class":1322},"# 不好：返回非结构化文本\n",[1004,4140,4141,4143,4146],{"class":1006,"line":1014},[1004,4142,1753],{"class":1279},[1004,4144,4145],{"class":1756}," get_order",[1004,4147,4148],{"class":1010},"(order_id):\n",[1004,4150,4151,4153,4155,4158,4160,4163,4165],{"class":1006,"line":1031},[1004,4152,1801],{"class":1279},[1004,4154,2927],{"class":1279},[1004,4156,4157],{"class":1024},"\"订单",[1004,4159,1935],{"class":1017},[1004,4161,4162],{"class":1010},"order_id",[1004,4164,1941],{"class":1017},[1004,4166,4167],{"class":1024},"状态：已发货，预计明天到达\"\n",[1004,4169,4170],{"class":1006,"line":1044},[1004,4171,1302],{"emptyLinePlaceholder":1301},[1004,4173,4174],{"class":1006,"line":1053},[1004,4175,4176],{"class":1322},"# 好：返回结构化数据\n",[1004,4178,4179,4181,4183,4186,4188,4190,4192],{"class":1006,"line":1066},[1004,4180,1753],{"class":1279},[1004,4182,4145],{"class":1756},[1004,4184,4185],{"class":1010},"(order_id: ",[1004,4187,1763],{"class":1017},[1004,4189,1777],{"class":1010},[1004,4191,1780],{"class":1017},[1004,4193,1783],{"class":1010},[1004,4195,4196,4198],{"class":1006,"line":1074},[1004,4197,1801],{"class":1279},[1004,4199,1804],{"class":1010},[1004,4201,4202,4205],{"class":1006,"line":1082},[1004,4203,4204],{"class":1024},"        \"order_id\"",[1004,4206,4207],{"class":1010},": order_id,\n",[1004,4209,4210,4213,4215,4218],{"class":1006,"line":1095},[1004,4211,4212],{"class":1024},"        \"status\"",[1004,4214,1021],{"class":1010},[1004,4216,4217],{"class":1024},"\"shipped\"",[1004,4219,1028],{"class":1010},[1004,4221,4222,4225,4227,4230],{"class":1006,"line":1106},[1004,4223,4224],{"class":1024},"        \"estimated_delivery\"",[1004,4226,1021],{"class":1010},[1004,4228,4229],{"class":1024},"\"2025-03-15\"",[1004,4231,1028],{"class":1010},[1004,4233,4234,4237,4239,4242],{"class":1006,"line":1112},[1004,4235,4236],{"class":1024},"        \"tracking_number\"",[1004,4238,1021],{"class":1010},[1004,4240,4241],{"class":1024},"\"SF1234567890\"",[1004,4243,1028],{"class":1010},[1004,4245,4246,4249,4252,4254,4256,4259,4261,4264,4266,4269,4271,4273,4275,4278],{"class":1006,"line":1120},[1004,4247,4248],{"class":1024},"        \"items\"",[1004,4250,4251],{"class":1010},": [{",[1004,4253,1924],{"class":1024},[1004,4255,1021],{"class":1010},[1004,4257,4258],{"class":1024},"\"机械键盘\"",[1004,4260,1155],{"class":1010},[1004,4262,4263],{"class":1024},"\"quantity\"",[1004,4265,1021],{"class":1010},[1004,4267,4268],{"class":1017},"1",[1004,4270,1155],{"class":1010},[1004,4272,1949],{"class":1024},[1004,4274,1021],{"class":1010},[1004,4276,4277],{"class":1017},"399.0",[1004,4279,4280],{"class":1010},"}]\n",[1004,4282,4283],{"class":1006,"line":1131},[1004,4284,1731],{"class":1010},[3865,4286,4288],{"id":4287},"_4-参数使用枚举约束","4. 参数使用枚举约束",[908,4290,4292],{"className":1270,"code":4291,"language":1272,"meta":11,"style":11},"# 好：使用 enum 限制参数取值范围\n{\n    \"name\": \"query_logs\",\n    \"description\": \"查询系统日志\",\n    \"parameters\": {\n        \"type\": \"object\",\n        \"properties\": {\n            \"level\": {\n                \"type\": \"string\",\n                \"enum\": [\"DEBUG\", \"INFO\", \"WARNING\", \"ERROR\", \"CRITICAL\"],\n                \"description\": \"日志级别\"\n            },\n            \"service\": {\n                \"type\": \"string\",\n                \"enum\": [\"api-gateway\", \"user-service\", \"order-service\"],\n                \"description\": \"服务名称\"\n            }\n        },\n        \"required\": [\"level\"]\n    }\n}\n",[916,4293,4294,4299,4303,4315,4327,4334,4344,4351,4358,4368,4400,4410,4414,4421,4431,4452,4461,4465,4470,4482,4486],{"__ignoreMap":11},[1004,4295,4296],{"class":1006,"line":1007},[1004,4297,4298],{"class":1322},"# 好：使用 enum 限制参数取值范围\n",[1004,4300,4301],{"class":1006,"line":1014},[1004,4302,1011],{"class":1010},[1004,4304,4305,4308,4310,4313],{"class":1006,"line":1031},[1004,4306,4307],{"class":1024},"    \"name\"",[1004,4309,1021],{"class":1010},[1004,4311,4312],{"class":1024},"\"query_logs\"",[1004,4314,1028],{"class":1010},[1004,4316,4317,4320,4322,4325],{"class":1006,"line":1044},[1004,4318,4319],{"class":1024},"    \"description\"",[1004,4321,1021],{"class":1010},[1004,4323,4324],{"class":1024},"\"查询系统日志\"",[1004,4326,1028],{"class":1010},[1004,4328,4329,4332],{"class":1006,"line":1053},[1004,4330,4331],{"class":1024},"    \"parameters\"",[1004,4333,1050],{"class":1010},[1004,4335,4336,4338,4340,4342],{"class":1006,"line":1066},[1004,4337,1085],{"class":1024},[1004,4339,1021],{"class":1010},[1004,4341,1061],{"class":1024},[1004,4343,1028],{"class":1010},[1004,4345,4346,4349],{"class":1006,"line":1074},[1004,4347,4348],{"class":1024},"        \"properties\"",[1004,4350,1050],{"class":1010},[1004,4352,4353,4356],{"class":1006,"line":1082},[1004,4354,4355],{"class":1024},"            \"level\"",[1004,4357,1050],{"class":1010},[1004,4359,4360,4362,4364,4366],{"class":1006,"line":1095},[1004,4361,1392],{"class":1024},[1004,4363,1021],{"class":1010},[1004,4365,1090],{"class":1024},[1004,4367,1028],{"class":1010},[1004,4369,4370,4373,4375,4378,4380,4383,4385,4388,4390,4393,4395,4398],{"class":1006,"line":1106},[1004,4371,4372],{"class":1024},"                \"enum\"",[1004,4374,1149],{"class":1010},[1004,4376,4377],{"class":1024},"\"DEBUG\"",[1004,4379,1155],{"class":1010},[1004,4381,4382],{"class":1024},"\"INFO\"",[1004,4384,1155],{"class":1010},[1004,4386,4387],{"class":1024},"\"WARNING\"",[1004,4389,1155],{"class":1010},[1004,4391,4392],{"class":1024},"\"ERROR\"",[1004,4394,1155],{"class":1010},[1004,4396,4397],{"class":1024},"\"CRITICAL\"",[1004,4399,1473],{"class":1010},[1004,4401,4402,4405,4407],{"class":1006,"line":1112},[1004,4403,4404],{"class":1024},"                \"description\"",[1004,4406,1021],{"class":1010},[1004,4408,4409],{"class":1024},"\"日志级别\"\n",[1004,4411,4412],{"class":1006,"line":1120},[1004,4413,2586],{"class":1010},[1004,4415,4416,4419],{"class":1006,"line":1131},[1004,4417,4418],{"class":1024},"            \"service\"",[1004,4420,1050],{"class":1010},[1004,4422,4423,4425,4427,4429],{"class":1006,"line":1143},[1004,4424,1392],{"class":1024},[1004,4426,1021],{"class":1010},[1004,4428,1090],{"class":1024},[1004,4430,1028],{"class":1010},[1004,4432,4433,4435,4437,4440,4442,4445,4447,4450],{"class":1006,"line":1174},[1004,4434,4372],{"class":1024},[1004,4436,1149],{"class":1010},[1004,4438,4439],{"class":1024},"\"api-gateway\"",[1004,4441,1155],{"class":1010},[1004,4443,4444],{"class":1024},"\"user-service\"",[1004,4446,1155],{"class":1010},[1004,4448,4449],{"class":1024},"\"order-service\"",[1004,4451,1473],{"class":1010},[1004,4453,4454,4456,4458],{"class":1006,"line":1179},[1004,4455,4404],{"class":1024},[1004,4457,1021],{"class":1010},[1004,4459,4460],{"class":1024},"\"服务名称\"\n",[1004,4462,4463],{"class":1006,"line":1187},[1004,4464,1512],{"class":1010},[1004,4466,4467],{"class":1006,"line":1199},[1004,4468,4469],{"class":1010},"        },\n",[1004,4471,4472,4475,4477,4480],{"class":1006,"line":1211},[1004,4473,4474],{"class":1024},"        \"required\"",[1004,4476,1149],{"class":1010},[1004,4478,4479],{"class":1024},"\"level\"",[1004,4481,1171],{"class":1010},[1004,4483,4484],{"class":1006,"line":1222},[1004,4485,1731],{"class":1010},[1004,4487,4488],{"class":1006,"line":1228},[1004,4489,1256],{"class":1010},[3865,4491,4493],{"id":4492},"_5-工具数量控制","5. 工具数量控制",[3339,4495,4496,4506],{},[3342,4497,4498],{},[3345,4499,4500,4503],{},[3348,4501,4502],{},"工具数量",[3348,4504,4505],{},"建议",[3358,4507,4508,4516,4524,4532],{},[3345,4509,4510,4513],{},[3363,4511,4512],{},"1-5 个",[3363,4514,4515],{},"理想范围，模型选择准确率最高",[3345,4517,4518,4521],{},[3363,4519,4520],{},"6-15 个",[3363,4522,4523],{},"可以接受，注意描述区分度",[3345,4525,4526,4529],{},[3363,4527,4528],{},"15-30 个",[3363,4530,4531],{},"需要分类组织，考虑使用工具路由",[3345,4533,4534,4537],{},[3363,4535,4536],{},"30+ 个",[3363,4538,4539],{},"应拆分为多个专业 Agent",[1258,4541,4542],{},"\n如果工具数量较多，可以实现一个\"工具路由器\"——先让模型选择工具类别，再在该类别内选择具体工具。这样能显著提高工具选择的准确率。\n",[892,4544,4545],{"id":4545},"构建自定义工具",[896,4547,4548],{},"以下是一个完整的自定义工具构建示例，包含数据库查询和 API 调用：",[908,4550,4552],{"className":1270,"code":4551,"language":1272,"meta":11,"style":11},"import httpx\nimport sqlite3\nfrom typing import Optional\n\nclass ToolKit:\n    \"\"\"工具集封装\"\"\"\n\n    def __init__(self, db_path: str, api_base: str):\n        self.db_path = db_path\n        self.api_base = api_base\n\n    def query_database(self, sql: str, params: Optional[list] = None) -> dict:\n        \"\"\"执行 SQL 查询（只读）\n\n        Args:\n            sql: SELECT 查询语句\n            params: 查询参数列表\n\n        Returns:\n            查询结果列表\n        \"\"\"\n        if not sql.strip().upper().startswith(\"SELECT\"):\n            return {\"error\": \"仅支持 SELECT 查询\"}\n\n        conn = sqlite3.connect(self.db_path)\n        conn.row_factory = sqlite3.Row\n        try:\n            cursor = conn.execute(sql, params or [])\n            rows = [dict(row) for row in cursor.fetchall()]\n            return {\"results\": rows, \"count\": len(rows)}\n        except sqlite3.Error as e:\n            return {\"error\": f\"查询失败: {e}\"}\n        finally:\n            conn.close()\n\n    def call_api(self, endpoint: str, method: str = \"GET\",\n                 body: Optional[dict] = None) -> dict:\n        \"\"\"调用外部 REST API\n\n        Args:\n            endpoint: API 路径（如 \u002Fusers\u002F123）\n            method: HTTP 方法（GET、POST、PUT、DELETE）\n            body: 请求体（用于 POST\u002FPUT）\n\n        Returns:\n            API 响应数据\n        \"\"\"\n        url = f\"{self.api_base}{endpoint}\"\n        try:\n            with httpx.Client(timeout=10) as client:\n                response = client.request(method, url, json=body)\n                response.raise_for_status()\n                return {\"status\": response.status_code, \"data\": response.json()}\n        except httpx.TimeoutException:\n            return {\"error\": \"API 请求超时\"}\n        except httpx.HTTPStatusError as e:\n            return {\"error\": f\"API 错误: {e.response.status_code}\"}\n\n    def get_tool_definitions(self) -> list:\n        \"\"\"生成工具定义列表，供 LLM 使用\"\"\"\n        return [\n            {\n                \"name\": \"query_database\",\n                \"description\": \"在内部数据库中执行 SQL 查询。仅支持 SELECT 语句。\",\n                \"parameters\": {\n                    \"type\": \"object\",\n                    \"properties\": {\n                        \"sql\": {\"type\": \"string\", \"description\": \"SQL SELECT 查询语句\"},\n                        \"params\": {\"type\": \"array\", \"items\": {\"type\": \"string\"},\n                                   \"description\": \"查询参数\"}\n                    },\n                    \"required\": [\"sql\"]\n                }\n            },\n            {\n                \"name\": \"call_api\",\n                \"description\": \"调用外部 REST API 获取或修改数据。\",\n                \"parameters\": {\n                    \"type\": \"object\",\n                    \"properties\": {\n                        \"endpoint\": {\"type\": \"string\", \"description\": \"API 路径\"},\n                        \"method\": {\"type\": \"string\", \"enum\": [\"GET\", \"POST\", \"PUT\", \"DELETE\"]},\n                        \"body\": {\"type\": \"object\", \"description\": \"请求体\"}\n                    },\n                    \"required\": [\"endpoint\"]\n                }\n            }\n        ]\n",[916,4553,4554,4561,4568,4580,4584,4594,4599,4603,4623,4636,4648,4652,4682,4687,4691,4696,4701,4706,4710,4715,4720,4725,4740,4756,4760,4776,4786,4793,4808,4833,4856,4869,4894,4901,4906,4910,4934,4953,4958,4962,4966,4971,4976,4981,4985,4989,4994,4998,5025,5031,5055,5072,5077,5096,5103,5118,5129,5155,5159,5173,5178,5184,5189,5201,5212,5219,5229,5236,5263,5292,5304,5308,5320,5324,5328,5332,5343,5354,5360,5370,5376,5400,5441,5465,5469,5480,5484,5488],{"__ignoreMap":11},[1004,4555,4556,4558],{"class":1006,"line":1007},[1004,4557,1280],{"class":1279},[1004,4559,4560],{"class":1010}," httpx\n",[1004,4562,4563,4565],{"class":1006,"line":1014},[1004,4564,1280],{"class":1279},[1004,4566,4567],{"class":1010}," sqlite3\n",[1004,4569,4570,4572,4575,4577],{"class":1006,"line":1031},[1004,4571,1288],{"class":1279},[1004,4573,4574],{"class":1010}," typing ",[1004,4576,1280],{"class":1279},[1004,4578,4579],{"class":1010}," Optional\n",[1004,4581,4582],{"class":1006,"line":1044},[1004,4583,1302],{"emptyLinePlaceholder":1301},[1004,4585,4586,4589,4592],{"class":1006,"line":1053},[1004,4587,4588],{"class":1279},"class",[1004,4590,4591],{"class":1756}," ToolKit",[1004,4593,1783],{"class":1010},[1004,4595,4596],{"class":1006,"line":1066},[1004,4597,4598],{"class":1024},"    \"\"\"工具集封装\"\"\"\n",[1004,4600,4601],{"class":1006,"line":1074},[1004,4602,1302],{"emptyLinePlaceholder":1301},[1004,4604,4605,4608,4611,4614,4616,4619,4621],{"class":1006,"line":1082},[1004,4606,4607],{"class":1279},"    def",[1004,4609,4610],{"class":1017}," __init__",[1004,4612,4613],{"class":1010},"(self, db_path: ",[1004,4615,1763],{"class":1017},[1004,4617,4618],{"class":1010},", api_base: ",[1004,4620,1763],{"class":1017},[1004,4622,4054],{"class":1010},[1004,4624,4625,4628,4631,4633],{"class":1006,"line":1095},[1004,4626,4627],{"class":1017},"        self",[1004,4629,4630],{"class":1010},".db_path ",[1004,4632,1310],{"class":1279},[1004,4634,4635],{"class":1010}," db_path\n",[1004,4637,4638,4640,4643,4645],{"class":1006,"line":1106},[1004,4639,4627],{"class":1017},[1004,4641,4642],{"class":1010},".api_base ",[1004,4644,1310],{"class":1279},[1004,4646,4647],{"class":1010}," api_base\n",[1004,4649,4650],{"class":1006,"line":1112},[1004,4651,1302],{"emptyLinePlaceholder":1301},[1004,4653,4654,4656,4659,4662,4664,4667,4669,4672,4674,4676,4678,4680],{"class":1006,"line":1120},[1004,4655,4607],{"class":1279},[1004,4657,4658],{"class":1756}," query_database",[1004,4660,4661],{"class":1010},"(self, sql: ",[1004,4663,1763],{"class":1017},[1004,4665,4666],{"class":1010},", params: Optional[",[1004,4668,1894],{"class":1017},[1004,4670,4671],{"class":1010},"] ",[1004,4673,1310],{"class":1279},[1004,4675,1879],{"class":1017},[1004,4677,1777],{"class":1010},[1004,4679,1780],{"class":1017},[1004,4681,1783],{"class":1010},[1004,4683,4684],{"class":1006,"line":1131},[1004,4685,4686],{"class":1024},"        \"\"\"执行 SQL 查询（只读）\n",[1004,4688,4689],{"class":1006,"line":1143},[1004,4690,1302],{"emptyLinePlaceholder":1301},[1004,4692,4693],{"class":1006,"line":1174},[1004,4694,4695],{"class":1024},"        Args:\n",[1004,4697,4698],{"class":1006,"line":1179},[1004,4699,4700],{"class":1024},"            sql: SELECT 查询语句\n",[1004,4702,4703],{"class":1006,"line":1187},[1004,4704,4705],{"class":1024},"            params: 查询参数列表\n",[1004,4707,4708],{"class":1006,"line":1199},[1004,4709,1302],{"emptyLinePlaceholder":1301},[1004,4711,4712],{"class":1006,"line":1211},[1004,4713,4714],{"class":1024},"        Returns:\n",[1004,4716,4717],{"class":1006,"line":1222},[1004,4718,4719],{"class":1024},"            查询结果列表\n",[1004,4721,4722],{"class":1006,"line":1228},[1004,4723,4724],{"class":1024},"        \"\"\"\n",[1004,4726,4727,4729,4732,4735,4738],{"class":1006,"line":1234},[1004,4728,3521],{"class":1279},[1004,4730,4731],{"class":1279}," not",[1004,4733,4734],{"class":1010}," sql.strip().upper().startswith(",[1004,4736,4737],{"class":1024},"\"SELECT\"",[1004,4739,4054],{"class":1010},[1004,4741,4742,4744,4746,4749,4751,4754],{"class":1006,"line":1247},[1004,4743,3538],{"class":1279},[1004,4745,2750],{"class":1010},[1004,4747,4748],{"class":1024},"\"error\"",[1004,4750,1021],{"class":1010},[1004,4752,4753],{"class":1024},"\"仅支持 SELECT 查询\"",[1004,4755,1256],{"class":1010},[1004,4757,4758],{"class":1006,"line":1253},[1004,4759,1302],{"emptyLinePlaceholder":1301},[1004,4761,4762,4765,4767,4770,4773],{"class":1006,"line":1490},[1004,4763,4764],{"class":1010},"        conn ",[1004,4766,1310],{"class":1279},[1004,4768,4769],{"class":1010}," sqlite3.connect(",[1004,4771,4772],{"class":1017},"self",[1004,4774,4775],{"class":1010},".db_path)\n",[1004,4777,4778,4781,4783],{"class":1006,"line":1496},[1004,4779,4780],{"class":1010},"        conn.row_factory ",[1004,4782,1310],{"class":1279},[1004,4784,4785],{"class":1010}," sqlite3.Row\n",[1004,4787,4788,4791],{"class":1006,"line":1509},[1004,4789,4790],{"class":1279},"        try",[1004,4792,1783],{"class":1010},[1004,4794,4795,4798,4800,4803,4805],{"class":1006,"line":1515},[1004,4796,4797],{"class":1010},"            cursor ",[1004,4799,1310],{"class":1279},[1004,4801,4802],{"class":1010}," conn.execute(sql, params ",[1004,4804,1965],{"class":1279},[1004,4806,4807],{"class":1010}," [])\n",[1004,4809,4810,4813,4815,4818,4820,4823,4825,4828,4830],{"class":1006,"line":1521},[1004,4811,4812],{"class":1010},"            rows ",[1004,4814,1310],{"class":1279},[1004,4816,4817],{"class":1010}," [",[1004,4819,1780],{"class":1017},[1004,4821,4822],{"class":1010},"(row) ",[1004,4824,3295],{"class":1279},[1004,4826,4827],{"class":1010}," row ",[1004,4829,2248],{"class":1279},[1004,4831,4832],{"class":1010}," cursor.fetchall()]\n",[1004,4834,4835,4837,4839,4842,4845,4848,4850,4853],{"class":1006,"line":1526},[1004,4836,3538],{"class":1279},[1004,4838,2750],{"class":1010},[1004,4840,4841],{"class":1024},"\"results\"",[1004,4843,4844],{"class":1010},": rows, ",[1004,4846,4847],{"class":1024},"\"count\"",[1004,4849,1021],{"class":1010},[1004,4851,4852],{"class":1017},"len",[1004,4854,4855],{"class":1010},"(rows)}\n",[1004,4857,4858,4861,4864,4867],{"class":1006,"line":1531},[1004,4859,4860],{"class":1279},"        except",[1004,4862,4863],{"class":1010}," sqlite3.Error ",[1004,4865,4866],{"class":1279},"as",[1004,4868,2920],{"class":1010},[1004,4870,4871,4873,4875,4877,4879,4881,4884,4886,4888,4890,4892],{"class":1006,"line":1542},[1004,4872,3538],{"class":1279},[1004,4874,2750],{"class":1010},[1004,4876,4748],{"class":1024},[1004,4878,1021],{"class":1010},[1004,4880,1929],{"class":1279},[1004,4882,4883],{"class":1024},"\"查询失败: ",[1004,4885,1935],{"class":1017},[1004,4887,2935],{"class":1010},[1004,4889,1941],{"class":1017},[1004,4891,1932],{"class":1024},[1004,4893,1256],{"class":1010},[1004,4895,4896,4899],{"class":1006,"line":1549},[1004,4897,4898],{"class":1279},"        finally",[1004,4900,1783],{"class":1010},[1004,4902,4903],{"class":1006,"line":1561},[1004,4904,4905],{"class":1010},"            conn.close()\n",[1004,4907,4908],{"class":1006,"line":1573},[1004,4909,1302],{"emptyLinePlaceholder":1301},[1004,4911,4912,4914,4917,4920,4922,4925,4927,4929,4932],{"class":1006,"line":1580},[1004,4913,4607],{"class":1279},[1004,4915,4916],{"class":1756}," call_api",[1004,4918,4919],{"class":1010},"(self, endpoint: ",[1004,4921,1763],{"class":1017},[1004,4923,4924],{"class":1010},", method: ",[1004,4926,1763],{"class":1017},[1004,4928,1771],{"class":1279},[1004,4930,4931],{"class":1024}," \"GET\"",[1004,4933,1028],{"class":1010},[1004,4935,4936,4939,4941,4943,4945,4947,4949,4951],{"class":1006,"line":1591},[1004,4937,4938],{"class":1010},"                 body: Optional[",[1004,4940,1780],{"class":1017},[1004,4942,4671],{"class":1010},[1004,4944,1310],{"class":1279},[1004,4946,1879],{"class":1017},[1004,4948,1777],{"class":1010},[1004,4950,1780],{"class":1017},[1004,4952,1783],{"class":1010},[1004,4954,4955],{"class":1006,"line":1598},[1004,4956,4957],{"class":1024},"        \"\"\"调用外部 REST API\n",[1004,4959,4960],{"class":1006,"line":1606},[1004,4961,1302],{"emptyLinePlaceholder":1301},[1004,4963,4964],{"class":1006,"line":1617},[1004,4965,4695],{"class":1024},[1004,4967,4968],{"class":1006,"line":1627},[1004,4969,4970],{"class":1024},"            endpoint: API 路径（如 \u002Fusers\u002F123）\n",[1004,4972,4973],{"class":1006,"line":1632},[1004,4974,4975],{"class":1024},"            method: HTTP 方法（GET、POST、PUT、DELETE）\n",[1004,4977,4978],{"class":1006,"line":1640},[1004,4979,4980],{"class":1024},"            body: 请求体（用于 POST\u002FPUT）\n",[1004,4982,4983],{"class":1006,"line":1651},[1004,4984,1302],{"emptyLinePlaceholder":1301},[1004,4986,4987],{"class":1006,"line":1661},[1004,4988,4714],{"class":1024},[1004,4990,4991],{"class":1006,"line":1666},[1004,4992,4993],{"class":1024},"            API 响应数据\n",[1004,4995,4996],{"class":1006,"line":1674},[1004,4997,4724],{"class":1024},[1004,4999,5000,5003,5005,5007,5009,5012,5015,5018,5021,5023],{"class":1006,"line":1686},[1004,5001,5002],{"class":1010},"        url ",[1004,5004,1310],{"class":1279},[1004,5006,2927],{"class":1279},[1004,5008,1932],{"class":1024},[1004,5010,5011],{"class":1017},"{self",[1004,5013,5014],{"class":1010},".api_base",[1004,5016,5017],{"class":1017},"}{",[1004,5019,5020],{"class":1010},"endpoint",[1004,5022,1941],{"class":1017},[1004,5024,2940],{"class":1024},[1004,5026,5027,5029],{"class":1006,"line":1696},[1004,5028,4790],{"class":1279},[1004,5030,1783],{"class":1010},[1004,5032,5033,5036,5039,5042,5044,5047,5050,5052],{"class":1006,"line":1701},[1004,5034,5035],{"class":1279},"            with",[1004,5037,5038],{"class":1010}," httpx.Client(",[1004,5040,5041],{"class":2138},"timeout",[1004,5043,1310],{"class":1279},[1004,5045,5046],{"class":1017},"10",[1004,5048,5049],{"class":1010},") ",[1004,5051,4866],{"class":1279},[1004,5053,5054],{"class":1010}," client:\n",[1004,5056,5057,5060,5062,5065,5067,5069],{"class":1006,"line":1706},[1004,5058,5059],{"class":1010},"                response ",[1004,5061,1310],{"class":1279},[1004,5063,5064],{"class":1010}," client.request(method, url, ",[1004,5066,1000],{"class":2138},[1004,5068,1310],{"class":1279},[1004,5070,5071],{"class":1010},"body)\n",[1004,5073,5074],{"class":1006,"line":1718},[1004,5075,5076],{"class":1010},"                response.raise_for_status()\n",[1004,5078,5079,5082,5084,5087,5090,5093],{"class":1006,"line":1723},[1004,5080,5081],{"class":1279},"                return",[1004,5083,2750],{"class":1010},[1004,5085,5086],{"class":1024},"\"status\"",[1004,5088,5089],{"class":1010},": response.status_code, ",[1004,5091,5092],{"class":1024},"\"data\"",[1004,5094,5095],{"class":1010},": response.json()}\n",[1004,5097,5098,5100],{"class":1006,"line":1728},[1004,5099,4860],{"class":1279},[1004,5101,5102],{"class":1010}," httpx.TimeoutException:\n",[1004,5104,5105,5107,5109,5111,5113,5116],{"class":1006,"line":1734},[1004,5106,3538],{"class":1279},[1004,5108,2750],{"class":1010},[1004,5110,4748],{"class":1024},[1004,5112,1021],{"class":1010},[1004,5114,5115],{"class":1024},"\"API 请求超时\"",[1004,5117,1256],{"class":1010},[1004,5119,5120,5122,5125,5127],{"class":1006,"line":1739},[1004,5121,4860],{"class":1279},[1004,5123,5124],{"class":1010}," httpx.HTTPStatusError ",[1004,5126,4866],{"class":1279},[1004,5128,2920],{"class":1010},[1004,5130,5131,5133,5135,5137,5139,5141,5144,5146,5149,5151,5153],{"class":1006,"line":1744},[1004,5132,3538],{"class":1279},[1004,5134,2750],{"class":1010},[1004,5136,4748],{"class":1024},[1004,5138,1021],{"class":1010},[1004,5140,1929],{"class":1279},[1004,5142,5143],{"class":1024},"\"API 错误: ",[1004,5145,1935],{"class":1017},[1004,5147,5148],{"class":1010},"e.response.status_code",[1004,5150,1941],{"class":1017},[1004,5152,1932],{"class":1024},[1004,5154,1256],{"class":1010},[1004,5156,5157],{"class":1006,"line":1750},[1004,5158,1302],{"emptyLinePlaceholder":1301},[1004,5160,5161,5163,5166,5169,5171],{"class":1006,"line":1786},[1004,5162,4607],{"class":1279},[1004,5164,5165],{"class":1756}," get_tool_definitions",[1004,5167,5168],{"class":1010},"(self) -> ",[1004,5170,1894],{"class":1017},[1004,5172,1783],{"class":1010},[1004,5174,5175],{"class":1006,"line":1792},[1004,5176,5177],{"class":1024},"        \"\"\"生成工具定义列表，供 LLM 使用\"\"\"\n",[1004,5179,5180,5182],{"class":1006,"line":1798},[1004,5181,2900],{"class":1279},[1004,5183,1333],{"class":1010},[1004,5185,5186],{"class":1006,"line":1807},[1004,5187,5188],{"class":1010},"            {\n",[1004,5190,5191,5194,5196,5199],{"class":1006,"line":1816},[1004,5192,5193],{"class":1024},"                \"name\"",[1004,5195,1021],{"class":1010},[1004,5197,5198],{"class":1024},"\"query_database\"",[1004,5200,1028],{"class":1010},[1004,5202,5203,5205,5207,5210],{"class":1006,"line":1829},[1004,5204,4404],{"class":1024},[1004,5206,1021],{"class":1010},[1004,5208,5209],{"class":1024},"\"在内部数据库中执行 SQL 查询。仅支持 SELECT 语句。\"",[1004,5211,1028],{"class":1010},[1004,5213,5214,5217],{"class":1006,"line":1838},[1004,5215,5216],{"class":1024},"                \"parameters\"",[1004,5218,1050],{"class":1010},[1004,5220,5221,5223,5225,5227],{"class":1006,"line":1849},[1004,5222,2560],{"class":1024},[1004,5224,1021],{"class":1010},[1004,5226,1061],{"class":1024},[1004,5228,1028],{"class":1010},[1004,5230,5231,5234],{"class":1006,"line":1854},[1004,5232,5233],{"class":1024},"                    \"properties\"",[1004,5235,1050],{"class":1010},[1004,5237,5238,5241,5244,5247,5249,5251,5253,5256,5258,5261],{"class":1006,"line":1859},[1004,5239,5240],{"class":1024},"                        \"sql\"",[1004,5242,5243],{"class":1010},": {",[1004,5245,5246],{"class":1024},"\"type\"",[1004,5248,1021],{"class":1010},[1004,5250,1090],{"class":1024},[1004,5252,1155],{"class":1010},[1004,5254,5255],{"class":1024},"\"description\"",[1004,5257,1021],{"class":1010},[1004,5259,5260],{"class":1024},"\"SQL SELECT 查询语句\"",[1004,5262,1971],{"class":1010},[1004,5264,5265,5268,5270,5272,5274,5277,5279,5282,5284,5286,5288,5290],{"class":1006,"line":1899},[1004,5266,5267],{"class":1024},"                        \"params\"",[1004,5269,5243],{"class":1010},[1004,5271,5246],{"class":1024},[1004,5273,1021],{"class":1010},[1004,5275,5276],{"class":1024},"\"array\"",[1004,5278,1155],{"class":1010},[1004,5280,5281],{"class":1024},"\"items\"",[1004,5283,5243],{"class":1010},[1004,5285,5246],{"class":1024},[1004,5287,1021],{"class":1010},[1004,5289,1090],{"class":1024},[1004,5291,1971],{"class":1010},[1004,5293,5294,5297,5299,5302],{"class":1006,"line":1905},[1004,5295,5296],{"class":1024},"                                   \"description\"",[1004,5298,1021],{"class":1010},[1004,5300,5301],{"class":1024},"\"查询参数\"",[1004,5303,1256],{"class":1010},[1004,5305,5306],{"class":1006,"line":1911},[1004,5307,1438],{"class":1010},[1004,5309,5310,5313,5315,5318],{"class":1006,"line":1918},[1004,5311,5312],{"class":1024},"                    \"required\"",[1004,5314,1149],{"class":1010},[1004,5316,5317],{"class":1024},"\"sql\"",[1004,5319,1171],{"class":1010},[1004,5321,5322],{"class":1006,"line":1974},[1004,5323,2581],{"class":1010},[1004,5325,5326],{"class":1006,"line":2017},[1004,5327,2586],{"class":1010},[1004,5329,5330],{"class":1006,"line":2023},[1004,5331,5188],{"class":1010},[1004,5333,5334,5336,5338,5341],{"class":1006,"line":2028},[1004,5335,5193],{"class":1024},[1004,5337,1021],{"class":1010},[1004,5339,5340],{"class":1024},"\"call_api\"",[1004,5342,1028],{"class":1010},[1004,5344,5345,5347,5349,5352],{"class":1006,"line":2034},[1004,5346,4404],{"class":1024},[1004,5348,1021],{"class":1010},[1004,5350,5351],{"class":1024},"\"调用外部 REST API 获取或修改数据。\"",[1004,5353,1028],{"class":1010},[1004,5355,5356,5358],{"class":1006,"line":2044},[1004,5357,5216],{"class":1024},[1004,5359,1050],{"class":1010},[1004,5361,5362,5364,5366,5368],{"class":1006,"line":2053},[1004,5363,2560],{"class":1024},[1004,5365,1021],{"class":1010},[1004,5367,1061],{"class":1024},[1004,5369,1028],{"class":1010},[1004,5371,5372,5374],{"class":1006,"line":2062},[1004,5373,5233],{"class":1024},[1004,5375,1050],{"class":1010},[1004,5377,5378,5381,5383,5385,5387,5389,5391,5393,5395,5398],{"class":1006,"line":2067},[1004,5379,5380],{"class":1024},"                        \"endpoint\"",[1004,5382,5243],{"class":1010},[1004,5384,5246],{"class":1024},[1004,5386,1021],{"class":1010},[1004,5388,1090],{"class":1024},[1004,5390,1155],{"class":1010},[1004,5392,5255],{"class":1024},[1004,5394,1021],{"class":1010},[1004,5396,5397],{"class":1024},"\"API 路径\"",[1004,5399,1971],{"class":1010},[1004,5401,5402,5405,5407,5409,5411,5413,5415,5418,5420,5423,5425,5428,5430,5433,5435,5438],{"class":1006,"line":2072},[1004,5403,5404],{"class":1024},"                        \"method\"",[1004,5406,5243],{"class":1010},[1004,5408,5246],{"class":1024},[1004,5410,1021],{"class":1010},[1004,5412,1090],{"class":1024},[1004,5414,1155],{"class":1010},[1004,5416,5417],{"class":1024},"\"enum\"",[1004,5419,1149],{"class":1010},[1004,5421,5422],{"class":1024},"\"GET\"",[1004,5424,1155],{"class":1010},[1004,5426,5427],{"class":1024},"\"POST\"",[1004,5429,1155],{"class":1010},[1004,5431,5432],{"class":1024},"\"PUT\"",[1004,5434,1155],{"class":1010},[1004,5436,5437],{"class":1024},"\"DELETE\"",[1004,5439,5440],{"class":1010},"]},\n",[1004,5442,5443,5446,5448,5450,5452,5454,5456,5458,5460,5463],{"class":1006,"line":2078},[1004,5444,5445],{"class":1024},"                        \"body\"",[1004,5447,5243],{"class":1010},[1004,5449,5246],{"class":1024},[1004,5451,1021],{"class":1010},[1004,5453,1061],{"class":1024},[1004,5455,1155],{"class":1010},[1004,5457,5255],{"class":1024},[1004,5459,1021],{"class":1010},[1004,5461,5462],{"class":1024},"\"请求体\"",[1004,5464,1256],{"class":1010},[1004,5466,5467],{"class":1006,"line":2088},[1004,5468,1438],{"class":1010},[1004,5470,5471,5473,5475,5478],{"class":1006,"line":2114},[1004,5472,5312],{"class":1024},[1004,5474,1149],{"class":1010},[1004,5476,5477],{"class":1024},"\"endpoint\"",[1004,5479,1171],{"class":1010},[1004,5481,5482],{"class":1006,"line":2119},[1004,5483,2581],{"class":1010},[1004,5485,5486],{"class":1006,"line":2124},[1004,5487,1512],{"class":1010},[1004,5489,5490],{"class":1006,"line":2135},[1004,5491,5492],{"class":1010},"        ]\n",[892,5494,5495],{"id":5495},"小结",[896,5497,5498],{},"工具调用是 AI Agent 从\"对话系统\"升级为\"执行系统\"的关键能力。掌握工具调用的核心要点：",[925,5500,5501,5507,5513,5519],{},[928,5502,5503,5506],{},[900,5504,5505],{},"理解流程","：模型生成调用请求 → 应用层执行 → 结果回传模型",[928,5508,5509,5512],{},[900,5510,5511],{},"精心定义","：好的工具描述和参数 Schema 是可靠调用的前提",[928,5514,5515,5518],{},[900,5516,5517],{},"完善错误处理","：工具调用链路长，每个环节都需要异常兜底",[928,5520,5521,5524],{},[900,5522,5523],{},"控制粒度","：工具职责单一、数量适中、描述清晰",[896,5526,5527],{},"在下一章的实战环节中，我们将把工具调用与 Agent 框架结合起来，构建一个完整的可运行的 AI Agent 系统。",[5529,5530,5531],"style",{},"html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":11,"searchDepth":1014,"depth":1014,"links":5533},[5534,5535,5536,5537,5538,5539,5540,5541,5548,5549],{"id":894,"depth":1014,"text":894},{"id":920,"depth":1014,"text":920},{"id":970,"depth":1014,"text":971},{"id":1263,"depth":1014,"text":1264},{"id":2445,"depth":1014,"text":2446},{"id":3336,"depth":1014,"text":3337},{"id":3464,"depth":1014,"text":3464},{"id":3863,"depth":1014,"text":3863,"children":5542},[5543,5544,5545,5546,5547],{"id":3867,"depth":1031,"text":3868},{"id":4024,"depth":1031,"text":4025},{"id":4127,"depth":1031,"text":4128},{"id":4287,"depth":1031,"text":4288},{"id":4492,"depth":1031,"text":4493},{"id":4545,"depth":1014,"text":4545},{"id":5495,"depth":1014,"text":5495},"md",{},{"title":38,"description":39},"ai\u002Fagent\u002Ftool-use","bzEz396G25hacFv2MErxNKA86TnwKlAfzue76hZwDfE",1775474635702]