# @agentica/core 中文文档 规范地址：https://npmcn.com/package/%40agentica/core/ 版本：0\.45\.1 npm 元数据更新时间：2026-05-20T10:58:23.005Z 中文译文更新时间：2026-11-06T19:13:32.242Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40agentica/core 原文对照：https://npmcn.com/package/%40agentica/core/?lang=original 项目主页：https://wrtnlabs.io/agentica 源码仓库：https://github.com/wrtnlabs/agentica ## 关键信息（来自 npm 元数据） - 包体积（解压后）：9.3 MB，546 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：3 个 - peer 依赖：@modelcontextprotocol/sdk ^1\.12\.0，openai ^6\.38\.0，typia ^12\.0\.1 - 首次发布：2025-02-24T06:32:06.263Z - 最新版本发布：2026-05-20T10:58:22.711Z - 近 30 天下载量：2439（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：152（近 12 个月 29 个） ## 中文简介 专攻 LLM 函数的代理 AI 库 ## 安装 ```sh npm install @agentica/core ``` 也可以使用：`pnpm add @agentica/core`、`yarn add @agentica/core`、`bun add @agentica/core` ## README # Agentica, AI 函数调用框架 ![Agentica - ReadMe Diagram](https://github.com/user-attachments/assets/ecd06d51-b818-41c8-ab31-f0e40f48034e) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/agentica/blob/master/LICENSE) [![NPM Version](https://img.shields.io/npm/v/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core) [![NPM Downloads](https://img.shields.io/npm/dm/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core) [![Newsletter Top #6](https://img.shields.io/badge/DorMoshe%20Newsletter-Top%20%236%20of%201K-orange?style=flat&logo=rss)](https://dormoshe.io/newsletters/373) [![Build Status](https://github.com/wrtnlabs/agentica/workflows/build/badge.svg)](https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild) [![YouTube](https://img.shields.io/badge/YouTube%20Tutorial-0d1117?style=social&logo=youtube)](https://www.youtube.com/@wrtnlabs)  [![Discord](https://img.shields.io/badge/Discord-0d1117?style=social&logo=discord)](https://discord.gg/aMhRmzkqCx) [![](https://wrtnlabs.io/agentica/images/badges/fund-raising-news-202503.svg)](https://www.bloomberg.com/news/videos/2025-03-31/wtrn-on-series-b-funding-growth-strategy-video)   [![](https://wrtnlabs.io/agentica/images/badges/open-source-mission.svg)](https://github.com/wrtnlabs) Agentic AI框架专攻AI函数调用. 不要害怕AI代理开发. 列出下面三个协议的功能 这是所有你应该做的AI代理开发. - 类型脚本类 - 斯瓦格/开放API 文档 - MCP( 模式上下文协议) 服务器 想做个电子商务经纪人吗? 引进电子商务功能. 需要报社经纪人吗? 从报社获得API功能. 只要准备好任何你需要的功能, 然后它成为一个AI代理. 你是TypeScript开发者吗? 那你已经是AI开发商了 熟悉后端开发吗? 你已经精通AI的发展了 任何能制造功能的人都可以成为AI代理. ```typescript import { Agentica, assertHttpController } from "@agentica/core"; import OpenAI from "openai"; import typia from "typia"; import { MobileFileSystem } from "./services/MobileFileSystem"; const agent = new Agentica({ vendor: { api: new OpenAI({ apiKey: "********" }), model: "gpt-4o-mini", }, controllers: [ // functions from TypeScript class typia.llm.controller( "filesystem", new MobileFileSystem(), ), // functions from Swagger/OpenAPI assertHttpController({ name: "shopping", model: "chatgpt", document: await fetch( "https://shopping-be.wrtn.ai/editor/swagger.json", ).then(r => r.json()), connection: { host: "https://shopping-be.wrtn.ai", headers: { Authorization: "Bearer ********" }, }, }), ], }); await agent.conversate("I wanna buy MacBook Pro"); ``` ## QQ 设置 ```bash $ npx agentica start ---------------------------------------- Agentica Setup Wizard ---------------------------------------- ? Package Manager (use arrow keys) > npm pnpm yarn (berry is not supported) ? Project Type NodeJS Agent Server > NestJS Agent Server React Client Application Standalone Application ? Embedded Controllers (multi-selectable) (none) Google Calendar Google News > Github Reddit Slack ... ``` 设置向导帮助您创建一个适合您需要的新项目. 为了参考,在选择项目类型时,除“单独应用程序”之外,任何其他选项都将执行 [WebSocket 协议](https://wrtnlabs.io/agentica/docs/websocket/) 用于客户端-服务器通信. 全面设置指示 请访问 [开始](https://wrtnlabs.io/agentica/docs/) 向导. ## 游戏场 Agentica亲身经历 [互动操场](https://wrtnlabs.io/agentica/playground) 在安装前. 我们的演示展示了Agentica在各种整合方法中调用能力的能力和简单性. - [类型脚本类](https://wrtnlabs.io/agentica/playground/bbs) - [斯瓦格/开放API 文档](https://wrtnlabs.io/agentica/playground/uploader) - [企业电子商务代理商](https://wrtnlabs.io/agentica/playground/shopping) ![E-commerce Agent Demo](https://github.com/user-attachments/assets/fbfa9f93-304c-4728-933e-deb8ecd7a2af) ## 文件资源 寻找我们的全面资源 [官方网站 (简体中文)](https://wrtnlabs.io/agentica)。 。 。 . - [内容](https://wrtnlabs.io/agentica) - [指南文档](https://wrtnlabs.io/agentica/docs) - [设置](https://wrtnlabs.io/agentica/docs/setup/cli/) - [概念](https://wrtnlabs.io/agentica/docs/concepts/function-calling/) - [核心图书馆](https://wrtnlabs.io/agentica/docs/core/) - [WebSocket 协议](https://wrtnlabs.io/agentica/docs/websocket/) - [插件模块](https://wrtnlabs.io/agentica/docs/plugins/benchmark/) - [教学](https://wrtnlabs.io/agentica/tutorial) - [生产力](https://wrtnlabs.io/agentica/tutorial/productivity/arxiv/) - [编码](https://wrtnlabs.io/agentica/tutorial/coding/file-system/) - [原生反应](https://wrtnlabs.io/agentica/tutorial/react-native/sms/) - [企业](https://wrtnlabs.io/agentica/tutorial/enterprise/shopping/) - [API 文档](https://wrtnlabs.io/agentica/api) - [YouTube (英语)](https://www.youtube.com/@wrtnlabs) - [纸张](https://wrtnlabs.io/agentica/paper) [https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0d](https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0dd) > 教学录像:https://www.youtube.com/@wrtnlabs ## 为什么是Agentica? ```mermaid flowchart subgraph "JSON Schema Specification" schemav4("JSON Schema v4 ~ v7") --upgrades--> emended[["OpenAPI v3.1 (emended)"]] schema2910("JSON Schema 2019-03") --upgrades--> emended schema2020("JSON Schema 2020-12") --emends--> emended end subgraph "Agentica" emended --"Artificial Intelligence"--> fc{{"AI Function Calling"}} fc --"OpenAI"--> chatgpt("ChatGPT") fc --"Google"--> gemini("Gemini") fc --"Anthropic"--> claude("Claude") fc --"High-Flyer"--> deepseek("DeepSeek") fc --"Meta"--> llama("Llama") chatgpt --"3.1"--> custom(["Custom JSON Schema"]) gemini --"3.0"--> custom(["Custom JSON Schema"]) claude --"3.1"--> standard(["Standard JSON Schema"]) deepseek --"3.1"--> standard llama --"3.1"--> standard end ``` Agentica 通过以下策略增强AI功能: - [**编译器驱动开发**](https://wrtnlabs.io/agentica/docs/concepts/compiler-driven-development):通过编译器技能而无需手写,构造函数调用schema. - [**JSON Schema 转换**](https://wrtnlabs.io/agentica/docs/core/vendor/#schema-specification):自动处理LLM供应商之间的规格差异,无论你选择的AI模型如何,确保无缝集成. - [**验证反馈**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#validation-feedback):发现并纠正了AI在论证构成上的错误,大幅降低了错误,提高了可靠性. - [**选择代理**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#orchestration-strategy):过滤候选功能以尽量减少上下文使用,优化性能,并减少象征性消费. 由于这些创新,Agentica使得AI函数调用比以前更容易,更安全,更准确. 开发变得更直观,因为您只需要准备与您特定使用大小写相关的函数,而缩放您的代理的能力就像添加或去除函数一样简单. 2023年OpenAI宣布函数调用时,许多人预测函数调用驱动的AI开发会成为主流. 然而,在现实中,由于调用功能的困难和不稳定性,AI开发的趋势成为代理工作流程. 代理工作流程不灵活,必须为特定目的创建,它已经征服了AI代理生态系统. 顺便说一下,由于Agentica解决了函数调用的困难和不稳定问题,现在该是再次拥抱由函数驱动的AI开发的时候了. | 类型 | 工作流程 | 香草函数调用 | Agentica 函数调用 | | --- | --- | --- | --- | | 目的 | 具体 | 常规 | 常规 | | 困难 | 难 | 难 | 轻点 | | 稳定 | 稳定 | 不稳定 | 稳定 | | 灵活性 | \* 不灵活 | \* 灵活 | \* 灵活 | ## 社区和支持 为了获得支持、提问或反馈 [![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx)](https://discord.gg/aMhRmzkqCx) ## 许可证 Agentica是开源的,可在 [MIT 许可证](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)。 。 。 . ![Wrtn Labs Logo](https://github.com/user-attachments/assets/ecd0b82e-bfb7-4eb5-ae97-75be0cb22f10) Agentica的维护者是: [Wrtn技术](https://wrtnlabs.io/) ——授权开发者将TypeScript功能和OpenAPI specs转化为强大的AI代理. ## 常见问题 ### @agentica/core 是什么？ 专攻 LLM 函数的代理 AI 库 ### 如何安装 @agentica/core？ 在项目目录运行 npm install @agentica/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：openai（^6\.38\.0）、typia（^12\.0\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @agentica/core 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @agentica/core 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @agentica/core 可以商用吗？ @agentica/core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @agentica/core 的下载量有多少？ 根据 npm 官方下载统计，@agentica/core 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,439 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @agentica/core 还在维护吗？ 最新版本 0\.45\.1 发布于 2026/05/20（5 个月前）；至今共发布 152 个版本，其中过去 12 个月发布了 29 个；首次发布于 2025/02/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。