chroma-cloud

说明

信息收集

不要用冗长的问卷拖延进度。只询问选择正确方案所需但尚缺的信息：

• 仅密集搜索，还是混合搜索
• CHROMA_API_KEY、CHROMA_TENANT 和 CHROMA_DATABASE 是否已配置
• 是否已有嵌入方案

如果用户没有偏好的嵌入方案，默认使用 Chroma Cloud Qwen。如果需要混合搜索，请使用 Schema() 和 Search()。如果任务范围较窄，例如修复现有查询、审查代码或回答 API 问题，请结合仓库上下文直接处理，不要强行进行信息收集。

验证事项

• 客户端导入是否正确（CloudClient 还是 Client）
• Cloud 部署所需的环境变量是否已设置
• 所选 TypeScript 嵌入方案需要的嵌入函数包是否已安装
• Schema() 和 Search() 是否仅用于 Cloud 工作流
• 重要： get_or_create_collection() 接受 embedding_function 或 schema，但不能同时使用两者。需要多个索引、混合搜索或稀疏嵌入时使用 schema；仅需简单密集搜索时使用 embedding_function。

快速入门

使用 CLI 主题进行身份验证并写入 Cloud 凭据：

chroma login
chroma db create <db_name>
chroma db connect <db_name> --env-file

然后创建 CloudClient，并根据搜索模式选择 API：

import { CloudClient } from 'chromadb';

const client = new CloudClient();
const collection = await client.getOrCreateCollection({ name: 'my_collection' });

仅进行密集搜索时使用 collection.query()。只有在用户需要混合检索、多个索引，或更灵活的排序／查询组合时，才使用 Schema() 和 Search()。

Cloud 指南

在 Chroma Cloud 中，集合是主要的隔离边界，元数据是集合内主要的筛选机制。只有在需要显式配置密集＋稀疏索引或多索引时才使用 Schema()；只有在 query() 表达能力不足时才使用 Search()。

了解更多

如果需要了解本技能未涵盖的 Chroma 详细信息，请获取 Chroma 的 llms.txt，以查看完整文档：https://docs.trychroma.com/llms.txt

可用主题

Typescript

• Chroma 正则筛选 - 了解如何在 Chroma 查询中使用正则筛选
• 查询和获取 - 查询并获取 Chroma 集合中的数据
• 元数据 - 存储和查询元数据，包括筛选条件和数组值
• 更新和删除 - 更新现有文档并删除集合中的数据
• Schema - Schema() 使用多个索引配置集合
• Chroma Cloud Qwen - Chroma 托管的 Qwen 嵌入服务
• 错误处理 - 处理使用 Chroma 时出现的错误和故障
• 集合分叉 - 使用写时复制分叉，即时复制 Chroma Cloud 中的集合
• Search() API - 用于集合密集和稀疏向量搜索以及混合搜索的灵活 API，表达能力强

Python

• Chroma 正则筛选 - 了解如何在 Chroma 查询中使用正则筛选
• 查询与获取 - 从 Chroma 集合中查询和获取数据
• 元数据 - 存储和查询元数据，包括筛选条件和数组值
• 更新与删除 - 更新现有文档并从集合中删除数据
• Schema - Schema() 使用多个索引配置集合
• Chroma Cloud Qwen - Chroma 托管的 Qwen 嵌入服务
• 错误处理 - 使用 Chroma 时如何处理错误和故障
• 集合分叉 - 在 Chroma Cloud 中使用写时复制分叉即时复制集合
• Search() API - 一个表达力强且灵活的 API，可对集合进行稠密和稀疏向量搜索，以及混合搜索

通用

• 数据模型 - 概述 Chroma 如何存储数据
• 将 Chroma 集成到现有系统 - 如何将 Chroma 搜索添加到现有应用程序
• Chroma CLI - 开始使用 Chroma CLI 进行 Chroma Cloud 身份验证和数据库管理
• 缓存集合引用 - 减少高流量 Chroma Cloud 应用程序中重复的集合查找请求
• 配额与限制 - Chroma Cloud 配额和请求限制