跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

配置

最后更新 查看 MarkdownAgent 设置

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);
    }
}

Session 集成

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。

这篇文档对您有帮助吗?