Daydreams - AI 代理框架

注意： 此代理框架已不再是核心重点，因为其功能现已过时。

Daydreams 的核心重点在于代理式商业，而非代理框架。

请查看 lucid-agents 仓库：https://github.com/daydreamsai/lucid-agents

我们推荐使用 Pi 代理框架 来构建代理，并在其基础上集成 lucid-agents。

最终实现可扩展且可组合的 TypeScript 代理

🌐 官网 • ⚡ 快速入门 • 📖 文档 • 💬 Discord

🎯 每个 AI 开发者都会遇到的问题

你构建了一个 AI 代理。在测试中它运行得非常好。但当你需要添加更多功能时……

❌ 上下文切换会破坏现有功能
❌ 状态管理变得一团糟
❌ 内存无法跨会话持久化
❌ 代码变成了一团乱麻，充斥着提示词和逻辑

听起来很熟悉吧？你并不孤单。这就是为什么大多数 AI 代理都无法进入生产环境的原因。

⚡ 解决方案：可组合上下文架构

Daydreams 是首个具备可组合上下文的 AI 框架——这些隔离的工作空间可以组合起来，形成复杂的行为。通过真正的记忆、MCP 集成以及以 TypeScript 为先的设计，你可以构建出能够记忆、学习并扩展的代理。

🌐 Dreams 路由器 - 通用 AI 网关

通过一个 API 即可访问任何 AI 模型，并内置身份验证和支付功能：

import { dreamsRouter } from "@daydreamsai/ai-sdk-provider";

// 使用来自任何提供商的任意模型
const models = [
  dreamsRouter("openai/gpt-4o"),
  dreamsRouter("anthropic/claude-3-5-sonnet-20241022"),
  dreamsRouter("google-vertex/gemini-2.5-flash"),
  dreamsRouter("groq/llama-3.1-405b-reasoning"),
];

// 按使用付费，采用 USDC 微支付（无需订阅）
const { dreamsRouter } = await createDreamsRouterAuth(account, {
  payments: { amount: "100000", network: "base-sepolia" }, // 每次请求 $0.10
});

特点：

• 通用访问 - OpenAI、Anthropic、Google、Groq、xAI 等多种模型
• x402 支付 - 按使用付费，支持 USDC 微支付
• 兼容 OpenAI - 可与现有的 OpenAI SDK 客户端无缝对接
• 自动回退 - 内置提供商冗余机制

🌐 在线服务： router.daydreams.systems • 📖 路由器文档 • ⚡ 路由器快速入门

🌟 上下文组合的力量

与其他框架不同，Daydreams 允许你使用 .use() 方法来组合上下文，从而从模块化组件中创建强大的代理：

import { createDreams, context, action } from "@daydreamsai/core";
import { openai } from "@ai-sdk/openai";

// 基础分析上下文 - 追踪用户行为
const analyticsContext = context({
  type: "analytics",
  create: () => ({ events: [], sessions: 0 }),
}).setActions([
  action({
    name: "trackEvent",
    schema: { event: z.string() },
    handler: async ({ event }, ctx) => {
      ctx.memory.events.push({ event, timestamp: Date.now() });
      return { tracked: true };
    },
  }),
]);

// 与分析上下文组合的客户支持上下文
const supportContext = context({
  type: "support",
  schema: z.object({
    customerId: z.string(),
    tier: z.enum(["free", "premium"]),
  }),
  create: () => ({ tickets: [] }),
})
  // 🌟 神奇之处：将上下文组合在一起
  .use((state) => [
    { context: analyticsContext, args: { userId: state.args.customerId } },
    // 根据客户等级进行条件性组合
    ...(state.args.tier === "premium" ? [{ context: premiumContext }] : []),
  ])
  .instructions(
    (state) =>
      `您是 ${state.args.tier} 等级的客户支持代理人。请记录所有互动。`
  );

// 代理自动获得所有组合的功能
const agent = createDreams({
  model: openai("gpt-4o"),
  contexts: [supportContext],
});

// 客户将获得支持、分析以及高级功能（如果适用）
await agent.send({
  context: supportContext,
  args: { customerId: "alice", tier: "premium" },
  input: "我在账单方面遇到了问题。",
});

结果：你的代理能够在一次对话中无缝结合客户支持、行为分析以及高级功能，无需手动集成。

🔌 通用 MCP 集成

连接到任何 模型上下文协议 服务器，即可即时访问外部工具：

import { createMcpExtension } from "@daydreamsai/mcp";

