文心智能体教程：（三）智能体发布与后期优化

智能体发布

1.发布前准备

确认基本信息： 登录平台，在“我的智能体”中点击智能体卡片右下角的“工作台”进入详情页，确认基本信息已经通过审核。

提交版本审核： 基础信息审核未通过，无法提交版本审核。

2.智能体发布

审核通过后，开发者可进入版本管理页面，一键完成智能体发布。智能体发布后，开发者在版本管理页面对线上版本、审核版本、历史版本进行管理，可进行回滚等操作。

智能体数据分析

Hi 智能体开发者们～
🎉 恭喜你已经完成了构建智能体的第一步，完成发布后，可以进入数据分析模块查看智能体数据。

1. 数据概览： 展示智能体的启动次数、启动用户数、人均对话轮数、人均启动次数。
2. 数据分析： 统计用户分析、流量分析、对话分析、行为分析数据指标，帮助开发者完成精准的全面分析。

1.数据概览

展示智能体核心数据，通过右上角选择时间范围对数据指标进行查看，结束时间不能早于当天，最长可选择 365 天。

• 启动次数：用户启动智能体的次数
• 启动用户数：启动过智能体的用户
• 人均对话轮数：总对话轮数/启动用户数
• 人均启动次数：启动次数/启动用户数

2.数据分析

从四个维度展示智能体数据：用户分析、流量分析、对话分析、行为分析，每个数据下都有不同的数据指标，并且可以选择渠道来源，目前渠道来源只支持 5 个渠道，分别为搜索寻址、体验中心、搜索推荐、搜索满足、信息流；具体数据可查看表格进行下载。

3.常见问题与解答

Q1：开发中会展示智能体数据吗？

A1： 不能，需要智能体上线后且有数据后才会展示具体数据，没有数据会展示暂无数据。

Q2: 为什么数据概览中会有暂无环比的情况？

A2: 比如选了本周的数据，本周有数据但是上周没上线&无数据的情况下会展示暂无环比。

智能体调优

“质量评价”对于智能体流量获取有着举足轻重的影响。为了让开发者能明确影响流量及分发场景的质量优化方向，让智能体脱颖而出，实现更好的商业闭环，文心智能体平台为公开发布的智能体提供了“智能分析”功能。

分析报告将会给出智能体的常见质量问题。为了方便开发者理解每种问题的原因，了解自查、优化方法，我们撰写了这篇《智能体调优手册》，供酌情参考，具体如下：

1.回答相关度低/回答未满足需求

释义： 智能体的回答与用户提出的问题相关性不足，或缺乏具体性、实用性、针对性。

🌰示例1：
用户提问：感冒了怎么办？
智能体回答：感冒是一种常见的急性上呼吸道病毒性感染性疾病，多由副流感病毒冠状病毒、腺病毒等引起。
🌰示例2：
用户提问：给我画一只鸟。
智能体回答：看来你是个画画小能手呢！但我不会画画哦。

🤔问题原因：
原因一：智能体具备回答问题所需能力或信息，但智能体未识别到用户的具体意图。
✅优化方案：
1.如智能体调用的插件可解决用户问题，但并未触发，可于“人物设定”的思考路径中增加说明及案例解析。例如智能体是“童话故事”，调用“一格生图”插件，用户提问“给我生成带图的童话故事”，我们可以在“人物设定”中说明“当用户要求故事里带图片时，使用 getImage 插件基于故事内容生成图片后再输出故事内容”。
2.如智能体关联的知识库中有对应答案，建议优化知识库中答案所在段落的描述，概括段落核心，减少行业黑话，避免智能体理解混淆，格式建议参考知识库模板。同时也可于“人物设定”中增加案例解析，帮助智能体理解某些提问关键词在知识库里的指代。举例，用户提问 “Prompt撰写技巧”，知识库里写的是“提示词撰写技巧”，则我们可以在“人物设定”中告诉智能体 “Prompt即为提示词”。
3.如用户问题的解决依赖开发者自有插件，则建议优化 “description_for_model（插件功能描述）”以及自有插件的返回结果。
4.对于以上情况，也可通过在“人物设定”里强调“必须使用xx插件/知识库来回答xx类问题”的方式，增加调用率。

原因二：智能体不具备解答用户问题所需的知识或能力。
✅优化方案：
1.基于无法回答的知识领域补充知识库，或开启“联网搜索”功能，辅助智能体获得相关知识。
2.避免做没有赋予过相关能力的引导。例如智能体若无“快递查询”插件或知识库，则不要在名称、简介、开场白、引导示例中提及可支持快递查询。

2.回答信息有误/回答信息过时

释义： 智能体的回答与已知客观事实不符，或包含过时的资料数据。

