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

Instructions

Admission

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

Recherche dense uniquement ou 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, utilise par défaut Chroma Cloud Qwen. Si la recherche hybride est nécessaire, utilise 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ède avec le contexte du repo au lieu de forcer l'admission.

Ce qu'il faut valider

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

Démarrage rapide

Utilise le sujet CLI pour s'authentifier et écrire les identifiants Cloud :

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

Ensuite, crée un CloudClient et choisis l'API selon le mode de recherche :

import { CloudClient } from 'chromadb';

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

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

Conseils Cloud

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

En savoir plus

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

Sujets disponibles

Typescript

Filtrage Regex Chroma - Apprends à utiliser les filtres regex dans les requêtes Chroma
Query et Get - Interroge et récupère des données des collections Chroma
Métadonnées - Stocke et interroge les métadonnées, incluant les filtres et les valeurs de tableau
Mise à jour et suppression - Met à jour les documents existants et supprime les données des collections
Schema - Schema() configure les collections avec plusieurs index
Chroma Cloud Qwen - Le service d'embedding Qwen hébergé par Chroma
Gestion des erreurs - Gère les erreurs et défaillances lors du travail avec Chroma
Clonage de collection - Duplique instantanément les collections avec le clonage par copie lors de l'accès dans Chroma Cloud
API Search() - Une API expressive et flexible pour effectuer une recherche vectorielle dense et creux sur les collections, ainsi qu'une recherche hybride

Python

Filtrage Regex Chroma - Apprends à utiliser les filtres regex dans les requêtes Chroma
Query et Get - Interroge et récupère des données des collections Chroma
Métadonnées - Stocke et interroge les métadonnées, incluant les filtres et les valeurs de tableau
Mise à jour et suppression - Met à jour les documents existants et supprime les données des collections
Schema - Schema() configure les collections avec plusieurs index
Chroma Cloud Qwen - Le service d'embedding Qwen hébergé par Chroma
Gestion des erreurs - Gère les erreurs et défaillances lors du travail avec Chroma
Clonage de collection - Duplique instantanément les collections avec le clonage par copie lors de l'accès dans Chroma Cloud
API Search() - Une API expressive et flexible pour effectuer une recherche vectorielle dense et creux sur les collections, ainsi qu'une recherche hybride

Général

Modèle de données - Un aperçu de la façon dont Chroma stocke les données
Intégrer Chroma dans un système existant - Conseils pour ajouter la recherche Chroma à une application existante
CLI Chroma - Prise en main du CLI Chroma pour l'authentification Chroma Cloud et la gestion des bases de données
Mise en cache des références de collection - Réduis les demandes répétées de recherche de collection dans les applications Chroma Cloud à fort trafic
Quotas et limites - Les quotas Chroma Cloud et limites de requête

chroma-cloud