const agent = createDreams({
  extensions: [
    createMcpExtension([
      {
        id: "filesystem",
        transport: {
          type: "stdio",
          command: "npx",
          args: ["@modelcontextprotocol/server-filesystem", "./docs"],
        },
      },
      {
        id: "database",
        transport: {
          type: "stdio",
          command: "npx",
          args: ["@modelcontextprotocol/server-sqlite", "./data.db"],
        },
      },
    ]),
  ],
});

// 在任何行动中使用 MCP 工具
const searchAction = action({
  name: "search-docs",
  handler: async ({ query }, ctx) => {
    // 通过 MCP 读取文件
    const docs = await ctx.callAction("mcp.listResources", {
      serverId: "filesystem",
    });

    // 通过 MCP 查询数据库
    const results = await ctx.callAction("mcp.callTool", {
      serverId: "database",
      name: "query",
      arguments: { sql: `SELECT * FROM docs WHERE content LIKE '%${query}%'` },
    });

    return { docs, results };
  },
});

结果：你的代理可以通过不断发展的 MCP 生态系统，即时获得文件系统访问、数据库查询、网页抓取、3D 渲染等功能。

🚀 在 60 秒内启动你的代理

npm install @daydreamsai/core @ai-sdk/openai zod

import { createDreams, context, action } from "@daydreamsai/core";
import { openai } from "@ai-sdk/openai";
import { z } from "zod";

// 定义一个简单的天气上下文
const weatherContext = context({
  type: "weather",
  create: () => ({ lastQuery: null }),
}).setActions([
  action({
    name: "getWeather",
    schema: z.object({ city: z.string() }),
    handler: async ({ city }, ctx) => {
      ctx.memory.lastQuery = city;
      // 你的天气 API 逻辑在这里
      return { weather: `晴朗，${city} 的气温为 72°F` };
    },
  }),
]);

// 创建你的代理
const agent = createDreams({
  model: openai("gpt-4o"),
  contexts: [weatherContext],
});

// 开始聊天！
await agent.send({
  context: weatherContext,
  input: "旧金山的天气怎么样？",
});

就是这样！你的代理已经运行起来，具备持久化记忆和类型安全的操作。

或者搭建一个完整的项目：

npx create-daydreams-agent my-agent
cd my-agent && npm run dev

🔥 为什么开发者正在转向 Daydreams

🏗️ 传统 AI 框架	⚡ Daydreams
单体式代理设计	可组合的上下文架构
会话间内存重置	重启后仍保持持久化内存
手动状态管理	自动上下文隔离
复杂的集成设置	原生 MCP 支持
JavaScript 加上类型注解	以 TypeScript 为首的设计

✨ 企业级特性

🧩可组合的上下文 - 由简单、可复用的上下文构建复杂代理
🔌原生 MCP 支持 - 通用访问外部工具和服务
💾持久化内存 - 真正的状态感知型代理，跨会话记忆
⚡完全 TypeScript - 完整的类型安全与卓越的开发体验
🎯上下文隔离 - 自动分离用户数据和对话
🔧动作作用域 - 上下文特定的能力与权限
🌐通用运行时 - 适用于 Node.js、浏览器、Deno、Bun 和边缘函数
🏗️模块化扩展 - 干净的插件架构，用于平台和服务
📊完全可解释性 - 了解你的代理所做的每一个决策

🏗️ 核心架构

上下文系统

针对不同类型的对话提供隔离的状态工作空间：

const userContext = context({
  type: "user",
  schema: z.object({ userId: z.string() }),
  create: () => ({ preferences: {}, history: [] }),
  render: (state) =>
    `用户：${state.args.userId} | 历史记录：${state.memory.history.length} 条`,
});

内存系统

双层存储并自动持久化：

• 工作内存：临时执行状态（输入、输出、动作）
• 上下文内存：由 create() 函数定义的持久化数据

动作系统

具有上下文访问权限和模式验证的类型安全函数：

const savePreference = action({
  name: "save-preference",
  description: "保存用户偏好",
  schema: z.object({ key: z.string(), value: z.string() }),
  handler: async ({ key, value }, ctx) => {
    ctx.memory.preferences[key] = value;
    return { saved: `${key} = ${value}` };
  },
});

###扩展系统

用于平台和服务的模块化集成：

import { discordExtension } from "@daydreamsai/discord";
import { supabaseExtension } from "@daydreamsai/supabase";

const agent = createDreams({
  extensions: [
    discordExtension({ token: process.env.DISCORD_TOKEN }),
    supabaseExtension({ url: process.env.SUPABASE_URL }),
  ],
});

