Readme FR

Remarque : Ce fichier a été traduit automatiquement. Les améliorations de la traduction sont bienvenues !

    </picture></a>
    

    Opik : Observabilité, évaluation et traçage d'agents IA pour LLM en open source
</div>

<a href="#-llm-as-a-judge-metrics">🧑‍⚖️ LLM comme juge</a> • <a href="#-evaluating-your-llm-application">🔍 Évaluer votre application</a> • <a href="#-star-us-on-github">⭐ Ajoutez une étoile</a> • <a href="#-contributing">🤝 Contribuer</a>

<a id="-what-is-opik"></a>

🚀 Qu'est-ce qu'Opik ?

Opik couvre l'ensemble du cycle de vie des applications LLM, de la première trace en développement jusqu'à la surveillance en production, pour les équipes qui créent des applications LLM et des agents IA. Les principales offres incluent :

• Traçage et observabilité des agents IA : traçage approfondi des appels LLM, journalisation des conversations et de l'activité des agents, avec des arbres de traces complets pour les agents multi-étapes et les appels d'outils.
• Évaluation des LLM : jeux de données, expériences et métriques LLM-comme-juge pour la détection des hallucinations, la modération et l'évaluation RAG.
• Optimisation des prompts et des agents : le SDK Opik Agent Optimizer pour améliorer les prompts et les agents.
• Surveillance prête pour la production : tableaux de bord évolutifs et règles d'évaluation en ligne.
• Opik Guardrails : des fonctionnalités pour vous aider à mettre en œuvre des pratiques d'IA sûres et responsables.
• Évaluation CI/CD : une intégration PyTest pour tester les pipelines LLM à chaque commit.

Les principales capacités incluent :

• Développement et traçage :

  • Suivez tous les appels et traces LLM avec un contexte détaillé pendant le développement et en production (Démarrage rapide).
  • De nombreuses intégrations tierces pour une observabilité facile : intégrez-vous en toute transparence avec une liste croissante de frameworks, dont beaucoup parmi les plus grands et les plus populaires sont pris en charge nativement (y compris des ajouts récents comme Google ADK, Autogen et Flowise AI). (Intégrations)
  • Annotez les traces et les spans avec des scores de feedback via le SDK Python ou l'interface.
  • Expérimentez avec des prompts et des modèles dans le Prompt Playground.

• Évaluation et test :

  • Automatisez l'évaluation de votre application LLM avec les Jeux de données et les Expériences.
  • Tirez parti de puissantes métriques LLM-comme-juge pour des tâches complexes comme la détection des hallucinations, la modération et l'évaluation RAG (Pertinence de la réponse, Précision du contexte).
  • Intégrez les évaluations dans votre pipeline CI/CD grâce à notre intégration PyTest.

• Surveillance et optimisation en production :

  • Journalisez de grands volumes de traces de production : Opik est conçu pour le passage à l'échelle (plus de 40 M de traces/jour).
  • Surveillez les scores de feedback, le nombre de traces et l'utilisation des tokens au fil du temps dans le Tableau de bord Opik.
  • Utilisez les Règles d'évaluation en ligne avec des métriques LLM-comme-juge pour identifier les problèmes de production.
  • Tirez parti d'Opik Agent Optimizer et d'Opik Guardrails pour améliorer et sécuriser en continu vos applications LLM en production.

À qui cela s'adresse : aux ingénieurs ML qui construisent des agents alimentés par LLM, aux équipes IA qui passent du prototype à la production, et aux équipes d'ingénierie qui ont besoin d'une observabilité open source et auto-hébergeable qu'elles peuvent exécuter dans leur propre environnement.

Pourquoi l'open source compte ici : Opik est sous licence Apache-2.0 et gratuit à auto-héberger : la plateforme complète, backend inclus, pas seulement un SDK client. Le dépôt inclut le backend serveur, l'application web, le traçage, les jeux de données, les expériences, les évaluations, la gestion des prompts, l'évaluation en ligne et les composants d'optimisation d'agents, le tout sous licence Apache-2.0. Vous pouvez exécuter l'observabilité des LLM au sein de votre propre infrastructure, sans qu'aucune donnée ne quitte votre environnement et sans avoir à passer par une conversation commerciale Enterprise.

[!TIP] Si vous recherchez des fonctionnalités qu'Opik ne propose pas aujourd'hui, veuillez soumettre une nouvelle demande de fonctionnalité 🚀

<a id="-quick-start"></a>

⚡ Démarrage rapide

Installez le SDK Python et configurez-le :

