智能体 SDK

Agent SDK 适合在你的应用里运行多步 agent。JoyToken 负责模型调用和用量归因;工具执行、状态存储、审批和业务逻辑仍在你的应用侧。

支持能力

能力当前状态
JoyToken 模型 provider支持
多步 agent loop支持
function tool 调用支持
停止条件支持 stepCountIsmaxToolCallsmaxCost
状态持久化应用侧保存 messages 后传回 agent.run()

你需要准备

项目
包名@joytoken/agent-sdk-ts
API KeyJOY_TOKEN_API_KEY
默认模型auto
Node.js18+

最小 agent

1import { Agent, createJoyTokenProvider } from "@joytoken/agent-sdk-ts";
2
3const agent = new Agent({
4 model: createJoyTokenProvider({
5 apiKey: process.env.JOY_TOKEN_API_KEY,
6 }),
7 modelName: "auto",
8 system: "Keep answers short.",
9});
10
11const result = await agent.run("Reply with exactly: pong");
12console.log(result.finalText);

什么时候使用 Agent SDK

场景建议
只发一条模型请求使用 客户端 SDK
需要工具调用使用 Agent SDK
需要多步推理和停止条件使用 Agent SDK
需要接入 OpenClaw 或 Hermes Agent使用 智能体集成

下一步

页面用途
快速开始跑通第一个 agent
示例复制工具调用、状态持久化、停止条件示例
TypeScript SDK查看 TypeScript 用法