agentica
一个基于TypeScript的AI函数调用框架，让开发者轻松构建AI智能体。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agentica。 它的用途是：一个基于TypeScript的AI函数调用框架，让开发者轻松构建AI智能体。 完整的 Skill 内容见：https://321skill.com/skills/agentica/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想买一台 MacBook Pro。” 集成了电商 OpenAPI 的 Agentica 智能体会理解你的意图，自动调用商品查询、加入购物车等后端函数，并返回购买链接或库存信息。或者，
对AI说：“帮我总结一下上周的会议记录。” 智能体可以调用文件系统服务，找到对应文档并生成摘要。
介绍
Agentica 是一个专注于 AI 函数调用（Function Calling）的 TypeScript 框架，旨在降低 AI 智能体的开发门槛。它通过编译器技能增强，将开发者熟悉的函数（如 TypeScript 类方法、OpenAPI 文档、MCP 服务器）直接转化为 AI 可理解和调用的能力，从而快速构建具备专业功能的智能体。
使用 Agentica 非常简单。开发者只需按照框架要求，将已有的函数（来自 TypeScript 类、Swagger/OpenAPI 文档或 MCP 服务器）包装成控制器（controllers），然后与 AI 模型（如 OpenAI）集成。框架会自动处理函数描述的生成、参数验证和调用逻辑，开发者只需专注于业务函数本身。
该框架非常适合熟悉 TypeScript 或后端开发的工程师。如果你已经能编写函数或 API，那么你就已经具备了使用 Agentica 开发 AI 智能体的基础。它让 AI 开发回归到熟悉的函数式编程范式，无需深入学习复杂的提示工程或 Agent 编排原理。
建议从官方提供的项目设置向导（npx agentica start）开始，它能快速搭建一个包含常用嵌入式控制器（如 Github、Slack 等）的项目骨架。注意，目前它主要围绕 OpenAI 等商业模型设计，对本地模型的开箱即用支持可能需要额外配置。
核心特点
核心区别在于其“编译器增强”能力，能自动从 TypeScript 类型定义、OpenAPI 规范等源头精确生成 AI 可用的函数描述，极大减少了手动编写函数描述的繁琐和错误。同时，它原生支持将 MCP 服务器作为函数源，方便集成更广泛的工具生态。
注意事项
目前主要围绕 OpenAI 等商业 API 设计，对完全离线或特定本地模型的开箱即用支持可能有限。
常见问题
Agentica 和 LangChain 有什么区别？
Agentica 更专注于函数调用这一核心场景，通过编译器技术实现更精准、低成本的函数描述生成，而 LangChain 提供了更广泛但可能更复杂的 AI 应用构建模块。
需要很懂 AI 才能用吗？
不需要。如果你会写 TypeScript 函数或 API，就可以用 Agentica 快速构建 AI 智能体，它降低了 AI 开发的专业门槛。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agentica/raw/index.md 读取 agentica 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agentica/raw/index.md（查看排版版本）