把 LLM 变成会调用工具的 AI 代理Agentic 在 TypeScript 中的实践指南【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agenticAgentic 是一个 AI 代理标准库让 TypeScript 开发者用任意 LLM 和任意主流 TypeScript AI SDK 把外部能力接入工具调用工作流。它提供一组经过优化的 AI 函数既能当普通类直接调用也能交给模型自主决定何时、如何调用。从会聊天的 LLM到会调用工具的 AI 代理传统用法里你只能把答案直接喂给模型让它基于已有文本作答。一旦问题涉及实时信息、计算、检索或第三方服务纯对话就无能为力。LLM 工具调用function calling解决的就是这一步由模型根据上下文判断是否需要调用某个函数、用哪些参数调用。Agentic 做的事情是把可被模型调用的函数这件事标准化。它的核心是agentic/core封装了 AI 函数、schema 校验和结构化输出等通用工具每个具体能力比如搜索则是一个继承自AIFunctionsProvider的 TypeScript 类。类里的方法用aiFunction装饰器标注并配上 zod 输入 schema——schema 既校验参数也告诉模型每个字段是什么含义。同一个方法由此有两条使用路径当作普通类你在自己代码里new出实例、手动传参调用适合确定的流程。当作 LLM 工具把实例交给 SDK 的 tools 参数模型在对话中自行决定调用时机和入参。三个可迁移的典型工作流这些场景不绑定具体行业你可以按自己的业务替换背后的 API。1. 把外部数据接入 LLM 决策适合需要实时或权威信息、又不希望模型凭空编造的助手类应用比如查最新新闻、文档或商品的问答机器人。在 Agentic 里你不用自己拼 HTTP 请求和错误处理。像 stdlib/serper 这样的客户端已把检索接口封装成一个 AI 函数描述文案也面向模型写好它负责发起请求并解析结构化结果。你只需把这个函数挂到 tools 上模型在需要事实依据时就会主动调用而不是直接猜。2. 让 LLM 按条件调用计算与检索工具适合流程里有分支、由模型判断走哪一步的任务。例如用户一句话里可能同时包含查询和换算需求。Agentic 允许你把多个 AI 函数检索、计算等一起放进 tools。模型会根据当前对话上下文选择调用哪一个、传什么参数再把返回结果用于下一步推理。你负责定义函数模型负责路由。3. 把通知、计算和数据分析嵌入自动化流程适合后台批处理、定时任务这类不直接面向用户的场景比如跑完分析后给相关人发通知或汇总一批数据后产出结论。这类流程更强调确定调用所以你通常走普通类这条路在 Node 脚本里直接new出客户端、按固定顺序调用把 Agentic 当成一组带类型校验的函数库使用需要模型介入的环节再单独挂工具。快速开始安装 Agentic 并运行第一个工具调用如果你用 Vercel AI SDK装一个适配包即可它负责把 Agentic 函数转成 SDK 认识的 tools 对象npm i agentic/ai-sdk zod ai最小调用示例注释解释为什么这样调用import { createAISDKTools } from agentic/ai-sdk import { generateText } from ai // searchTool 是一个 Agentic 工具挂上后由模型自主决定何时调用 const result await generateText({ model: openai(gpt-4o-mini), tools: createAISDKTools(searchTool), toolChoice: required, // 强制本次必须走工具便于验证调用链路 prompt: What is the latest news about AI? }) console.log(result.toolResults[0])跑通之后你可以继续读 docs/ 里的集成说明或参考 examples/ 中的示例工程把工具换成你自己的。如何判断 Agentic 是否适合你的项目适合你要在 TypeScript 里做工具调用且希望跨多个 AI SDKVercel AI SDK、OpenAI、LangChain、LlamaIndex、Mastra、Genkit复用同一套函数你更在意工具质量和 schema 规范而不想手写 function 定义。不适合能力纯内部、无需模型调用、且只有一个 SDK 的场景——直接封装几个普通函数可能更轻。注意每个具体客户端通常需要配置对应的第三方 API keyzod 是硬依赖参数校验和模型说明都靠它工具描述文案会直接影响模型调用准确率上线前值得逐条核对。Agentic 的边界是让 LLM 可靠地调用外部函数这件事本身它管函数定义、参数 schema、结构化输出和跨 SDK 适配不管你的业务逻辑。如果确认需要让模型具备动手能力从安装agentic/ai-sdk再加一个检索工具开始是成本最低的一条验证路径。【免费下载链接】agenticYour API ⇒ Paid MCP. Instantly.项目地址: https://gitcode.com/GitHub_Trending/ag/agentic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考