Analytique LLM PostHog

Cette skill vous aide à ajouter l'analytique LLM PostHog à n'importe quelle application utilisant des fournisseurs IA/LLM.

Fichiers de référence

• references/openai.md - Installation de l'analytique LLM OpenAI - docs
• references/azure-openai.md - Installation de l'analytique LLM Azure OpenAI - docs
• references/anthropic.md - Installation de l'analytique LLM Anthropic - docs
• references/google.md - Installation de l'analytique LLM Google - docs
• references/cohere.md - Installation de l'analytique LLM Cohere - docs
• references/mistral.md - Installation de l'analytique LLM Mistral - docs
• references/perplexity.md - Installation de l'analytique LLM Perplexity - docs
• references/deepseek.md - Installation de l'analytique LLM Deepseek - docs
• references/groq.md - Installation de l'analytique LLM Groq - docs
• references/together-ai.md - Installation de l'analytique LLM Together AI - docs
• references/fireworks-ai.md - Installation de l'analytique LLM Fireworks AI - docs
• references/xai.md - Installation de l'analytique LLM XAI - docs
• references/cerebras.md - Installation de l'analytique LLM Cerebras - docs
• references/hugging-face.md - Installation de l'analytique LLM Hugging Face - docs
• references/ollama.md - Installation de l'analytique LLM Ollama - docs
• references/openrouter.md - Installation de l'analytique LLM Openrouter - docs
• references/langchain.md - Installation de l'analytique LLM Langchain - docs
• references/llamaindex.md - Installation de l'analytique LLM Llamaindex - docs
• references/crewai.md - Installation de l'analytique LLM Crewai - docs
• references/autogen.md - Installation de l'analytique LLM Autogen - docs
• references/dspy.md - Installation de l'analytique LLM Dspy - docs
• references/langgraph.md - Installation de l'analytique LLM Langgraph - docs
• references/pydantic-ai.md - Installation de l'analytique LLM Pydantic AI - docs
• references/vercel-ai.md - Installation de l'analytique LLM Vercel AI SDK - docs
• references/litellm.md - Installation de l'analytique LLM Litellm - docs
• references/instructor.md - Installation de l'analytique LLM Instructor - docs
• references/semantic-kernel.md - Installation de l'analytique LLM Semantic Kernel - docs
• references/mirascope.md - Installation de l'analytique LLM Mirascope - docs
• references/mastra.md - Installation de l'analytique LLM Mastra - docs
• references/smolagents.md - Installation de l'analytique LLM Smolagents - docs
• references/openai-agents.md - Installation de l'analytique LLM OpenAI Agents SDK - docs
• references/portkey.md - Installation de l'analytique LLM Portkey - docs
• references/helicone.md - Installation de l'analytique LLM Helicone - docs
• references/manual-capture.md - Installation de l'analytique LLM par capture manuelle - docs
• references/basics.md - Bases de l'analytique LLM - docs
• references/traces.md - Traces - docs
• references/calculating-costs.md - Calcul des coûts LLM - docs

Chaque référence de fournisseur contient les instructions d'installation, la configuration du SDK et des exemples de code spécifiques à ce fournisseur ou framework. Trouvez la référence qui correspond à la stack de l'utilisateur et suivez ses instructions.

Si le fournisseur de l'utilisateur n'est pas listé, utilisez manual-capture.md comme solution de secours — elle couvre l'approche générique de capture d'événements qui fonctionne avec n'importe quel fournisseur.

Principes clés

• Variables d'environnement : Utilisez toujours des variables d'environnement pour les clés PostHog et des fournisseurs LLM. Ne les codez jamais en dur.
• Changements minimaux : Ajoutez l'analytique LLM aux appels LLM existants. Ne remplacez pas ou ne restructurez pas le code existant.
• Tracez toutes les générations : Capturez les tokens d'entrée, les tokens de sortie, le nom du modèle, la latence et les coûts pour chaque appel LLM.
• Reliez aux utilisateurs : Associez les générations LLM à des utilisateurs identifiés via des IDs distincts quand c'est possible.
• Un fournisseur à la fois : Instrumentez uniquement le(s) fournisseur(s) que l'utilisateur utilise réellement. N'ajoutez pas d'instrumentation pour les fournisseurs non présents dans le codebase.

Directives framework

• Rappelez-vous que le code source est disponible dans le répertoire venv/site-packages
• posthog est le nom du package SDK Python
• Installez les dépendances avec pip install posthog ou pip install -r requirements.txt et n'utilisez PAS de spécificateurs de version non échappés comme >= directement dans les commandes shell
• Dans les CLIs et scripts : DEVEZ appeler posthog.shutdown() avant la sortie ou tous les événements sont perdus
• Utilisez toujours le constructeur de classe Posthog() (API basée sur l'instance) au lieu de la configuration posthog.api_key au niveau du module
• Incluez toujours enable_exception_autocapture=True dans le constructeur Posthog() pour suivre automatiquement les exceptions
• N'ENVOYEZ JAMAIS d'informations personnelles (PII) dans les propriétés d'événement capture() — pas d'e-mails, noms complets, numéros de téléphone, adresses physiques, adresses IP ou contenu généré par l'utilisateur
• Les PII appartiennent aux propriétés de personne identify(), PAS aux propriétés d'événement capture(). Les propriétés d'événement sûres sont des métadonnées comme message_length, form_type, drapeaux booléens.
• Enregistrez posthog_client.shutdown avec atexit.register() pour garantir que tous les événements sont vidés à la sortie
• Le SDK Python n'a PAS de méthode identify() — utilisez posthog_client.set(distinct_id=user_id, properties={...}) pour définir les propriétés de personne, ou utilisez identify_context(user_id) dans un contexte