4.troubleshooting.md

title	Troubleshooting
description	安装、运行以及使用中的各类常见问题汇总
navigation	icon i-lucide-file-question-mark

安装

1. 使用知识库时，提示未找到 llama-index 等包
   • 请使用 pip install veadk-python[extensions] 安装扩展包。

配置

1. 设置火山引擎 AK/SK 后，提示获取模型 API Key 失败
   • VeADK 不会帮助您自动创建火山引擎方舟平台 API Key，请先在平台创建。

使用

1. 是否兼容 Google ADK
   • 是

部署

1. 卡在 release 阶段

   • 请先在 VeFaaS 平台开通权限。

   • 

   • 新账号开通后，缺少ServerlessApplicationRole授权

     • 当前，你可以随便点进一个创建应用的页面，（比如这个页面）点击「一键授权」即可。

   • 

2. 安装依赖失败，显示依赖安装空间不足

   • VeFaaS 最大依赖安装大小默认为 250 MB，若需更大空间，请联系 VeFaaS 产品团队扩容。