Skip to content

FAQ.md

Latest commit

 

History

History
94 lines (62 loc) · 2.89 KB

FAQ.md

File metadata and controls

94 lines (62 loc) · 2.89 KB
Raw

AIDev 智能体开发常见问题

本地环境部署

❓问题：no such table: account_user

OperationalError at /
no such table: account_user

原因

数据库未完成初始化，缺少必要的数据表结构。

解决方案

执行以下命令完成数据库迁移：

source .env
source .venv/bin/activate
python bin/manage.py migrate

❓问题：智能体关联失败

使用智能体(ai-xxx)前，需要先将其关联至 [AI 开发助手] 空间

原因

如果您是直接从开发者中心创建的 AI 智能体插件，在使用前必须先将其关联到特定的项目空间。

解决方案

  1. 选择或创建一个智能体专属的项目空间

  1. 将智能体绑定至项目空间（注意：从开发者中心创建的智能体只能关联到原先指定的空间）

  1. 完成关联后，请务必配置并发布智能体

❓问题：no such table: my_cache_table

原因

本地环境中缺少 Django 缓存所需的数据表。

解决方案

执行以下命令创建缓存表：

source .env
source .venv/bin/activate
python bin/manage.py createcachetable

❓问题：智能体发布失败

在聊天窗口会话时出现提示：请配置智能体默认模型并重新发布

原因

智能体尚未完成发布流程，或者未配置所需的本地模型。

解决方案

请完成智能体的配置并执行发布操作：

❓问题：Token超限报错

在聊天窗口会话时出现Token超限的相关提示：

image image

原因

目前默认上下文最大token数只有28000，超过了这个最大限制会按（压缩知识库召回内容➡压缩工具调用结果➡抛除chat history内容）优先级去压缩上下文，如果还是超限，就会报调用异常的提示。

解决方案

可通过修改 LLM_TOKEN_LIMIT 环境变量的值来调整最大token限制数，后续需开发同学支持提供部署模型支持的token长度的配置表，并通过查表自动适配模型对应token长度。

修改方式：

  • 本地二次开发：在.env文件中新增 export LLM_TOKEN_LIMIT=xxx，再重新执行 source .env 即可。
  • 平台智能体：在蓝鲸开发者中心的模块配置中新增环境变量 LLM_TOKEN_LIMIT，完成配置后重新部署。
image