为 Agent 构建应用

把应用能力变成可通过 CLI、HTTP、MCP、OpenAI / AI SDK tools、React hook 和类型化 client 调用的结构化 action。

BOOTSTRAP.md|将此文件交给你的本地 coding assistant(如 Cursor、Claude Code)即可立即开始。
$npm install @ageniti/core
基于标准入口
ReactReact
TypeScriptTypeScript
Node.jsNode.js
npmnpm
Next.jsNext.js
OpenAI
Vercel
Claude
ReactReact
TypeScriptTypeScript
Node.jsNode.js
npmnpm
Next.jsNext.js
OpenAI
Vercel
Claude
开始路径

从适合你的接入方式开始

成熟的文档站会先帮你找到下一步。可以先跑通核心流程,也可以接入现有应用,或者直接从模板起步。

核心模型

定义一次,处处可观测

Action 是 agentic 能力的基础单元。每一个 surface、每一个消费者都从同一份 contract 和同一个流式 runtime 读取。

Input
Artifact
RUNTIME
Runtime

流式运行时

校验、权限、retry(每次重试新建 AbortController)、idempotency、并发限制、脱敏 —— 还有任何消费者都能订阅的实时事件流。

Surfaces

CLI / HTTP / MCP

三者都是 action contract 的薄适配层。MCP stdio 自动识别 Content-Length 与 newline framing;HTTP 返回细粒度状态码。

AI 工具

OpenAI / AI SDK / 类型化 Client

从同一份 action manifest 派生 OpenAI Chat & Responses tool 定义、Vercel AI SDK tools,以及类型化 client 的 .d.ts。

在你的 coding assistant 里打开

下载一份给本地 coding assistant 读取的 bootstrap markdown 文件。它会告诉 assistant 先 clone 仓库、定位 SDK 的 package root、阅读正确文档,然后从那里开始,不需要用户再手动做额外准备。

下载 bootstrap
为什么选择 Ageniti

一份 contract,所有 surface

Ageniti 提供 action contract 和 runtime 这一层基础设施。CLI、HTTP、MCP、OpenAI / AI SDK tools、React hook、类型化 client 全都从同一份定义派生。

一份 contract,所有 surface

CLI flags、HTTP 路由、MCP 工具、OpenAI / AI SDK tool 定义、React hook、类型化 client 全部从同一个 action 派生。永远不需要重复声明同一个能力。

用你已有的 schema

Zod、Valibot、ArkType 或任何实现 Standard Schema v1 的库都可以直接传入 —— Ageniti 自动识别并包装外部 schema,已有的类型校验保持不变。

流式事件作为基础原语

log / progress / artifact 实时作为事件发出,任何消费者都能订阅。在它之上构建聊天 UI、agent 循环、log shipper 都不需要拥有 action 本身。

生产级运行时控制

校验、权限、超时、retry(per-attempt 取消)、idempotency key、并发限制、密钥脱敏、细粒度错误码 —— 都收口在 runtime。

调用入口

覆盖主要集成路径

将选定的应用能力暴露到 Agent、运维与内部自动化真正会使用的环境中。

CLI
MCP
OpenAI Tools
AI SDK Tools
JSON Runner
React
Starter Patterns

用接入模式减少集成猜测

使用聚焦的 starter pattern,把一个应用能力接入 CLI、MCP、HTTP、React 或 tool-calling 入口,而不用猜项目结构。

查看全部 Patterns
接入方式

从一个能力开始,渐进接入

最好的接入方式通常不是重写,而是从一个边界清晰、已经稳定的能力开始,再逐步扩展。

1

封装一个能力

选择一个现有流程,例如搜索、开票或账户查询,并用 typed action contract 对外定义它。

2

补充 Headless 入口

保留现有 React 或 Next.js 结构,只增加一个 Node-safe 的应用入口,用来挂载 runtime 与生成 launcher。

3

按需输出 surface

根据场景生成所需入口,例如本地调试使用 CLI,接入 Agent 工具链时使用 MCP。

能力边界

盒子里有什么

Ageniti 专注在 contract 和 runtime 这一层,对你如何在它之上组合 action 不持立场。

内置

+所有 surface 都派生自的类型化 action contract
+处理校验、retry、cancel、idempotency、脱敏的 runtime
+任何消费者(UI / agent / log shipper)都能订阅的流式事件
+跨进程也能用的类型化 client + codegen

由你决定

-如何编排 prompt 或 agent 循环
-如何选工具、规划多步执行
-把记忆或 session state 放在哪
-如何组合长任务 workflow

从一个能力开始,而不是从重写开始

阅读文档,定义第一个 action,用明确、可审查的 contract 把真实应用能力暴露给外部工具、自动化系统和 Agent 调用方。

查看开发文档

我们在构建应用能力的标准调用层:明确的 contract、安全的调用入口,以及可复用的产品能力。