One environment variable shown in generated .env files.

工作流执行上下文 在工作流执行过程中自动注入到每个节点，提供： - 请求标识（thread_id, user_id） - 组件访问（prompt_manager, llm_manager） - 执行控制（cancel_token, ti

工作流定义和执行 Example: workflow = Workflow( id="customer_service_v1", name="客服助手", version

输入参数定义 Example: Input("query", str, required=True, description="查询内容") Input("count", int, default=10, min=1, max=100)

统一 API 异常 用于在 API 路由中抛出带有错误编码的异常， 会被全局异常处理器捕获并转换为统一错误响应格式。 Example: raise APIError( error="工作流不存在",

LLM 调用节点 声明式调用 LLM，无需编写调用代码。 Prompt 语法： - {variable}: 从 state 中取值 - {@prompt_key}: 从 PromptManager 中引用提示词 Exam

工具定义

AgentClaw 全局配置

项目配置（自动发现）

凭据验证结果

声明式子工作流节点 支持通过声明式配置调用子工作流，无需编写 Python 代码。 Example: # 方式1：直接传入工作流对象 workflow.add_node(SubWorkflowNode(

A logical group of environment variables.

AgentClaw HTTP 服务器 使用方式： 1. 在 server.py 中导入工作流 2. 创建 AgentClawServer 实例 3. 调用 run() 启动服务 Example:

LLM 调用管理器 支持多模型配置、按 ID 选择、自动降级 Example: # 自动从 models.json 加载 workflow.use(LLMManager()) # 指定默认

人工审批节点 等待人工操作后继续执行。工作流会在此节点中断， 等待外部调用 resume 接口传入反馈后继续。 Example: # 普通文本输入模式 HumanNode(id="review", feedback_field="

提示词条目

工作流调试器 在节点执行前后检查断点，支持暂停、单步、修改状态等操作。 Example: debugger = WorkflowDebugger(workflow) debugger.set_breakpoint("cla

统一消息格式

输出通道 管理单个请求的输出事件，支持： - 流式模式：事件逐个推送（Dify 格式） - 非流式模式：收集所有输出，最后汇总 - 调试模式：同时推送到调试队列

Skill Tools MCP Server Provides code execution tools with skill environment support: - python: Execute Python code/script with skill

节点执行异常

认证结果

统一文件存储服务 Example: storage = FileStorage(db_manager) # 保存文件（默认 uploads/ 前缀） stored = await storage.save(file_bytes,

本地文件系统存储后端

Raised when room token or membership is invalid.

工具调用

Service for conversation CRUD operations.

文档解析节点 将文档文件转换为 Markdown 格式的文本。 Args: id: 节点 ID input_key: state 中文档路径的 key，默认 "document" output_key: 解

文件类型标记

输入参数 Schema 统一管理工作流的输入参数定义，支持： - 生成 JSON Schema（用于 MCP、API 文档） - 生成前端表单配置 - 运行时参数验证

知识库配置

知识库核心服务。

LLM 响应（支持工具调用）

MCP Server 管理器 管理多个 MCP Server 连接，提供统一的工具访问接口 Example: # 从配置文件加载 manager = MCPManager.from_config("mcp.json")

触发器配置

Computer Tools MCP Server 提供截图和系统模拟操作工具： - screenshot: 截取屏幕截图 - mouse_click: 鼠标点击 - mouse_move: 鼠标移动 - keyboard_type: 键盘输入文本

配置错误异常

任务执行记录

知识库文件存储。

Structured control output produced by the post-tool model call.

提示词信息

定时任务

Use an LLM to extract structured data from text and write it to state.

调用统计（Token Usage + Latency）

Webhook 触发配置

MCP 工具定义

基于 markitdown 的统一文档解析器。

Skill 管理器 - 加载和管理 Skills

存储的文件信息

Normalized result for a single tool call. model_content is the compact content appended back to the model context. raw_output is retained for

追踪服务 封装追踪记录查询等业务逻辑

Workflow 追踪包装器 自动记录： - Trace: 工作流执行（开始/结束时间、状态、输入输出） - Span: 每个节点执行（运行时间、状态） - 自动将 TracedLLMManager 注入到 context Exa

API Key 配置

Authenticated caller identity. user_id and tenant_id are intentionally reserved for a future multi-user edition. The current personal edition

渠道配置记录

Context compression response

上下文压缩器 压缩策略： 1. 保留系统提示词（第一条消息，如果 role=system） 2. 保留开场白（第二条消息，如果是 assistant 的欢迎消息，可选） 3. 其余所有消息使用 LLM 压缩成一条摘要消息

Dashboard 服务

数据库连接管理器 统一管理 PostgreSQL、MySQL、Redis 连接 Example: db = DatabaseManager( postgres=PostgresConfig.from_

数据库追踪器 记录工作流执行的 Trace、Span、Generation 到数据库 数据库写入在后台异步执行，不阻塞工作流 Example: tracer = DatabaseTracer(db_manager)

Raised when a user-provided document cannot be parsed into text.

降级状态

Database retention cleanup for execution logs and LangGraph checkpoints.

模型信息

Raised when PostgreSQL or Redis is unavailable for public rooms.

Redis 配置

资源信息

工具集管理器 管理工作流可用的工具，支持装饰器注册和 HTTP 调用 Example: toolkit = ToolKit() @toolkit.tool async d