常见问题与解决方法
我怎么登录平台?
- 答:统一身份认证账号登录ECNU智能体平台地址:https://agent.ecnu.edu.cn。
我怎么发布和使用智能体?
- 答:参考以下两种方法
- 方法1:适用于开发者在开发调试阶段,快速对话。在智能体编排模式下,直接在右侧的调试区跟智能体进行对话,效果与发布后的智能体对话一样。
- 方法2:适用于开发完成后,对外分享给他人使用。具体方法请参考此处方法和步骤:点击跳转
智能体回答不符合预期
检查提示词
先看看提示词是不是写得不够清楚,没有准确传达你的要求。比如提示词中任务描述模糊,智能体可能就不知道该怎么做。这时候可以重新调整提示词,增加一些具体的细节或者示例,让智能体更好地理解你的意图。
调整模型参数
参考前面提到的模型参数调整方法,尝试调整随机性、核采样等参数。如果回答太随机,就把随机性参数调小一点;如果回答过于单一,就把核采样参数调大一点,看看是否能改善智能体的回答。
检查知识库和插件
如果智能体依赖知识库或插件来回答问题,要检查知识库中有没有相关的信息,插件是否正常工作。比如知识库中没有包含某个知识点,智能体就无法准确回答;插件授权过期或者配置错误,可能就不能获取最新的数据。
文件上传失败
检查文件格式和大小
ECNU智能体开发平台对上传文件的格式和大小是有限制的。上传知识库文件时,要注意文件格式是否支持,常见的如PDF、Excel、Word等格式是支持的,还要注意文件大小不能超过规定的限制,像PDF文件一般不支持超过100MiB 。如果不符合要求,就需要转换文件格式或者拆分文件。
网络问题
上传失败也可能是网络不稳定导致的。可以检查一下网络连接是否正常,尝试重新上传。要是还是不行,可以换个网络环境再试。
插件无法正常使用
确认授权信息
有些自定义插件得授权才能用,填授权信息时务必保证准确。就好比 OAuth2 授权,client_id、client_secret 这些信息得填对,要是填错,授权就没法成功,插件也就用不了啦。
比如平台的DALL-E_3插件,是一个文生图插件,自定义接入chatedu平台的API接口,需要正确填写如下三个参数(每个用户在使用时都需要单独配置授权):
- 供应商:OpenAI
- api_key:从chatedu平台获取key我的令牌
- base_url:填写 https://chat.ecnu.edu.cn/open/api/v1
检查授权流程
得严格按照插件的授权流程来操作,看看有没有漏了哪一步。有的自定义插件可能要先在别的平台完成授权,再把授权信息填到 HiAgent 平台,这个过程一定得顺顺利利地走完,任何一步出错都可能影响插件正常使用。
工作流运行出错
检查节点配置
工作流是由多个节点组成的,每个节点的配置都可能影响运行结果。检查一下节点的输入输出参数是否正确设置,比如大模型节点的提示词是否符合要求,插件节点的参数是否与插件的使用说明一致。如果某个节点配置错误,就可能导致整个工作流运行出错。
查看运行日志
HiAgent平台提供了运行日志功能,可以查看工作流运行过程中的详细信息,包括每个节点的执行情况、输入输出内容等。通过查看日志,能快速定位到出错的节点和原因。比如日志中显示某个插件节点调用失败,就可以重点检查该插件的配置和网络连接情况。