扣子

🧭 明确输入-处理-输出
先画出“用户输入 → 知识库/插件 → 卡片/表单输出”的最小链路，再拆为节点落到 Workflow，便于调试与复用。

🧩 小步快跑做灰度
每次只改一处提示词/检索策略/插件参数；用发布记录与小流量灰度验证收益，预设回滚点。

🧠 记忆要设阈值
给长期记忆设置写入白名单与置信度阈值，避免噪声污染；对敏感字段启用脱敏与到期清理。

📚 知识库以“可引用”为中心
开启引用片段/来源高亮，QA 模板尽量结构化；定期重建索引并以“版本号+生效日”管理变更。

🔗 插件拆小、限流容错
把外部接口按功能拆为多个端点；在工作流里加超时、重试与降级路径，避免单点失败拖垮整体体验。

Q1: 新手如何 10 分钟做出第一个智能体？

A: 新建智能体 → 编写系统提示词与示例 → 选择模型 → 上传 1 份知识库文档 → 在“调试”对话验证 →（可选）添加消息卡片模板作为结构化输出 → 发布并记录变更。若涉及外部系统，改用 Workflow 以 HTTP 节点/插件衔接。

Q2: 工作流（Workflow）与聊天流（Chatflow）有什么区别？

A: 工作流用于搭建可复用的“任务链”（含条件分支、变量、API 调用、卡片输出），适合自动化流程；聊天流偏重对话编排与组件化回复，适合客服与知识问答。两者可在项目内协同使用。

Q3: 如何把智能体发布到微信/飞书？

A: 在“发布”页选择目标渠道，按向导填写 AppID、域名与回调参数并完成授权；在微信公众平台/飞书开发者后台同步配置白名单后即可联通。建议先以“欢迎语 + FAQ 知识库”的最小链路验收。

Q4: 额度里的“资源点”如何理解？

A: 资源点用于度量模型调用与平台资源消耗，不同模型/能力的扣减系数不同；订阅提供基础额度，超额可增购（取决于档位）。在“订阅与额度/账单明细”可查看消耗与调用分布。

Q5: 知识库检索不稳定怎么办？

A: 优化切片（标题层级、段落长度）与文件格式；开启“引用片段/来源高亮”便于比对召回；对高频问答采用结构化模板减少自由生成；必要时以实体抽取→API 查询替代纯文本检索。

Q6: 长期记忆会不会写乱用户画像？

A: 为记忆写入设置字段白名单与置信度阈值，低置信度不写；定期清理过期项；在输出卡片标注“基于历史偏好”；对敏感字段启用脱敏与到期删除，遵循企业合规策略。

Q7: 并发与速率限制如何规划？

A: 参考订阅档位的“每分钟请求数”上限；重型节点加限流与缓存，并准备降级路径（先走知识库，失败再走外部 API）；关键任务建议分片异步执行并设置幂等以避免重复动作。

Q8: 出现错误如何排查？

A: 在调试台查看输入/输出与变量，结合 Trace 日志定位失败节点；检查权限/白名单、超时与重试设置；若涉及外部 API，先用最小化请求在工作流单独验证再合流。

Q9: 如何在网站或 App 内嵌对话与卡片？

A: 在发布页获取 API/Web SDK 信息；前端嵌入对话组件与消息卡片，后端以 Token 鉴权调用会话/工作流接口；注意设置超时重试、队列与日志，避免偶发抖动影响体验。

Q10: 团队协作如何做权限隔离？

A: 使用“空间”管理成员与资源授权；知识库/插件/工作流按角色分级；发布采用“合规校验—灰度—全量”的流程，并在发布记录中固化变更与回滚点。