🎯 上下文模式

单一上下文 - 简单而专注

非常适合简单的机器人：

const faqBot = context({
  type: "faq",
  instructions: "回答关于我们产品的提问",
});

多个上下文 - 分离的工作空间

当你需要隔离的功能时：

const agent = createDreams({
  contexts: [
    chatContext, // 用户对话
    gameContext, // 游戏会话
    adminContext, // 管理功能
  ],
});

🌟 组合上下文 - 极致强大

这正是 Daydreams 的优势所在 - 上下文协同工作：

const smartAssistant = context({
  type: "assistant",
  schema: z.object({ userId: z.string(), plan: z.enum(["free", "pro"]) }),
}).use((state) => [
  // 始终包含用户档案
  { context: profileContext, args: { userId: state.args.userId } },
  // 始终包含基础分析
  { context: analyticsContext, args: { userId: state.args.userId } },
  // 为 Pro 用户添加高级功能
  ...(state.args.plan === "pro" ? [{ context: premiumContext }] : []),
]);

📖 了解更多关于上下文的信息 →

🔌 MCP 集成

Daydreams 通过扩展提供了对模型上下文协议的原生支持：

import { createMcpExtension } from "@daydreamsai/mcp";

// 连接到任何 MCP 服务器
createMcpExtension([
  // 通过 stdio 连接本地服务器
  {
    id: "files",
    transport: { type: "stdio", command: "mcp-server", args: ["./data"] },
  },
  // 通过 HTTP/SSE 连接远程服务器
  {
    id: "api",
    transport: { type: "sse", serverUrl: "https://mcp-api.example.com" },
  },
]);

流行的 MCP 服务器：

• 数据库访问：SQLite、PostgreSQL、MySQL
• 文件系统：本地文件、云存储、Git 仓库
• Web 服务：搜索、爬取、API、社交媒体
• 开发者工具：代码执行、测试、部署
• 专用工具：3D 渲染、图像处理、数据分析

📖 了解更多关于 MCP 的信息 →

📚 文档与学习

🏠 完整文档 - 构建生产级代理所需的一切

🏃‍♂️ 快速入门路径

🎯 我想亲自试一试 → 5 分钟快速入门
🛠️ 我想看示例 → 实用示例
🚀 我想构建一些东西 → 教程
💬 我需要帮助 → 加入我们的 Discord

必备指南

• 第一个代理 - 5 分钟内构建你的第一个代理
• 上下文系统 - 掌握有状态的对话
• MCP 集成 - 连接到外部工具
• 扩展 - 平台集成

教程

• 基础代理 - 简单的对话机器人
• 多上下文代理 - 处理多个工作流
• MCP 设置 - 连接外部服务器
• x402 纳米服务 - 付费 AI 服务

🚀 扩展与生态系统

平台集成

• @daydreamsai/discord - Discord 机器人支持
• @daydreamsai/twitter - Twitter/X 自动化
• @daydreamsai/telegram - Telegram 机器人
• @daydreamsai/cli - 交互式终端

存储与记忆

• @daydreamsai/supabase - Supabase 向量存储
• @daydreamsai/chroma - ChromaDB 集成
• @daydreamsai/mongo - MongoDB 持久化

开发者工具

• @daydreamsai/mcp - 模型 上下文协议
• create-daydreams-agent - 项目脚手架

🎯 完美适配您的使用场景

电子商务	医疗保健	金融服务	开发者工具
大规模客户服务	符合 HIPAA 标准的代理	以合规为先的设计	代码审查自动化
订单处理自动化	患者数据保护	内置风险管理	文档生成
库存管理	治疗建议	交易监控	API 测试辅助

🏃‍♂️ 示例

在 examples/ 中探索实际运行的示例：

• 基础聊天 - 简单的对话代理
• 多上下文 - 多种对话类型
• Discord 机器人 - 平台集成示例
• MCP 集成 - 外部工具连接
• x402 纳米服务 - 带有小额支付的付费 AI 服务

🌟 精选示例

每个示例包括：

• 完整的 TypeScript 源代码
• 分步设置说明
• 配置示例
• 测试和部署指南

🛠️ 开发

贡献

我们欢迎贡献！请参阅 CONTRIBUTING.md 获取指导方针。

开发环境设置：

git clone https://github.com/daydreamsai/daydreams.git
cd daydreams
pnpm install
./scripts/build.sh --watch
bun run packages/core  # 运行测试

🤝 社区与支持

