Think 通过在 Think 子类上重写方法与属性来配置。大多数 Agent 仅重写 getModel()。
| 方法 / 属性 | 默认值 | 描述 |
|---|---|---|
getModel() |
抛出异常 | 返回要使用的 LanguageModel |
getSystemPrompt() |
"You are a helpful assistant." |
system prompt 顶部、context block 上方的指令。只有不存在 context block 时才使用默认值 |
getTools() |
{} |
智能体循环的 AI SDK ToolSet |
getScheduledTasks() |
{} |
代码声明的周期性提示词或处理函数 — 请参阅定时任务 |
getDefaultTimezone() |
undefined |
挂钟定时任务的默认时区 |
getMessengers() |
{} |
信使入口与投递声明 — 请参阅信使 |
maxSteps |
10 |
每轮最大工具调用步数 |
sendReasoning |
true |
向聊天客户端发送推理片段 |
configureSession() |
恒等变换 | 添加 context block、compaction、搜索和 skill — 请参阅 Session |
getSkills() |
[] |
返回用于按需激活 skill 的 Agent Skills 来源 — 请参阅 Agent Skills |
getSkillScriptRunner() |
null |
启用实验性 run_skill_script tool — 请参阅执行 |
messageConcurrency |
"queue" |
重叠提交的行为 — 请参阅客户端工具 |
includeMcpTools |
true |
将已连接的 MCP 工具转为 AI SDK 工具并加入模型轮次。请参阅MCP 工具 |
waitForMcpConnections |
false |
推理前等待 MCP server |
chatRecovery |
始终开启 | 持久恢复配置。有关所有选项和默认值,请参阅持久恢复。 |
chatStreamStallTimeoutMs |
0(关闭) |
可选的非活动看门狗:如果模型流在指定时长内未产生任何数据块,则中止该轮次(测量数据块之间的间隔,包括工具执行时间)。停滞后会进入有界恢复流程。 |
contextOverflow |
undefined |
可选的轮中上下文溢出处理,含 reactive、maxRetries、proactive。需要 classifyChatError 加会话压缩函数 — 请参阅上下文窗口溢出恢复 |
chatRecovery 与 chatStreamStallTimeoutMs 行为请参阅持久恢复。
Think 的类泛型与 Agent<Env, State, Props> 一致。持久化运行时配置在 configure<T>() 与 getConfig<T>() 调用点带类型,存储在 SQLite,可经受休眠与重启。
export class MyAgent extends Think {
getModel() {
const tier = this.getConfig()?.modelTier ?? "fast";
const models = {
fast: "@cf/moonshotai/kimi-k2.6",
capable: "@cf/meta/llama-4-scout-17b-16e-instruct",
};
return createAI({ binding: this.env.AI })(models[tier]);
}
}type MyConfig = { modelTier: "fast" | "capable"; theme: string };
export class MyAgent extends Think<Env> {
getModel() {
const tier = this.getConfig<MyConfig>()?.modelTier ?? "fast";
const models = {
fast: "@cf/moonshotai/kimi-k2.6",
capable: "@cf/meta/llama-4-scout-17b-16e-instruct",
};
return createAI({ binding: this.env.AI })(models[tier]);
}
}| 方法 | 描述 |
|---|---|
configure<T>(config: T) |
持久化带类型的配置对象 |
getConfig<T>(): T | null |
读取持久化配置,从未配置则为 null |
通过 @callable 向客户端暴露配置:
import { callable } from "agents";
export class MyAgent extends Think {
getModel() {
/* ... */
}
@callable()
updateConfig(config) {
this.configure(config);
}
}import { callable } from "agents";
export class MyAgent extends Think<Env> {
getModel() {
/* ... */
}
@callable()
updateConfig(config: MyConfig) {
this.configure<MyConfig>(config);
}
}Think 将对话存储在 Session 中,该存储层保存消息并为模型提供可写内存。这里涉及两个概念:context block 是 system prompt 中模型可读取和更新的带标签部分(例如包含用户相关事实的 memory block);compaction 会汇总较早的消息,使长对话保持在模型上下文窗口内。重写 configureSession 可添加持久内存、compaction、搜索和 skill:
import { Think, Session } from "@cloudflare/think";
export class MyAgent extends Think {
getModel() {
/* ... */
}
configureSession(session) {
return session
.withContext("soul", {
provider: { get: async () => "You are a helpful coding assistant." },
})
.withContext("memory", {
description: "Important facts learned during conversation.",
maxTokens: 2000,
})
.withCachedPrompt();
}
}import { Think, Session } from "@cloudflare/think";
export class MyAgent extends Think<Env> {
getModel() {
/* ... */
}
configureSession(session: Session) {
return session
.withContext("soul", {
provider: { get: async () => "You are a helpful coding assistant." },
})
.withContext("memory", {
description: "Important facts learned during conversation.",
maxTokens: 2000,
})
.withCachedPrompt();
}
}当 configureSession 添加 context block 时,Think 会使用重写的 getSystemPrompt(),后跟这些 block,构建 system prompt。只有不存在 block 时才使用默认 getSystemPrompt()。Think 的 this.messages getter 直接从 Session 的树状存储中读取。
有关完整 Session API(context block、compaction、搜索、skill 和多 session 支持),请参阅 Session 文档。
| 导出 | 描述 |
|---|---|
@cloudflare/think |
Think、Session、skills namespace |
@cloudflare/think/messengers |
Messenger 契约、Chat SDK 桥接、状态 Agent、投递 |
@cloudflare/think/messengers/telegram |
Telegram messenger 提供方与投递辅助 |
@cloudflare/think/workflows |
ThinkWorkflow、step.prompt() — Workflow 提示词步骤 |
@cloudflare/think/tools/execute |
createExecuteTool() — 已弃用的 Code Mode 执行 tool |
@cloudflare/think/tools/browser |
createBrowserTools() — 基于 Chrome DevTools Protocol 的工具 |
@cloudflare/think/tools/extensions |
createExtensionTools() — LLM 驱动的扩展加载 |
@cloudflare/think/extensions |
ExtensionManager、HostBridgeLoopback — 扩展运行时 |
需你提供的对等依赖:
| 包 | 必需 | 说明 |
|---|---|---|
agents |
是 | Cloudflare Agents SDK |
ai |
是 | AI SDK v6 |
zod |
是 | Schema 验证(v4) |
@cloudflare/computer |
是 | Workspace 和 workspace tool |
@chat-adapter/telegram |
可选 | 使用 Telegram messenger 时必需 |
与 @cloudflare/think 捆绑:
| 包 | 说明 |
|---|---|
@cloudflare/codemode |
createExecuteTool() 的代码执行 |
Agent Skills parser、来源和脚本 runner 位于 agents/skills 中,因此脚本 runner 通过 agents 而不是 Think 拉取 just-bash。