最小配置

使用 Re-Act Agent 需要配置以下内容：

# LiteFlow 规则文件
liteflow.rule-source=agent/flow.el.xml

# Workspace 根目录（必填）
liteflow.agent.workspace.root=/var/lib/liteflow/agent-workspaces

# 生产环境建议默认关闭 Shell 工具
liteflow.agent.shell.mode=DISABLED

# 模型凭据（以 DeepSeek 为例）
liteflow.agent.openai-compatible.deepseek.api-key=${DEEPSEEK_API_KEY}
liteflow.agent.openai-compatible.deepseek.base-url=https://api.deepseek.com/v1

Workspace 路径说明

liteflow.agent.workspace.root 是必填项。框架会为每个会话创建独立的工作目录，用于：

• Agent 之间的文件协作
• 记忆持久化（LOCAL_FILE 模式）
• Shell 工具的工作目录

路径支持绝对路径和相对路径。框架内部会通过 Paths.get(root).toAbsolutePath().normalize() 解析，相对路径基于 JVM 启动时的 user.dir。

生产环境建议

由于 user.dir 在 IDE 启动、java -jar、systemd、容器等不同场景下差异巨大，生产环境一律建议使用绝对路径，避免同一份配置在不同部署方式下落盘到不同位置。

如果未配置 workspace.root，首次执行 Agent 组件会抛出：

AgentConfigException: liteflow.agent.workspace.root is required

其他平台凭据配置

OpenAI：

liteflow.agent.openai.api-key=${OPENAI_API_KEY}

Anthropic Claude：

liteflow.agent.anthropic.api-key=${ANTHROPIC_API_KEY}

Google Gemini：

liteflow.agent.gemini.api-key=${GEMINI_API_KEY}

阿里云 DashScope：

liteflow.agent.dashscope.api-key=${DASHSCOPE_API_KEY}

OpenAI 兼容厂商（通用）：

liteflow.agent.openai-compatible.<自定义key>.api-key=${YOUR_API_KEY}
liteflow.agent.openai-compatible.<自定义key>.base-url=https://your-api-endpoint/v1

YAML 格式配置

如果你使用 YAML 配置文件：

liteflow:
  agent:
    workspace:
      root: /var/lib/liteflow/agent-workspaces
    shell:
      mode: disabled
    openai-compatible:
      deepseek:
        api-key: ${DEEPSEEK_API_KEY}
        base-url: https://api.deepseek.com/v1