LiteFlow LiteFlow
首页
  • v2.16.3 (当前版本)
  • What's New

    • What' s New In LiteFlow v2.16.2?
    • What' s New In LiteFlow v2.16.1?
    • What' s New In LiteFlow v2.16.0?
  • 历史版本

    • v2.15.X
    • v2.13.X
    • v2.12.X
    • v2.11.X
    • v2.10.X
    • v2.9.X
    • v2.8.X
  • 升级指南

    • 2.16.2 Agent 升级说明
    • 2.13.0升级指南
    • 2.12.4升级指南
    • 2.12.0升级指南
    • 升级到2.9.3说明
    • 升级到2.9.X说明
    • 升级到2.8.X说明
    • 升级到2.7.X说明
AI Agent
AI Skill
IDEA 插件
  • 答疑解惑

    • 常见问题
    • 如何理解上下文这个概念?
    • Slot是一个什么样的概念?
  • 项目与社区

    • 项目介绍
    • 项目成员
    • 更新记录
    • 参与开发
    • 加入群聊
    • 谁在使用
赞助
GitHub (opens new window)

广告采用随机轮播方式显示 ❤️成为赞助商
首页
  • v2.16.3 (当前版本)
  • What's New

    • What' s New In LiteFlow v2.16.2?
    • What' s New In LiteFlow v2.16.1?
    • What' s New In LiteFlow v2.16.0?
  • 历史版本

    • v2.15.X
    • v2.13.X
    • v2.12.X
    • v2.11.X
    • v2.10.X
    • v2.9.X
    • v2.8.X
  • 升级指南

    • 2.16.2 Agent 升级说明
    • 2.13.0升级指南
    • 2.12.4升级指南
    • 2.12.0升级指南
    • 升级到2.9.3说明
    • 升级到2.9.X说明
    • 升级到2.8.X说明
    • 升级到2.7.X说明
AI Agent
AI Skill
IDEA 插件
  • 答疑解惑

    • 常见问题
    • 如何理解上下文这个概念?
    • Slot是一个什么样的概念?
  • 项目与社区

    • 项目介绍
    • 项目成员
    • 更新记录
    • 参与开发
    • 加入群聊
    • 谁在使用
赞助
GitHub (opens new window)
  • 🤖 LiteFlow Agent 简介
  • 快速开始

    • 📦 引入依赖
    • ⚙️ 基本配置
    • 🧩 编写 Agent 组件
    • 📤 获取 Agent 结果
    • 🌊 流式输出
  • 🎬 演示项目
  • 🏪 模型配置
  • 📐 结构化输出
  • Jev 智能选择组件

    • Jev 模型与模块介绍
    • 依赖与配置
    • 编写选择组件
    • 置信度与异常处理
    • 客服演示与测试
  • Jev 布尔判断组件

    • Noul 与布尔判断组件
    • 编写布尔组件
  • 会话与记忆

    • 💬 会话标识
    • 🧠 会话存储
    • 🔄 多轮对话
    • 🗂️ 聊天历史
    • 📝 长对话与长期记忆
  • 工作空间与工具

    • 📂 工作区与执行环境
    • 📄 文件工具与产物
    • 🐚 Shell 工具
    • 🐳 Docker 沙箱
    • 🔧 Java 业务工具
    • 🔌 MCP 工具
  • 🎯 Skills 技能系统
  • 高级编排

    • 🔀 条件路由与并行调用
    • 🤝 多 Agent 协作
    • 🙋 工具调用前人工确认
    • 🧭 子代理与计划
    • 🌐 远程 A2A 调用
  • 运行机制与可观测

    • 🔁 迭代次数与超时
    • 📋 执行日志与事件
      • 执行日志
      • 面向界面的执行事件
      • 事件失败策略
    • 🪝 中间件扩展
  • 📖 扩展点速查
  • ⚡ 配置速查
  • 🛡️ 执行与访问边界
  • 🔍 故障排查
  • ⬆️ 升级到 2.16.2
  • AI Agent编排
  • 运行机制与可观测
铂赛东
2026-09-19
目录

📋 执行日志与事件

# 执行日志

内置日志默认开启,记录 Agent、推理、工具执行和模型调用等阶段的进入、完成及错误信息。关闭时配置:

liteflow.agent.execution-log-enabled=false

排查时结合会话、节点和请求标识定位一次调用,并从 response.getCause() 获取失败原因。日志开关不代替流式事件监听器,也不控制聊天历史是否保存。

# 面向界面的执行事件

快速开始已展示 agent.text.delta 的监听方式。同一个监听器还可以根据事件类型显示执行状态:

事件 常见用途
agent.text.delta 正文增量,读取 event.getText()
agent.tool.call.start/agent.tool.call.end 工具调用开始/参数接收结束
agent.tool.result.end 工具结果完成
agent.confirm.required/agent.confirm.result 人工确认请求/结果
agent.result 当前 Agent 的结果
agent.error 执行错误

多 Agent 流程可通过事件的节点和请求标识区分来源。agent.result 不代表整条链结束,最终仍应检查 response.isSuccess()。监听器异常默认会中断调用;允许展示事件丢失时,才设置 event.listener-failure-mode=LOG_AND_CONTINUE。

# 事件失败策略

监听器是调用链的一部分,默认 FAIL_FAST。SSE 或 WebSocket 发送失败时,如果应用允许展示事件丢失,可配置:

liteflow.agent.event.listener-failure-mode=LOG_AND_CONTINUE

该设置只改变事件监听器异常的处理,不会忽略模型、工具或存储失败。最终流程状态仍由 LiteflowResponse 判断。

帮助我们改善此文档 (opens new window)
上次更新: 2026/09/20, 11:49:27
🔁 迭代次数与超时
🪝 中间件扩展

← 🔁 迭代次数与超时 🪝 中间件扩展→

Theme by Vdoing | Copyright © 2020-2026 铂赛东 | MIT License
沪ICP备18012955号-2