Intégrer Chroma Cloud pour la recherche sémantique et hybride

Instructions

Intake

Ne bloquez pas sur un long questionnaire. Demandez uniquement les détails manquants et nécessaires pour choisir le bon chemin :

Dense uniquement ou recherche hybride
Si CHROMA_API_KEY, CHROMA_TENANT et CHROMA_DATABASE sont déjà configurés
Choix d'embedding existant, le cas échéant

Si l'utilisateur n'a pas de préférence d'embedding, utiliser par défaut Chroma Cloud Qwen. Si la recherche hybride est requise, utiliser Schema() et Search(). Si la tâche est ciblée, comme corriger une requête existante, examiner du code ou répondre à une question API, procéder avec le contexte du dépôt plutôt que de forcer l'intake.

Ce qu'il faut valider

Import correct du client (CloudClient vs Client)
Les variables d'environnement sont définies pour les déploiements Cloud
Le package de la fonction d'embedding est installé lorsque l'embedding TypeScript sélectionné en nécessite un
Schema() et Search() sont utilisés uniquement pour les workflows Cloud
Important : get_or_create_collection() accepte soit une embedding_function soit un schema, mais pas les deux. Utiliser schema quand vous avez besoin de plusieurs index, de recherche hybride ou d'embeddings creux ; utiliser embedding_function pour une simple recherche dense uniquement.

Démarrage rapide

Utiliser le topic CLI pour s'authentifier et écrire les identifiants Cloud :

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

Créer ensuite un CloudClient et choisir l'API selon le mode de recherche :

import { CloudClient } from 'chromadb';

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

Utiliser collection.query() pour la recherche dense uniquement. Utiliser Schema() plus Search() uniquement quand l'utilisateur a besoin d'une retrieval hybride, de plusieurs index ou d'une composition de requête/classement plus expressive.

Guidance Cloud

Les collections sont la principale limite d'isolation dans Chroma Cloud, et les métadonnées sont le principal mécanisme de filtrage à l'intérieur d'une collection. Recourir à Schema() uniquement quand vous avez besoin d'une configuration explicite dense+creux ou multi-index, et recourir à Search() uniquement quand query() n'est pas assez expressif.

En savoir plus

Si vous avez besoin d'informations plus détaillées sur Chroma au-delà de ce qui est couvert dans cette skill, récupérez le fichier llms.txt de Chroma pour une documentation complète : https://docs.trychroma.com/llms.txt

chroma-cloud