1. 项目背景与动机在日常开发和学习中我们经常需要快速获取某个技术栈的文档解读、代码示例甚至希望有一位能理解我们项目语境的“专属助手”。百宝箱AgentToolbox Agent提供了一个低门槛、可视化的智能体搭建平台让非算法工程师也能根据自己的需求定义智能体的行为、挂载知识库、选择模型并最终在页面或 API 中直接使用。本文将以一个「小脑瓜急转弯」智能体为例从零带你走通百宝箱Agent搭建智能体的完整流程。2. 搭建前的准备在开始之前请确保你已经有百宝箱Agent的使用权限。通常你需要一个有效的工作台账号支持手机号或企业微信登录进入“智能体中心”或“Agent工坊”模块明确你的智能体场景是内部知识问答、对外服务助手还是代码辅助编写。建议先想好智能体的“人设”——它会说什么话懂哪些知识不和用户聊什么。3. 核心搭建步骤整体流程如下创建新智能体填写基础信息名称、描述、头像。选择底层模型比如 DeepSeek、GPT-4o 或企业内部模型。上传知识库文件可上传多个 MD/PDF/Word百宝箱会自动做文档切片与向量化。编写 System Prompt定义智能体的角色与回复规则。通过“预览与调试”面板反复测试直至输出符合预期。一键发布获得嵌入代码或 API Endpoint。整个过程中模型选择和 Prompt 调优是最关键的阶段——它们直接决定智能体的回答质量。4. 系统架构概览百宝箱Agent 智能体在运行时的处理逻辑大致如下是否用户提问智能体入口是否匹配知识库向量检索召回相关文档片段直接调用大模型推理组装 PromptSystem Prompt 上下文 用户问题大模型生成回答输出过滤与格式化返回用户知识库检索 Prompt 工程组合拳是百宝箱Agent智能体精准回答的关键。不需要写一行代码通过拖拽与表单就能完成配置。5. Prompt 编写实战以「小脑瓜急转弯」智能体为例一个贴心的 System Prompt 可以这么写# 角色 你是一个温暖而高效的AI脑筋急转弯助手致力于通过简洁、贴心的互动为用户提供脑筋急转弯。你如同一位细心的朋友能够敏锐捕捉用户的即时需求用自然流畅的对话缓解孤独感、提升日常幸福感。 ## 技能 ### 技能 1: 深度上下文理解 1. **意图识别**结合会话历史数据和当前会话数据精准判断用户的核心需求如倾诉、查询建议或闲聊。 2. **情感感知**通过关键词如好累开心识别用户情绪状态并调整回应的共情程度。 3. **记忆连贯性**若用户提及前面脑筋急转弯的解释需自然衔接前文避免重复提问。 ### 技能 2: 极简信息提炼 1. **重点优先**回答时将关键信息前置次要内容用括号补充如地铁3号线约20分钟直达。 2. **口语化表达**使用短句、缩略语如咱呢和感叹词如哇哦模拟真人对话节奏。 3. **拒绝冗余**同一对话中不重复已提供的信息除非用户明确要求。这个 Prompt 的精髓在于“双技能”设计一方面通过精准的意图识别和情感感知让回复更懂你另一方面用极简信息提炼让每句话都戳到点上不啰嗦也不冷冰冰。注意用户在 Prompt 中还定义了变量{{input_hgtoen-currentChatByUser-当前对话信息}}和{{input_hgtoen-historyChat-历史对话信息}}百宝箱Agent 在运行时可以自动注入当前与历史会话数据让智能体真正做到“问不倒的贴心小闹钟”。6. 测试与调优技巧在“预览与调试”面板中可以试试这些脑筋急转弯场景常规出题“给我出个脑筋急转弯”——检查是否随机给出一个有趣的题目并带有口语化的欢迎语。追问答案“答案是什么呀”——检查是否根据上一轮出的题目给出解释且不会重复前面的话。情绪安抚“哎呀我刚刚答错了好失落”——检查是否用共情语言安慰用户并主动再出一道或给予鼓励。记忆测试连续出三道题再问“第一题的答案还记不记得”——检查智能体能否跨轮衔接上下文准确回忆之前的题目与答案。如果发现题目重复率高可以在 Prompt 中增加一句“每次尽量出不同的脑筋急转弯题库至少包含50个”如果回答过于机械可降低口语化权重或增加“禁用‘根据提示’等书面语”的约束。