SAMPLES_zh.md

JDOxyGent4J 示例索引（按目录分类）

本文档仅保留示例名称与能力描述，按目录分组，便于快速查阅。
samples所在位置：samples/

agent（基础与多智能体架构）

示例	能力
DemoSingleAgent	最简单的单智能体系统；单个 ReActAgent 调用工具
DemoReactAgent	ReAct 推理循环：思考 → 行动 → 观察 → 再思考
DemoChatAgentStream	对话型智能体 + SSE 流式输出；适合聊天场景
DemoWorkflowAgent	使用 WorkflowAgent 执行工作流；显式控制顺序与数据流
DemoHeterogeneousAgents	异构智能体协作（ReAct/Chat/MCP）；各司其职协同工作
DemoHierarchicalAgents	分层 master-sub 架构；权限管理与调用链路追踪
DemoRagAgent	检索增强生成（RAG）；向量检索增强回答
DemoSseAgent	访问SSE流式输出的server
DemoTeamSizeAgent.java	在智能体中自定义funcProcessInput和funcProcessOutput方法
EvaluateAndEvolveDemo.java	通过数据处理与分析来评估并提升智能体的性能
ParallelDemo.java	智能体并行执行

tools（工具与 MCP 集成）

示例	能力
DemoFunctionHub	使用 FunctionHub 将普通函数注册为工具；参数类型校验
DemoFunctionHubAnnotation	注解式工具注册；简化工具声明与注入
DemoMCP	MCP 协议工具集成（Stdio/SSE/Streamable）；支持本地与远程
DemoMCPToolAuthorization	MCP 协议工具集成（Stdio/SSE/Streamable）；支持本地与远程，Header带认证信息

advanced（高级功能）

示例	能力
DemoContinueExec	断点续传与重新生成；从指定节点恢复执行
DemoCustomAgentInputSchema	自定义输入结构；支持复杂结构化参数传递
DemoMultimodal	多模态输入（图片/视频/URL/Base64）；启用 is_multimodal_supported
DemoMultimodalNew.java	多模态输入（图片/视频/URL/Base64）；图片分析
DemoMultimodalTransfer	智能体间多模态数据传递；自动生成可访问链接
DemoSendMessageFromTool	工具内主动发送消息；实时进度反馈与可观测性
DemoTrustMode	信任模式（原始输出）；跳过 LLM 二次解析与润色

flows（流程编排）

示例	能力
DemoPlanAndSolve	Plan-and-Solve 两阶段：规划与执行；支持 enable_replanner
DemoReflexionFlow	Reflexion 反思机制；自我评估与改进响应质量

backend（路由、附件、并发、配置、启动与日志）

示例	能力
DemoAddRouter	动态路由注册；扩展 Web 服务 API 端点
DemoAttachment	附件处理；支持图片/视频上传与传递
DemoBatchAndSemaphore	批处理与并发控制；信号量限制并发请求数
DemoConfig	配置系统；数据库/LLM/环境变量管理，支持多环境
DemoCustomHeader.java	自定义大模型请求的header数据
DemoDataScope	数据作用域管理：请求/会话/组级别存储与访问
DemoGlobalData	全局数据共享；在所有智能体间同步状态
DemoHumanInTheLoop.java	手动发送反馈，阻塞获取
DemoLaunchMas	MAS 系统启动；CLI/Web/编程三种模式初始化
DemoLoggerSetup	日志系统配置；自定义格式与级别，追踪 trace_id/node_id
DemoMasFunction.java	自定义Mas.funcProcessMessageBody方法，用于自定义处理消息
DemoProcessLlmException.java	自定义大模型报错时的方法，用于自定义处理异常
DemoProcessMessage.java	自定义Mas.funcProcessMessage方法，用于自定义处理消息体字段
DemoSaveMessage.java	自定义Mas.funcProcessInput方法，用于自定义消息的保存和发送策略

distributed（分布式与多节点协同）

示例	能力
AppMasterAgent	分布式与多节点协同；支持 Python/Java 互相调用
AppMathAgent	分布式与多节点协同；支持 Python/Java 互相调用
AppTimeAgent	分布式与多节点协同；支持 Python/Java 互相调用

mcptools (MCP工具)

示例	能力
DemoBrowser.java	网页自动抓取，Browser Use能力，使用chrome-devtools-mcp

llms (大模型)

示例	能力
DemoDisableSystemPrompt.java	大模型禁用系统提示词
DemoHttpVersion.java	大模型网关在不支持http/2的情况下，需要指定http版本为http/1.1

banks (资产库)

示例	能力
DemoDisableSystemPrompt.java	大模型禁用系统提示词
DemoHttpVersion.java	大模型网关在不支持http/2的情况下，需要指定http版本为http/1.1