withastro/flue

来源：https://github.com/withastro/flue

Flue —— 智能体编排框架

不是又一个 SDK。使用 Flue 可编程的 TypeScript 编排层，构建自主智能体与强大的 AI 工作流。

// agents/triage.ts
import { createAgent, type AgentRouteHandler } from '@flue/runtime';
import { local } from '@flue/runtime/node';
import triage from '../skills/triage/SKILL.md' with { type: 'skill' };
import verify from '../skills/verify/SKILL.md' with { type: 'skill' };
import * as githubTools from '../tools/github.ts';

// 为智能体提供解决复杂任务所需的上下文和自主性：
const instructions = `
端到端地对一个 bug 报告进行分类：复现该 bug，
诊断根本原因，验证该行为是否为有意为之，
并尝试修复。

...`;

// 通过 HTTP 暴露（并保护）你的智能体：
export const route: AgentRouteHandler = async (_c, next) => next();

// 组合你的智能体完成实际工作所需的完整编排层，
// 支持虚拟、本地或远程容器沙箱。
export default createAgent(() => ({
  model: 'anthropic/claude-sonnet-4-6',
  tools: [...githubTools],
  skills: [triage, verify],
  sandbox: local(),
  instructions,
}));

构建下一代智能体的框架

最初的智能体是通过原始的 LLM API 调用构建的。这适用于简单的聊天机器人和脚本化任务，但仅此而已。

像 Claude Code 和 Codex 这样的智能体打破了常规。它们是真正的自主智能体。你交给它们一个任务——而不是一系列预定义的步骤——然后信任它们使用你提供的上下文和工具来完成。

Flue 为智能体解锁了这种新架构。 其内置的 TypeScript 编排层为任何模型提供了真正自主工作所需的上下文和环境：会话、工具、技能、指令、文件系统访问以及安全的沙箱。你可以通过 CLI 在本地运行智能体，也可以将其部署到你选择的托管运行时。

特性

构建能够安全采取行动、保持连续性并连接到已有工作系统的智能体。

• 智能体（https://flueframework.com/docs/guide/building-agents/）—— 构建能够跨对话和事件保持上下文、自主朝着目标工作的智能体。
• 工作流（https://flueframework.com/docs/guide/workflows/）—— 运行结构化自动化流程，让你的代码从明确的输入引导智能体推理，直到产生最终结果。
• 沙箱（https://flueframework.com/docs/guide/sandboxes/）—— 为智能体提供安全环境，使其能够使用工具、修改文件并自主完成实际工作。
• 持久执行（https://flueframework.com/docs/guide/durable-execution/）—— 了解智能体如何通过持久化恢复机制，在失败和重启中保持进度。
• 子智能体（https://flueframework.com/docs/guide/subagents/）—— 为不同任务定义专门的角色，然后让智能体将工作委派给正确的专家。
• 工具（https://flueframework.com/docs/guide/tools/）—— 为智能体提供类型化的操作，用于调用 API、查询数据以及通过你的应用程序进行受控变更。
• 技能（https://flueframework.com/docs/guide/skills/）—— 打包可复用的专家知识和工作流，当任务需要专业指导时，智能体可以加载它们。
• MCP 服务器（https://flueframework.com/docs/guide/tools/#connect-mcp-tools）—— 通过开放的模型上下文协议生态系统，将智能体连接到经过身份验证的工具和服务。
• 可观测性（https://flueframework.com/docs/guide/observability/）—— 监控你的智能体，并通过 OpenTelemetry（https://flueframework.com/docs/ecosystem/tooling/opentelemetry/）、Braintrust（https://flueframework.com/docs/ecosystem/tooling/braintrust/）、Sentry（https://flueframework.com/docs/ecosystem/tooling/sentry/）或你自己的观察者导出遥测数据。
• 渠道（https://flueframework.com/docs/guide/channels/）—— 从 Slack、Teams、Discord、GitHub 等接收经过验证的事件。

随处部署

• Node.js（https://flueframework.com/docs/ecosystem/deploy/node/）
• Cloudflare Workers（https://flueframework.com/docs/ecosystem/deploy/cloudflare/）
• GitHub Actions（https://flueframework.com/docs/ecosystem/deploy/github-actions/）
• GitLab CI/CD（https://flueframework.com/docs/ecosystem/deploy/gitlab-ci/）
• Daytona（https://flueframework.com/docs/ecosystem/sandboxes/daytona/）
• Render（https://flueframework.com/docs/ecosystem/deploy/render/）

包