🌰示例：
用户提问：北京92号汽油价格（假设当天是 2024 年 8 月 8 号，实际汽油价格是 8 元/升）
智能体回答：8.11 元/升（这是 2024 年 7 月的价格而非当天，因此属于信息过时且有误）

🤔问题原因：
智能体不具备回答该问题的相关知识，或对知识的相关性、准确性判断有误。
✅优化方案：
1.在智能体配置中开启“联网搜索”功能，或增加能够帮助智能体查询外部信息的相关插件。
2.补充能够回答对应问题的知识库，可考虑使用“网址提交”的方式导入知识库，平台会自动抓取网址中的内容到知识库，且支持自动更新，进而提升信息时效性。
3.“人物设定”里强调确保准确性和时效性，指定信息的参考源。例如“人物设定”内“思考路径”可以加上“确保你提供的信息准确无误，避免误导用户或提供过时信息”。

3.回答未遵循设定/回答格式有误

释义： 智能体的回答格式/内容未遵循智能体的人物设定或用户要求。

🌰示例： 智能体“人物设定”个性化部分提及“回复要用可爱的语气并带有 emoji 表情”。
用户提问：你好
智能体回答：你好（语气未按要求且没有输出表情）

🤔问题原因：
模型不能很好地理解指令。
✅优化方案：
1.将“个性特征”及“回复格式”等要求放在“人物设定”内的“个性化”当中。
2.对重要设定增加强制性的描述（如：必须、务必、一定等）。
3.在“人物设定”中增加话术，婉拒设定或能力外的用户要求（例如“专家”类智能体通常应拒绝用不严肃的语气对话）。

4.回答较简略/回答价值不足

释义： 智能体的回答缺乏或未提供足够的细节或信息。

🌰示例：
用户提问：北京有什么值得去的景点？
智能体回答：天安门。

🤔问题原因：
智能体缺少回答的相关知识储备，或“人物设定”缺少对回答丰富度的要求。
✅优化方案：
1.针对相关问题扩充知识库内容或调用针对性的插件。
2.在“人物设定”里要求按既定格式输出，例如“推荐好玩景点时，列举至少 x 条 top 景点，并给出推荐原因”或“综合全方位分析，详细给出”等。

5.未使用必要工具

释义： 智能体缺少或未调用回答问题必需的插件或知识库。

🌰示例：“快递查询”智能体没有为其添加能查询快递的插件，或智能体未意识到需调用相关插件查询，导致智能体仅凭自身数据无法准确解决用户“查快递”需求，进而导致回答信息有误或不满足需求。

🤔问题原因：
模型有能力边界，部分功能需要依赖外部能力。
✅优化方案：
1.检查智能体是否挂载回答问题所需插件/知识库，如没有，需要选择调用或开发相关插件。检查智能体是否挂载回答问题所需插件/知识库，如没有，需要选择调用或开发相关插件。
2.如智能体有相关插件或知识库，可尝试在“人物设定”中强调使用时机。例如“在用户需要查快递时，根据用户提供的快递单号，调用xx插件/知识库进行查询和反馈”。

6.智能体耗时问题

释义： 指从用户提问到智能体生成回答等待的时间较长，这会造成不好的用户体验。

🤔问题原因：
多轮的插件/知识库调用，或者多轮的模型思考，造成等待时间较长。
✅优化方案：
1.去除非必要的插件/知识库调用，或减少调用频次。例如“美食推荐”智能体对“数据可视化”插件需求就不高，“xx食物所含营养”这类问题利用大模型本身知识即可回答，也无需调用知识库。
2.若某插件耗时较长，可尝试使用其他同类型插件。
3.如有使用自研插件且插件耗时较长，建议优化自研插件效果。
4.在回答内容质量基本能满足用户需求情况下，尝试使用速度更快的模型，速度由快到慢分别是——文心极速模型 > 文心大模型 3.5 > 文心大模型 4.0。

7.其他优化建议

注意智能体名称、头像、开场白、简介、引导语、能力设定应保持一致，避免名称说“东”，开场白说“西”，能力设定是做好一件事，介绍却说能做十件事。
❌反面案例： 没有强化“北京”以外的旅游攻略能力，但名称却引导用户问全国旅游问题。
智能体名称——全国旅游助手。
智能体开场白——想知道来北京旅行吃什么美食可以问我哟。
智能体设定——人物设定是北京旅游助手，知识库也只有北京旅游相关信息。
✅优化方案：
检查智能体基础信息，确保开场白、简介、引导示例（3条）齐全。
设置名称、头像、简介、开场白时，应与能力设定范围一致，开场白、引导示例应具有引导性，能引导用户问询智能体擅长解答的方向。

普通人的AI入门指南

帮助你以低成本、零基础学会如何利用AI工具。AI就像办公软件一样，是每个人的必备技能。 掌握AI会让你在求职中占据优势，在未来的工作和学习中事半功倍。

查看详情>