pip install opik
opik configure

Enveloppez n'importe quelle fonction avec le décorateur @track pour commencer à journaliser les traces :

from opik import track

@track
def my_function(input: str) -> str:
    return input

Chaque appel à my_function est désormais journalisé dans Opik, y compris les appels imbriqués, ce qui fonctionne donc pour des traces complètes d'agents et de pipelines, et pas seulement pour des appels LLM isolés. Consultez le guide de démarrage rapide pour le SDK TypeScript et d'autres options de configuration.

<a id="-how-opik-compares"></a>

📊 Comment Opik se compare-t-il ?

Opik est en concurrence dans la catégorie observabilité des LLM / évaluation des agents IA aux côtés de LangSmith, Arize (Phoenix et Arize AX), Weights & Biases (Weave), Langfuse et Braintrust.

Quand les équipes choisissent Opik : la plateforme complète d'observabilité, d'évaluation et d'optimisation d'Opik est sous licence Apache-2.0 et gratuite à auto-héberger. Contrairement aux plateformes fermées dont le déploiement auto-hébergé requiert un plan Enterprise, Opik peut être déployé sans licence commerciale, et il est indépendant du framework, de sorte qu'il ne vous enferme pas dans un écosystème d'agents unique. Consultez le tableau ci-dessus pour voir où l'auto-hébergement et les licences diffèrent selon les alternatives.

<a id="-frequently-asked-questions"></a>

❓ Foire aux questions

Opik est-il open source ?

Opik est sous licence Apache 2.0. Son serveur, son application web et ses capacités fondamentales d'observabilité et d'évaluation peuvent être auto-hébergés sans licence commerciale.

Puis-je auto-héberger Opik ?

Oui. Opik peut être déployé localement ou dans votre propre infrastructure à l'aide des options d'auto-hébergement documentées.

Opik prend-il en charge le traçage des agents IA ?

Oui. Opik capture des traces multi-étapes contenant des appels LLM, des exécutions d'outils, des étapes de récupération et d'autres activités d'agents.

Opik prend-il en charge l'évaluation des LLM ?

Oui. Opik prend en charge les jeux de données, les expériences, les métriques basées sur le code, l'évaluation LLM-comme-juge et l'évaluation en ligne.

Opik est-il lié à un framework d'agents spécifique ?

Non. Opik est indépendant du framework et prend en charge son SDK, OpenTelemetry et des intégrations propres à chaque framework.

<a id="%EF%B8%8F-opik-server-installation"></a>

🛠️ Installation du serveur Opik

Faites fonctionner votre serveur Opik en quelques minutes. Choisissez l'option qui correspond le mieux à vos besoins :

Option 1 : Comet.com Cloud (le plus simple et recommandé)

Accédez à Opik instantanément sans aucune configuration. Idéal pour des démarrages rapides et une maintenance sans tracas.

👉 Créez votre compte Comet gratuit

Option 2 : Auto-héberger Opik pour un contrôle total

Déployez Opik dans votre propre environnement. Choisissez entre Docker pour les configurations locales ou Kubernetes pour l'évolutivité.

Auto-hébergement avec Docker Compose (pour le développement et les tests locaux)

C'est la façon la plus simple d'obtenir une instance Opik locale opérationnelle. Notez le nouveau script d'installation ./opik.sh :

Sur un environnement Linux ou Mac :

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
./opik.sh

Sur un environnement Windows :

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
powershell -ExecutionPolicy ByPass -c ".\\opik.ps1"

Profils de service pour le développement

Les scripts d'installation d'Opik prennent désormais en charge des profils de service pour différents scénarios de développement :

# Start full Opik suite (default behavior)
./opik.sh

# Start only infrastructure services (databases, caches etc.)
./opik.sh --infra

# Start infrastructure + backend services
./opik.sh --backend

# Enable guardrails with any profile
./opik.sh --guardrails # Guardrails with full Opik suite
./opik.sh --backend --guardrails # Guardrails with infrastructure + backend

Utilisez les options --help ou --info pour résoudre les problèmes. Les Dockerfiles garantissent désormais que les conteneurs s'exécutent en tant qu'utilisateurs non-root pour une sécurité renforcée. Une fois que tout est opérationnel, vous pouvez désormais visiter localhost:5173 dans votre navigateur ! Pour des instructions détaillées, consultez le Guide de déploiement local.

Auto-hébergement avec Kubernetes et Helm (pour les déploiements évolutifs)

