Ax: 在类型脚本中构建可靠的AI Apps
别再用急件摔跤了 开始运输AI功能.
Ax 带来了 DSPy 对 TypeScript 的革命性方法 – 描述一下您想要的 想要,而让框架处理其余。 生产准备、类型安全、 与所有主要法学硕士合作.
在30秒内转变你的AI开发
import { ai, ax } from "@ax-llm/ax";
// 1. Pick any LLM
const llm = ai({ name: "openai", apiKey: process.env.OPENAI_APIKEY! });
// 2. Say what you want
const classifier = ax(
'review:string -> sentiment:class "positive, negative, neutral"',
);
// 3. Get type-safe results
const result = await classifier.forward(llm, {
review: "This product is amazing!",
});
console.log(result.sentiment); // "positive" ✨
就是这样. 没有快速工程。 没有试验和错误。 它和GPT-4合作过, 克劳德 双子座 或任何LLM.
裁决证据和重排
通过正常的Ax签名和AxGen使用Jev或OpenAI决定. 添加
(evidence) 或流畅 .withEvidence() 以布尔/类字段,并声明
命令的数值 score本地概率、选定值、,
连续得分,可选信心保留在结果中; 轴附加
供应商/模式来源。 基因模型使用相同的签名与
标出估计数 elicited没有本地人的信任 共享结果形状
并不意味着对各种模型的可比较信心进行校正.
const judge = ax(
'query:string, document:string -> relevant:boolean(evidence, threshold 0.7), relevance:score "Irrelevant, Related, Partial answer, Direct answer"(evidence)',
);
const decisions = ai({ name: 'openai-decisions', apiKey: process.env.OPENAI_APIKEY! });
const result = await judge.forward(decisions, {
query: 'How do I request a refund?',
document: 'Request a refund through your account billing page.',
});
console.log(result.relevance.value, result.relevant.probability);
重新排序时,请将候选身份识别码保存在应用程序代码中,并按
relevance.value。见 签字和裁决证据
对于阈值,结果形状和拒绝处理.
为什么成千上万的开发者选择 Ax
🎯 定义一次, 随地运行
写你的逻辑一次。 在 OpenAI、Anthropic、Google 或 15+ 之间切换 一行提供商。 不需要重写 .
⚡ 10号舰更快
停止微调提示。 界定投入-产出。 框架产生最佳效果 自动提示.
⚡ 供应商-本地速度
Ax 与直接提供者通话时保持相同的空档级,同时添加打字 产出、验证、重试、追踪和工具。 流是默认的 Ax 能够解析到达时的字段, 早期在流媒体断言中失败, 取消错误 输出,并在完成时开始更正,而不浪费符号 已经无效.
对照自己的供应商制定当前代码基准:
AX_STREAM_BENCH_PROVIDER=anthropic AX_STREAM_BENCH_MODEL=claude-sonnet-4-5-20250929 AX_STREAM_BENCH_RUNS=2 AX_STREAM_BENCH_WARMUP_RUNS=0 npm run tsx src/examples/streaming-latency.ts
AX_STREAM_BENCH_PROVIDER=google-gemini AX_STREAM_BENCH_MODEL=gemini-3.5-flash AX_STREAM_BENCH_RUNS=2 AX_STREAM_BENCH_WARMUP_RUNS=0 npm run tsx src/examples/streaming-latency.ts
🛡️ 生产 - 从第一天开始准备
建成通流,验证,处理出错,可观察. 初创企业使用 在生产中处理数以百万的要求.
🚀 越久越聪明
以实例训练您的程序 。 观察精度自动提高。 没有ML 需要专门知识.
真实 Apps, 真实简单
从客户邮件提取结构化数据
const extractor = ax(`
customerEmail:string, currentDate:datetime ->
priority:class "high, normal, low",
sentiment:class "positive, negative, neutral",
ticketNumber?:number,
nextSteps:string[],
estimatedResponseTime:string
`);
const result = await extractor.forward(ai, {
customerEmail: "Order #12345 hasn't arrived. Need this resolved immediately!",
currentDate: new Date(),
});
// Automatically extracts all fields with proper types and validation
构建使用工具的代理( React 模式)
const assistant = ax(
"question:string -> answer:string",
{
functions: [
{ name: "getCurrentWeather", func: weatherAPI },
{ name: "searchNews", func: newsAPI },
],
},
);
const result = await assistant.forward(ai, {
question: "What's the weather in Tokyo and any news about it?",
});
// AI automatically calls both functions and combines results
带有图像的多模态分析
const analyzer = ax(`
image:image, question:string ->
description:string,
mainColors:string[],
category:class "electronics, clothing, food, other",
estimatedPrice:string
`);
// Process images and text together seamlessly
快速启动
安装
npm install @ax-llm/ax
在CI之外,安装 设置一个克洛德代码技能, ax-llm,带有契约
索引和捆绑引导您的代理阅读 。 要禁用未来的自动
设置、 运行 npx @ax-llm/ax skills-auto-install off 从您的项目根。 这个
保存 ax.skills.autoInstall: false 在您的项目中 package.json; 执行
和你的团队分享 使用 skills-auto-install on 重新启用
未来安装的自动设置。 设定 AX_SKIP_SKILL_INSTALL=1 跳过设置
单项安装; CI 和环境变量优先于
保存的设置.
您也可以在首次安装 Ax 之前设置首选 :
{
"ax": {
"skills": {
"autoInstall": false
}
}
}
将此字段合并到您已有的 package.json手册
npx @ax-llm/ax setup-claude 即使在自动设置被禁用时也能工作;
添加 --all 注册每个专家或 --skill ax-ai 只安装一个.
改变偏好让已安装的技能到位,手动设置或
删除保留了保存的偏好.
现有专家仍在安装;使用 remove-claude 接下来是
setup-claude 将旧的全装设备切换到压缩包.
您的第一个 AI 特性(2分)
import { ai, ax } from "@ax-llm/ax";
const llm = ai({ name: "openai", apiKey: process.env.OPENAI_APIKEY! });
const translator = ax(`
text:string,
language:string ->
translation:string
`);
const result = await translator.forward(llm, {
text: "Hello world",
language: "Spanish",
});
console.log(result.translation); // "Hola mundo"
强大的地物,零复杂度
- ✅ 示范实验室供应商 - OpenAI、Anthropic、Google、Mistral、DeepSeek, Grok/xAI, 以及更多
- ✅ 所有安全类型 - 自动完成的全类型脚本支持
- ✅ 第一流线 - 经验证的实时答复
- ✅ 多边形 - 图像、音频、文本在同一签名中
- ✅ 智能优化 - 与GEPA和拖带演示自动快速调试
- ✅ 生产可观察性 - OpenTeleometry 内置追踪
- ✅ 高级工作流程 - 用AxFlow制造复杂的管道
- ✅ 代理框架 - 能够使用工具并呼叫其他特工的特工
- ✅ 无依赖 - 轻、快、可靠
学习更多
QQ 快赢
深潜
实例
运行任意示例 :
OPENAI_APIKEY=your-key npm run tsx ./src/examples/[example-name].ts
核心实例
生产模式
- 客户支持.ts - 完整的支助系统
- 食物搜索(ts) - 有工具的餐厅建议
- 优化.ts - 自动优化
- axagent-gepa-优化.ts - GEPA的代理优化
- ax-flow-hanced-demo.ts (英语) - 复杂的工作流程
加入社区
- 🐦 追踪微博 - 最新消息
- 💬 迪斯科德社区 - 找人帮忙,分享想法
- ⭐ 恒星在 GitHub - 支持该项目
- 📖 询问 DeepWiki - 人工智能文件
生产准备
- ✅ 作战测试 - 初创企业用于生产
- ✅ 没有中断更改 - 稳定小版本
- ✅ 综合测试 - 大型试验范围
- ✅ 打开几何 - 建造可观察性
- ✅ 先输入脚本 - 设计时的型号安全
许可证
Apache 2 - 随地使用,制造任何东西.
准备好建设未来了吗? 别再用急件打架了 开始运输 签名.
npm install @ax-llm/ax
由开发者与QQ一起为开发者所建.