> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Démarrage rapide : Suivre les entrées et sorties d’un LLM
> Découvrez W&B Weave en ajoutant le traçage à votre application LLM pour déboguer et surveiller les interactions avec le modèle.
export const GitHubLink = ({url}) =>
Source GitHub
;
export const ColabLink = ({url}) =>
Essayer sur Colab
;
Découvrez comment suivre les appels LLM avec Weave en ajoutant du traçage à votre code. Ce démarrage rapide vous montre comment tracer une requête vers OpenAI et consulter les résultats dans Weave UI. Il s’adresse aux développeurs qui découvrent Weave et souhaitent instrumenter une application LLM pour le débogage et la surveillance."
## Ce que vous apprendrez
Ce guide vous montre comment :
* Importer et configurer Weave dans votre code.
* Utiliser le décorateur `weave.op` pour suivre l’exécution de votre code.
* Voir les traces dans Weave UI.
## Prérequis
* Un [compte W\&B](https://wandb.ai/signup)
* Python 3.10+ ou Node.js 18+
* Packages requis :
* **Python**: `pip install weave openai`
* **TypeScript**: `npm install weave openai`
* Une [clé API OpenAI](https://platform.openai.com/api-keys) configurée comme variable d'environnement.
## Enregistrer une trace dans un nouveau projet
Dans cette section, vous instrumentez une petite application afin que Weave puisse enregistrer ses entrées, ses sorties et son code. Pour commencer à suivre votre code et à enregistrer des traces dans Weave :
1. Importez la bibliothèque `weave` dans votre code.
2. Appelez `weave.init('your_wb_team/project_name')` dans votre code pour envoyer les informations de suivi à votre [équipe](/fr/platform/app/settings-page/teams) et à votre [projet](/fr/platform/hosting/iam/org_team_struct#project) W\&B. Si vous ne définissez pas d'équipe, Weave envoie les traces à votre [équipe par défaut](/fr/platform/app/settings-page/user-settings/#default-team). Si le projet indiqué n'existe pas dans votre équipe, Weave le crée.
3. Ajoutez le [`décorateur @weave.op()`](/fr/weave/guides/tracking/ops) aux fonctions que vous souhaitez suivre. Bien que Weave suive automatiquement les appels aux LLM pris en charge, le décorateur vous permet de suivre les entrées, les sorties et le code de fonctions spécifiques. En TypeScript, le décorateur utilise la syntaxe suivante : `weave.op(your_function)`.
L'exemple de code suivant envoie une requête à OpenAI (nécessite une [clé API OpenAI](https://platform.openai.com/docs/quickstart)), et Weave enregistre les informations de traçage de la requête. La requête demande au modèle OpenAI d'extraire les noms de dinosaures à partir de l'entrée et d'identifier le régime alimentaire de chaque dinosaure (herbivore ou carnivore).
L'exemple de code suivant suit votre premier projet avec Weave :
```python lines {1-2,7-8,27-28} theme={null}
# Importe la bibliothèque Weave
import weave
from openai import OpenAI
client = OpenAI()
# Weave suit automatiquement les entrées, les sorties et le code de cette fonction
@weave.op()
def extract_dinos(sentence: str) -> dict:
response = client.chat.completions.create(
model="gpt-4o",
messages=[
{
"role": "system",
"content": """In JSON format extract a list of `dinosaurs`, with their `name`,
their `common_name`, and whether its `diet` is a herbivore or carnivore"""
},
{
"role": "user",
"content": sentence
}
],
response_format={ "type": "json_object" }
)
return response.choices[0].message.content
# Initialise Weave et définit l'équipe et le projet dans lesquels enregistrer les données
weave.init('your-team/traces-quickstart')
sentence = """I watched as a Tyrannosaurus rex (T. rex) chased after a Triceratops (Trike), \
both carnivore and herbivore locked in an ancient dance. Meanwhile, a gentle giant \
Brachiosaurus (Brachi) calmly munched on treetops, blissfully unaware of the chaos below."""
result = extract_dinos(sentence)
print(result)
```
```typescript twoslash lines {1-2,7-8,20,24-25} theme={null}
// @noErrors
// Importe la bibliothèque Weave
import * as weave from 'weave';
import OpenAI from 'openai';
const openai = new OpenAI();
// Weave suit automatiquement les entrées, les sorties et le code de cette fonction
async function extractDinos(input: string) {
const response = await openai.chat.completions.create({
model: 'gpt-4o',
messages: [
{
role: 'user',
content: `In JSON format extract a list of 'dinosaurs', with their 'name', their 'common_name', and whether its 'diet' is a herbivore or carnivore: ${input}`,
},
],
});
return response.choices[0].message.content;
}
const extractDinosOp = weave.op(extractDinos);
async function main() {
// Initialise Weave et définit l'équipe et le projet dans lesquels enregistrer les données
await weave.init('your-team/traces-quickstart');
const result = await extractDinosOp(
'I watched as a Tyrannosaurus rex (T. rex) chased after a Triceratops (Trike), both carnivore and herbivore locked in an ancient dance. Meanwhile, a gentle giant Brachiosaurus (Brachi) calmly munched on treetops, blissfully unaware of the chaos below.'
);
console.log(result);
}
main();
```
Lorsque vous appelez la fonction `extract_dinos`, Weave affiche dans le terminal des liens qui vous permettent de voir vos traces. La sortie ressemble à ceci :
```text theme={null}
weave: $ pip install weave --upgrade
weave: Logged in as Weights & Biases user: example-username.
weave: View Weave data at https://wandb.ai/your-team/traces-quickstart/weave
weave: 🍩 https://wandb.ai/your-team/traces-quickstart/r/call/019ae171-7f32-7c96-8b42-931a32f900b7
{
"dinosaurs": [
{
"name": "Tyrannosaurus rex",
"common_name": "T. rex",
"diet": "carnivore"
},
{
"name": "Triceratops",
"common_name": "Trike",
"diet": "herbivore"
},
{
"name": "Brachiosaurus",
"common_name": "Brachi",
"diet": "herbivore"
}
]
}
```
## Voir les traces de votre application dans votre projet
Maintenant que votre code a produit une trace, vous pouvez l’inspecter dans Weave UI. Cliquez sur le lien affiché dans votre terminal, ou collez-le dans votre navigateur pour ouvrir Weave UI. Dans le panneau **Traces** de Weave UI, cliquez sur la trace pour afficher ses données, notamment son entrée, sa sortie, sa latence et l’utilisation des tokens.
Vous avez maintenant enregistré et affiché votre première trace Weave.
## En savoir plus sur les traces
* Découvrez comment [décorer vos fonctions et récupérer des informations sur les appels](/fr/weave/guides/tracking/tracing).
* Essayez le [playground](/fr/weave/guides/tools/playground) pour tester différents modèles sur des traces enregistrées.
* [Explorez les intégrations](/fr/weave/guides/integrations/). Weave suit automatiquement les appels à OpenAI, Anthropic et bien d'autres bibliothèques LLM. Si votre bibliothèque LLM ne fait pas partie des intégrations Weave, vous pouvez facilement suivre les appels à d'autres bibliothèques ou frameworks LLM en les encapsulant avec `@weave.op()`.
## Étapes suivantes
[Commencez par évaluer votre application](/fr/weave/tutorial-eval), puis découvrez comment [évaluer une application RAG](/fr/weave/tutorial-rag).
Vous avez maintenant enregistré et affiché votre première trace Weave.