Pour les déploiements auto-hébergés en production ou à plus grande échelle, Opik peut être installé sur un cluster Kubernetes à l'aide de notre chart Helm. Cliquez sur le badge pour consulter le Guide d'installation Kubernetes avec Helm complet.

[!IMPORTANT] Modifications de la version 1.7.0 : veuillez consulter le journal des modifications pour les mises à jour importantes et les changements incompatibles.

<a id="-opik-client-sdk"></a>

💻 SDK client Opik

Opik fournit une suite de bibliothèques clientes et une API REST pour interagir avec le serveur Opik. Cela inclut des SDK pour Python, TypeScript et Ruby (via OpenTelemetry), permettant une intégration transparente dans vos workflows. Pour des références détaillées sur l'API et les SDK, consultez la Documentation de référence du client Opik.

Démarrage rapide du SDK Python

Pour commencer avec le SDK Python :

Installez le paquet :

# install using pip
pip install opik

# or install with uv
uv pip install opik

Configurez le SDK Python en exécutant la commande opik configure, qui vous demandera l'adresse de votre serveur Opik (pour les instances auto-hébergées) ou votre clé d'API et votre espace de travail (pour Comet.com) :

opik configure

[!TIP] Vous pouvez également appeler opik.configure(use_local=True) depuis votre code Python pour configurer le SDK afin qu'il s'exécute sur une installation locale auto-hébergée, ou fournir directement la clé d'API et les détails de l'espace de travail pour Comet.com. Reportez-vous à la documentation du SDK Python pour d'autres options de configuration.

Vous êtes maintenant prêt à commencer à journaliser des traces à l'aide du SDK Python.

<a id="-logging-traces-with-integrations"></a>

📝 Journalisation des traces avec les intégrations

La façon la plus simple de journaliser des traces est d'utiliser l'une de nos intégrations directes. Opik prend en charge un large éventail de frameworks, y compris des ajouts récents comme Google ADK, Autogen, AG2 et Flowise AI :

[!TIP] Si le framework que vous utilisez ne figure pas dans la liste ci-dessus, n'hésitez pas à ouvrir un ticket ou à soumettre une PR avec l'intégration.

Si vous n'utilisez aucun des frameworks ci-dessus, vous pouvez également utiliser le décorateur de fonction track pour journaliser les traces :

import opik

opik.configure(use_local=True) # Run locally

@opik.track
def my_llm_function(user_question: str) -> str:
    # Your LLM code here

    return "Hello"

[!TIP] Le décorateur track peut être utilisé conjointement avec n'importe laquelle de nos intégrations et peut également servir à suivre les appels de fonctions imbriqués.

<a id="-llm-as-a-judge-metrics"></a>

🧑‍⚖️ Métriques LLM comme juge

Le SDK Python d'Opik inclut un certain nombre de métriques LLM-comme-juge pour vous aider à évaluer votre application LLM. Apprenez-en davantage dans la documentation des métriques.

Pour les utiliser, importez simplement la métrique pertinente et utilisez la fonction score :

from opik.evaluation.metrics import Hallucination

metric = Hallucination()
score = metric.score(
    input="What is the capital of France?",
    output="Paris",
    context=["France is a country in Europe."]
)
print(score)

Opik inclut également un certain nombre de métriques heuristiques prédéfinies ainsi que la possibilité de créer les vôtres. Apprenez-en davantage dans la documentation des métriques.

<a id="-evaluating-your-llm-application"></a>

🔍 Évaluer vos applications LLM

Opik vous permet d'évaluer votre application LLM pendant le développement grâce aux Jeux de données et aux Expériences. Le Tableau de bord Opik propose des graphiques améliorés pour les expériences et une meilleure gestion des grandes traces. Vous pouvez également exécuter des évaluations dans le cadre de votre pipeline CI/CD à l'aide de notre intégration PyTest.

<a id="-star-us-on-github"></a>

⭐ Ajoutez-nous une étoile sur GitHub

Si vous trouvez Opik utile, envisagez de nous donner une étoile ! Votre soutien nous aide à faire grandir notre communauté et à continuer d'améliorer le produit.

<a id="-contributing"></a>

🤝 Contribuer

Il existe de nombreuses façons de contribuer à Opik :

• Soumettre des rapports de bugs et des demandes de fonctionnalités
• Relire la documentation et soumettre des Pull Requests pour l'améliorer
• Parler ou écrire à propos d'Opik et nous en informer
• Voter pour les demandes de fonctionnalités populaires afin de montrer votre soutien

Pour en savoir plus sur la façon de contribuer à Opik, veuillez consulter nos directives de contribution.