配置档案
用 ProviderProfile 统一管理模型参数
白话：ProviderProfile 就像"模型配置模板"。你可以写一个模板说"所有 OpenAI 模型温度设 0"，再写一个说"GPT-5.4 额外开启推理功能"——它们会自动合并。
ProviderProfile 封装了在使用 provider:model 字符串创建 Agent 时应用的初始化参数。它支持两级注册，且两者可以共存、自动合并。
import { ProviderProfile, registerProviderProfile } from "deepagents";
// 提供商级别：所有 openai 模型都设置 temperature=0
registerProviderProfile(
"openai",
new ProviderProfile({ temperature: 0 }),
);
// 模型级别：gpt-5.4 额外设置 reasoningEffort
// 会继承上面提供商级别的 temperature=0
registerProviderProfile(
"openai:gpt-5.4",
new ProviderProfile({ reasoningEffort: "medium" }),
);提供商级别
用裸提供商键名（如 "openai"）注册，应用于该提供商的所有模型。
适合设置通用默认值，如 temperature。
模型级别
用 provider:model 键名（如 "openai:gpt-5.4"）注册，仅应用于特定模型。
会与提供商级别配置合并，模型级优先。
合并规则：模型级别的配置会覆盖提供商级别的同名参数，未覆盖的参数保留提供商级别的值。如果你传入的是预配置的模型实例（而非字符串），ProviderProfile 不会生效。
提示：若要控制模型构建完成后 Agent 的行为方式（而非模型本身的参数），请使用框架配置档案（harness profile）。Harness Profile 在 Provider Profile 之上提供更高层的 Agent 行为控制。
运行时切换
用中间件在运行时动态选择模型，无需重建 Agent
如果你的应用允许用户通过 UI 下拉菜单选择模型，可以使用 LangChain 中间件（middleware）在运行时切换。
import { initChatModel, createMiddleware } from "langchain";
import { createDeepAgent } from "deepagents";
import * as z from "zod";
// 定义上下文的 schema，model 字段存放用户选择的模型名
const contextSchema = z.object({
model: z.string(),
});
// 定义中间件：拦截每次模型调用，替换为用户选择的模型
const configurableModel = createMiddleware({
name: "ConfigurableModel",
// wrapModelCall 会在每次 LLM 调用前执行
wrapModelCall: async (request, handler) => {
// 从运行时上下文中读取用户选择的模型名
const modelName = request.runtime.context.model;
// 动态初始化新模型实例
const model = await initChatModel(modelName);
// 用新模型替换原请求中的模型，继续执行后续流程
return handler({ ...request, model });
},
});
const agent = await createDeepAgent({
model: "google-genai:gemini-3.1-pro-preview", // 默认模型（首次调用时使用）
middleware: [configurableModel], // 注册中间件
contextSchema, // 绑定上下文 schema
});
工作原理：中间件拦截每次模型调用，从上下文中读取用户选择的模型名称，动态初始化新模型并替换。Agent 只需构建一次，之后通过传入不同的
context 即可切换模型。
