智能体使用

核心概念

概念	说明
Agent	可发布、可配置的智能体定义，保存提示词、模型、工具、知识库和技能挂载关系
Session	一个用户与 Agent 的运行上下文，保存消息、运行状态、分支和恢复信息
Skill	可复用的能力包，内容以 SKILL.md 为入口，也可以包含脚本、引用资料和资源文件
Tool/MCP	Agent 在执行阶段调用的外部能力，支持本地工具、Feign 工具和远程 MCP 工具
File room	用户文件空间；Agent 运行时可通过 VFS 以工作区方式访问
Artifact	Agent 运行生成的文档、文件或中间产物，可在会话和文件空间中回看

典型使用方式

对话型 Agent

适合问答、知识检索和连续对话。一个 session 内的消息严格按 FIFO 执行，不同 session 可以并行。

规划型 Agent

适合多步骤任务。运行通常经过加载配置、意图识别、规划、循环执行和任务结束节点；循环中可以调用 LLM、RAG、Skill、MCP、沙箱和子 Agent。

文档型 Agent

适合大纲生成、内容写作、审计分析等任务。结果可能以流式文本、Artifact 或文件形式返回，不能只依赖最后一段文本判断任务是否完成。

使用建议

• 给 Agent 绑定最小必要的工具和文件权限。
• 对外部 IM 场景使用独立 Agent 或独立渠道配置，便于审计和限流。
• 大文件先放入文件空间，再让 Agent 通过文件路径处理，避免把整份文件直接塞进提示词。
• 需要恢复、暂停或取消的任务保留 sessionId；不要把一次请求的临时 ID 当成会话 ID。