@agentica/core

中文文档
0.45.1发布于 2026/05/20MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2439

专攻 LLM 函数的代理 AI 库

中文使用文档
文档目录6 节
  1. QQ 设置
  2. 游戏场
  3. 文件资源
  4. 为什么是Agentica?
  5. 社区和支持
  6. 许可证

Agentica, AI 函数调用框架

Agentica - ReadMe Diagram

MIT License NPM Version NPM Downloads Newsletter Top #6 Build Status

YouTube   Discord

  

Agentic AI框架专攻AI函数调用.

不要害怕AI代理开发. 列出下面三个协议的功能 这是所有你应该做的AI代理开发.

  • 类型脚本类
  • 斯瓦格/开放API 文档
  • MCP( 模式上下文协议) 服务器

想做个电子商务经纪人吗? 引进电子商务功能. 需要报社经纪人吗? 从报社获得API功能. 只要准备好任何你需要的功能, 然后它成为一个AI代理.

你是TypeScript开发者吗? 那你已经是AI开发商了 熟悉后端开发吗? 你已经精通AI的发展了 任何能制造功能的人都可以成为AI代理.


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<MobileFileSystem>(
      "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 设置

$ npx agentica start <directory>

----------------------------------------
 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 协议 用于客户端-服务器通信.

全面设置指示 请访问 开始 向导.

游戏场

Agentica亲身经历 互动操场 在安装前.

我们的演示展示了Agentica在各种整合方法中调用能力的能力和简单性.

E-commerce Agent Demo

文件资源

寻找我们的全面资源 官方网站 (简体中文)。 。 。 .

https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0d

教学录像:https://www.youtube.com/@wrtnlabs

为什么是Agentica?

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功能:

  • 编译器驱动开发:通过编译器技能而无需手写,构造函数调用schema.
  • JSON Schema 转换:自动处理LLM供应商之间的规格差异,无论你选择的AI模型如何,确保无缝集成.
  • 验证反馈:发现并纠正了AI在论证构成上的错误,大幅降低了错误,提高了可靠性.
  • 选择代理:过滤候选功能以尽量减少上下文使用,优化性能,并减少象征性消费.

由于这些创新,Agentica使得AI函数调用比以前更容易,更安全,更准确. 开发变得更直观,因为您只需要准备与您特定使用大小写相关的函数,而缩放您的代理的能力就像添加或去除函数一样简单.

2023年OpenAI宣布函数调用时,许多人预测函数调用驱动的AI开发会成为主流. 然而,在现实中,由于调用功能的困难和不稳定性,AI开发的趋势成为代理工作流程. 代理工作流程不灵活,必须为特定目的创建,它已经征服了AI代理生态系统.

顺便说一下,由于Agentica解决了函数调用的困难和不稳定问题,现在该是再次拥抱由函数驱动的AI开发的时候了.

类型工作流程香草函数调用Agentica 函数调用
目的具体常规常规
困难难难轻点
稳定稳定不稳定稳定
灵活性* 不灵活* 灵活* 灵活

社区和支持

为了获得支持、提问或反馈

Discord

许可证

Agentica是开源的,可在 MIT 许可证。 。 。 .

Wrtn Labs Logo

Agentica的维护者是: Wrtn技术 ——授权开发者将TypeScript功能和OpenAPI specs转化为强大的AI代理.

版本与发布记录

@agentica/core 共发布 152 个版本,首次发布于 2025/02/24;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.45.1latest2026/05/205 个月前
0.45.02026/04/276 个月前
0.45.0-dev.20260426next2026/04/266 个月前
0.44.12026/03/157 个月前
0.44.02026/03/137 个月前
0.44.0-dev.20260313-22026/03/137 个月前

其他发布通道:dev → 0.12.2-dev.20250314,next → 0.45.0-dev.20260426。

关于 @agentica/core 的常见问题

@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 和提交记录判断。