📈 加入 1,000+ 构建更优 AI 的开发者

使用 Daydreams 的公司： 电子商务平台 • 医疗保健提供商 • 金融机构 • 开发者工具公司

获取帮助与交流

💬 Discord 社区 - 从团队和社区获得帮助
📖 文档 - 全面的指南和示例
🐛 GitHub Issues - 错误报告和功能请求
📧 直接支持 - 直通我们的工程团队

✨ 准备好构建真正可用的 AI 代理了吗？

⭐ 星标本仓库 • 🚀 立即试用 Daydreams • 💬 加入 Discord

---

MIT 许可证 • 由 Daydreams 团队用心打造

Daydreams AI Agent 框架快速上手指南

⚠️ 重要提示：根据官方说明，本仓库（agent harness）已不再是核心开发重点，其功能已被新的架构取代。官方目前的核心重心是 Agentic Commerce。

• 推荐方案：建议使用 Pi agent harness 构建 Agent，并集成 lucid-agents。
• 本文目的：尽管架构重心转移，本文仍基于现有代码库整理快速上手指南，供开发者理解其“可组合上下文（Composable Contexts）”的核心设计理念及快速体验。

Daydreams 是一个基于 TypeScript 的 AI Agent 框架，主打可组合的上下文架构、持久化内存以及原生的 MCP (Model Context Protocol) 支持。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：版本 >= 18.x (推荐使用 LTS 版本)
• 包管理器：npm, yarn, pnpm 或 bun
• 依赖知识：熟悉 TypeScript 和异步编程

前置依赖安装： 确保已安装 Node.js。国内开发者若下载 Node.js 较慢，可使用淘宝镜像源：

# 查看当前源
npm config get registry
# 设置为淘宝镜像 (如未设置)
npm config set registry https://registry.npmmirror.com

2. 安装步骤

您可以选择手动安装核心依赖，或使用官方脚手架快速创建项目。

方式一：手动安装核心依赖

在项目目录中运行以下命令安装核心库、OpenAI 提供商及数据验证库：

npm install @daydreamsai/core @ai-sdk/openai zod

方式二：使用脚手架创建完整项目（推荐）

使用 npx 一键生成包含最佳实践配置的项目模板：

npx create-daydreams-agent my-agent
cd my-agent
npm install
npm run dev

3. 基本使用

Daydreams 的核心在于通过 context 定义状态和行为，并通过 createDreams 实例化 Agent。以下是一个最简单的“天气查询”Agent 示例，展示了如何定义上下文、动作（Action）并发起对话。

创建文件 index.ts：

import { createDreams, context, action } from "@daydreamsai/core";
import { openai } from "@ai-sdk/openai";
import { z } from "zod";

// 1. 定义一个简单的天气上下文
const weatherContext = context({
  type: "weather",
  // 初始化内存状态
  create: () => ({ lastQuery: null }),
}).setActions([
  action({
    name: "getWeather",
    // 定义输入参数的 Schema (类型安全)
    schema: z.object({ city: z.string() }),
    handler: async ({ city }, ctx) => {
      // 更新持久化内存
      ctx.memory.lastQuery = city;
      
      // 此处替换为真实的天气 API 调用逻辑
      // 模拟返回结果
      return { weather: `Sunny, 72°F in ${city}` };
    },
  }),
]);

// 2. 创建 Agent 实例
const agent = createDreams({
  // 配置模型 (需设置 OPENAI_API_KEY 环境变量)
  model: openai("gpt-4o"),
  contexts: [weatherContext],
});

// 3. 发送消息并执行
async function main() {
  const response = await agent.send({
    context: weatherContext,
    input: "What's the weather in San Francisco?",
  });
  
  console.log(response);
}

main();

核心概念简析

• Context (上下文)：隔离的工作空间。每个 Context 拥有独立的 memory（持久化状态）和 actions（可执行工具）。
• Composition (组合)：Daydreams 允许通过 .use() 方法将多个 Context 组合在一起（例如：将“用户分析”上下文组合进“客服”上下文），从而构建复杂的 Agent 行为，无需手动管理状态纠缠。
• MCP 支持：框架原生支持 Model Context Protocol，可轻松连接文件系统、数据库等外部工具服务器。

运行示例

确保已设置 OpenAI API Key，然后运行：

# 如果使用 TypeScript 直接运行 (需安装 tsx)
npx tsx index.ts

# 或者编译后运行
npm run build && node dist/index.js

现在，您已经成功运行了一个具备持久化内存和类型安全动作的 Daydreams Agent。