SuperAPI AI 工具集

vector-db-launch

部署与运维

查看项目

更新于 10-16 08:00

技能介绍

用途:当存在并发多智能体读写需求时,启动 ChromaDB 后台 HTTP 服务,并验证其运行状态。资料指出默认应使用进程内模式,仅在明确需要并发写入时才启动后台服务。

主要能力:检查 ChromaDB 后台服务是否已运行;以守护进程方式启动服务;轮询心跳端点确认健康状态;报告守护进程 PID、主机绑定、端口与存储路径。

必要用法:先检查服务是否已启动:curl -sf http://127.0.0.1:8110/api/v1/heartbeat > /dev/null && echo "ChromaDB running" || echo "ChromaDB stopped"。启动命令为:chroma run --host 127.0.0.1 --port 8110 --path .vector_data &。随后验证心跳:curl -sf http://127.0.0.1:8110/api/v1/heartbeat。

限制与安全约束:必须仅绑定本机回环地址 127.0.0.1,禁止绑定 0.0.0.0 或任何公网接口;资料提及 CVE-2026-45829/45830/45831。排查方式:若提示 chroma: command not found,请在虚拟环境中安装依赖;若端口 8110 被占用,可用 lsof -i :8110 检查进程;若权限不足,确认对 .vector_data 具有写权限。参考文件包括 acceptance-criteria.md 与 vector-db-bootstrap-guide.md。