制作扣子ai智能体前必须明确核心目标、准备基础素材和权限环境，否则将因人设模糊、知识缺失或权限不足导致响应异常；需依次完成定位场景、编写结构化人设提示词、清洗知识库材料、配置插件权限及设计测试问题清单。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
制作扣子AI智能体前，必须明确核心目标、准备好基础素材和权限环境，否则后续配置会反复卡在人设模糊、知识缺失或权限不足等环节，导致智能体无法按预期响应用户提问。
明确智能体的核心定位与使用场景
先问自己三个问题：它要解决哪一类具体问题？主要面向谁？会在什么平台被调用？比如“小红书爆款图文生成助手”就比“一个AI助手”更可执行；面向新手博主，就需避免专业术语；若计划发布到飞书，则需提前开通飞书开发者权限。
这一步不能跳过。没有清晰定位的智能体，就像没地图的司机——模型可能胡乱调用插件、编造知识库内容，甚至拒绝回答合理问题。
准备结构化的人设提示词初稿
在扣子的「人设与回复逻辑」面板中，系统依赖你输入的提示词来约束模型行为。不要只写“你是一个 helpful assistant”。要写出：【角色身份+能力边界+语言风格+禁止事项】四要素。
例如：“你是一位专注小红书运营的资深内容策划，只根据用户提供的主题和字数要求生成图文内容，禁用书面语、不提供外部链接、不生成虚假数据。”
提示词越具体，模型越少自由发挥。如果写得含糊，它可能突然开始讲人生哲理，或主动推荐你没授权的插件。
整理并清洗知识库原始材料
方法一：本地文档导入
支持 PDF、DOCX、TXT、MD、CSV 格式。文件内若含大量页眉页脚、扫描图文字、重复标题，必须提前用 Word 或 Obsidian 清洗，否则知识库切片后会出现无效段落，检索时返回“信息未找到”。
方法二：在线网页/飞书/Notion 同步
需确保目标页面已公开可访问，且不含登录墙或动态渲染内容。飞书文档要开启“任何人可查看”权限，否则扣子抓取失败后不会报错，只会静默跳过该文档。
【注意：知识库一旦创建完成，无法直接替换全部内容，只能逐条删除或重新上传】
确认可用的插件与API调用权限
第一步：登录扣子后台 → 点击左侧「插件」→ 查看已启用列表。若需调用天气、搜索、翻译等能力，必须在此处手动开启对应插件，并完成授权（如网页搜索需绑定头条账号）。
第二步：检查工作流中是否误启了未授权插件。例如，未开通「飞书多维表格」插件却在节点中配置写入动作，会导致整个工作流运行失败且无明确报错提示。
第三步：如使用自定义插件，需提前在「开发者中心」完成 API Schema 配置与测试，确保返回 JSON 结构符合扣子要求字段命名规范。
准备好测试用的典型用户问题清单
第一步：列出 3～5 条最常被问到的问题，覆盖简单查询、多步任务、边界条件三类。
第二步：记录每条问题期望的输出格式，例如“返回带emoji的标题+正文+3个标签，分段清晰，不加额外说明”。
第三步：在「预览与调试」面板中逐条输入测试，观察是否触发知识库检索、是否调用正确插件、是否存在幻觉回答。这一步是验证前期所有准备是否有效的唯一方式。
