该技能用于在用户使用 Chroma Cloud 时提供集成指导,适用于语义搜索和混合搜索应用。
用途:帮助判断应使用纯稠密检索还是混合检索,并给出正确的客户端、环境变量与集合配置方式。
接入方式:先确认必要信息,但不必填写冗长问卷,只需补齐缺失项:纯稠密还是混合检索;CHROMA_API_KEY、CHROMA_TENANT、CHROMA_DATABASE 是否已配置;是否已有嵌入方案。若用户无嵌入偏好,默认使用 Chroma Cloud Qwen;若需要混合检索,则使用 Schema() 与 Search()。若任务范围较窄,如修复现有查询、审查代码或回答 API 问题,可直接基于仓库上下文进行,无需强制信息采集。
校验要点:客户端导入是否正确(CloudClient 与 Client);云部署的环境变量是否已设置;所选 TypeScript 嵌入若需要额外包,是否已安装;Schema() 与 Search() 是否仅用于 Cloud 工作流。注意 get_or_create_collection() 只能接受 embedding_function 或 schema 之一,不能同时使用;需要多索引、混合检索或稀疏嵌入时用 schema,简单稠密检索用 embedding_function。
快速开始可使用 CLI 认证并写入云凭据:chroma login;chroma db create <db_name>;chroma db connect <db_name> --env-file。随后创建 CloudClient 并按检索模式选择 API:纯稠密检索用 collection.query();仅在需要混合检索、多索引或更灵活排序/查询组合时,才使用 Schema() 加 Search()。
云环境指引:集合是 Chroma Cloud 的主要隔离边界,元数据是集合内的主要过滤机制。仅在需要显式稠密加稀疏或多索引配置时使用 Schema(),仅在 query() 表达力不足时使用 Search()。若需更多文档,可获取 https://docs.trychroma.com/llms.txt。
覆盖主题包括 TypeScript 与 Python 两类:正则过滤、查询与获取、元数据、更新与删除、Schema、Chroma Cloud Qwen 嵌入、错误处理、集合分叉、Search() API;通用主题包括数据模型、集成到现有系统、Chroma CLI、集合引用缓存、配额与限制。
限制:资料未提供具体收费、价格、性能数据或平台支持范围,暂未提供。