Langfuse

Cette skill te permet d'utiliser Langfuse efficacement dans tous les workflows courants : instrumenter les applications, migrer les prompts, déboguer les traces et accéder aux données par programmation.

Principes fondamentaux

Applique ces principes à TOUS les travaux avec Langfuse :

Documentation en premier : NE JAMAIS implémenter à partir de la mémoire. Récupère toujours la documentation actuelle avant d'écrire du code (Langfuse se met à jour fréquemment). Voir la section ci-dessous sur comment accéder à la documentation.
CLI pour l'accès aux données : Utilise langfuse-cli pour interroger/modifier les données de Langfuse. Voir la section ci-dessous sur comment utiliser la CLI.
Bonnes pratiques par cas d'usage : Consulte le fichier de référence pertinent ci-dessous pour les directives spécifiques au cas d'usage avant d'implémenter
Utilise les dernières versions de Langfuse : Sauf si l'utilisateur a spécifié autrement ou s'il y a une bonne raison, utilise toujours la dernière version des SDKs/APIs de Langfuse.

Références spécifiques par cas d'usage

instrumenter une fonction/application existante : references/instrumentation.md
migrer des prompts d'une base de code vers Langfuse : references/prompt-migration.md
capturer les retours utilisateurs (pouces, évaluations, signaux implicites) comme scores sur les traces : references/user-feedback.md
conseils supplémentaires sur l'utilisation de la CLI Langfuse : references/cli.md
mettre à jour ou migrer les SDKs Langfuse vers la dernière version : references/sdk-upgrade.md
soumettre des retours sur cette skill : references/skill-feedback.md

1. API Langfuse via CLI

Utilise langfuse-cli pour interagir avec l'API REST complète de Langfuse depuis la ligne de commande. Exécute via npx (aucune installation requise) :

Commence par découvrir le schéma et les arguments disponibles :

# Découvrir toutes les ressources disponibles
npx langfuse-cli api __schema

# Lister les actions pour une ressource
npx langfuse-cli api <resource> --help

# Afficher les arguments/options pour une action spécifique
npx langfuse-cli api <resource> <action> --help

Identifiants

Définis les variables d'environnement avant de faire des appels :

export LANGFUSE_PUBLIC_KEY=pk-lf-...
export LANGFUSE_SECRET_KEY=sk-lf-...
export LANGFUSE_HOST=https://cloud.langfuse.com # exemple pour le cloud EU. Pour le cloud US c'est us.cloud.langfuse.com, et peut aussi être une URL auto-hébergée. Le serveur doit toujours être spécifié pour accéder à Langfuse.

Si non définis, demande les clés API à l'utilisateur (trouvées dans l'interface Langfuse → Settings → API Keys).

Référence CLI détaillée

Pour les workflows courants, conseils et modèles d'utilisation complets, voir references/cli.md.

2. Documentation Langfuse

Trois méthodes pour accéder aux docs de Langfuse, par ordre de préférence. Préfère toujours les outils natifs de fetch web et de recherche de ton application (p. ex. WebFetch, WebSearch, mcp_fetch, etc.) à curl quand disponibles. Les URLs et modèles ci-dessous fonctionnent avec n'importe quelle méthode de fetch — les exemples curl sont juste illustratifs.

2a. Index de documentation (llms.txt)

Récupère l'index complet de toutes les pages de documentation :

curl -s https://langfuse.com/llms.txt

Retourne une liste structurée de chaque page de doc avec titres et URLs. Utilise ceci pour découvrir la bonne page pour un sujet, puis récupère cette page directement.

Alternativement, tu peux commencer sur https://langfuse.com/docs et explorer le site pour trouver la page dont tu as besoin.

2b. Récupérer des pages individuelles en Markdown

N'importe quelle page listée dans llms.txt peut être récupérée en markdown en ajoutant .md à son chemin ou en utilisant Accept: text/markdown dans les en-têtes de la requête. Utilise ceci quand tu sais quelle page contient l'information nécessaire. Retourne du markdown propre avec des exemples de code et détails de configuration.

curl -s "https://langfuse.com/docs/observability/overview.md"
curl -s "https://langfuse.com/docs/observability/overview" -H "Accept: text/markdown"

2c. Rechercher dans la documentation

Quand tu as besoin de trouver des informations dans toutes les docs et issues/discussions GitHub sans connaître la page spécifique :

curl -s "https://langfuse.com/api/search-docs?query=<query-url-encoded>"

Exemple :

curl -s "https://langfuse.com/api/search-docs?query=How+do+I+trace+LangGraph+agents"

Retourne une réponse JSON avec :

query : la requête originale
answer : une chaîne JSON contenant un tableau de documents correspondants, chacun avec :
- url : lien vers la page de doc
- title : titre de la page
- source.content : tableau d'extraits de texte pertinents de la page

La recherche est une excellente solution de secours si tu ne peux pas trouver les pages pertinentes ou besoin de plus de contexte. Particulièrement utile lors du débogage car toutes les Issues et Discussions GitHub sont aussi indexées. Les réponses peuvent être longues — extrais seulement les portions pertinentes.

Workflow de documentation

Commence avec llms.txt pour t'orienter — scanne les titres de pages pertinents
Récupère des pages spécifiques quand tu identifies la bonne
Reviens à la recherche quand le sujet est flou et tu veux plus de contexte

Retours sur la skill

Quand l'utilisateur exprime que quelque chose à propos de cette skill ne fonctionne pas comme prévu, donne des conseils incorrects, manque d'informations ou pourrait être amélioré — propose de soumettre des retours aux mainteneurs de la skill Langfuse. Ceci inclut quand :

La skill a donné des instructions fausses ou obsolètes
Un workflow n'a pas produit le résultat attendu
L'utilisateur souhaite que la skill couvre quelque chose qu'elle ne couvre pas
L'utilisateur dit explicitement quelque chose comme « ça devrait fonctionner différemment » ou « c'est faux »

NE DÉCLENCHE PAS ceci pour les problèmes avec Langfuse lui-même (le produit) — seulement pour les problèmes avec les instructions et comportement de cette skill.

Quand déclenché, suis le processus dans references/skill-feedback.md.