llm-analytics-setup

PostHog LLM 分析

このスキルを使うと、AI／LLM プロバイダーを利用するあらゆるアプリケーションに PostHog LLM 分析を追加できます。

リファレンスファイル

• references/openai.md - Openai LLM 分析のインストール - ドキュメント
• references/azure-openai.md - Azure openai LLM 分析のインストール - ドキュメント
• references/anthropic.md - Anthropic LLM 分析のインストール - ドキュメント
• references/google.md - Google LLM 分析のインストール - ドキュメント
• references/cohere.md - Cohere LLM 分析のインストール - ドキュメント
• references/mistral.md - Mistral LLM 分析のインストール - ドキュメント
• references/perplexity.md - Perplexity LLM 分析のインストール - ドキュメント
• references/deepseek.md - Deepseek LLM 分析のインストール - ドキュメント
• references/groq.md - Groq LLM 分析のインストール - ドキュメント
• references/together-ai.md - Together ai LLM 分析のインストール - ドキュメント
• references/fireworks-ai.md - Fireworks ai LLM 分析のインストール - ドキュメント
• references/xai.md - Xai LLM 分析のインストール - ドキュメント
• references/cerebras.md - Cerebras LLM 分析のインストール - ドキュメント
• references/hugging-face.md - Hugging face LLM 分析のインストール - ドキュメント
• references/ollama.md - Ollama LLM 分析のインストール - ドキュメント
• references/openrouter.md - Openrouter LLM 分析のインストール - ドキュメント
• references/langchain.md - Langchain LLM 分析のインストール - ドキュメント
• references/llamaindex.md - Llamaindex LLM 分析のインストール - ドキュメント
• references/crewai.md - Crewai LLM 分析のインストール - ドキュメント
• references/autogen.md - Autogen LLM 分析のインストール - ドキュメント
• references/dspy.md - Dspy LLM 分析のインストール - ドキュメント
• references/langgraph.md - Langgraph LLM 分析のインストール - ドキュメント
• references/pydantic-ai.md - Pydantic ai LLM 分析のインストール - ドキュメント
• references/vercel-ai.md - Vercel ai SDK LLM 分析のインストール - ドキュメント
• references/litellm.md - Litellm LLM 分析のインストール - ドキュメント
• references/instructor.md - Instructor LLM 分析のインストール - ドキュメント
• references/semantic-kernel.md - Semantic kernel LLM 分析のインストール - ドキュメント
• references/mirascope.md - Mirascope LLM 分析のインストール - ドキュメント
• references/mastra.md - Mastra LLM 分析のインストール - ドキュメント
• references/smolagents.md - Smolagents LLM 分析のインストール - ドキュメント
• references/openai-agents.md - Openai agents SDK LLM 分析のインストール - ドキュメント
• references/portkey.md - Portkey LLM 分析のインストール - ドキュメント
• references/helicone.md - Helicone LLM 分析のインストール - ドキュメント
• references/manual-capture.md - 手動キャプチャによる LLM 分析のインストール - ドキュメント
• references/basics.md - LLM 分析の基本 - ドキュメント
• references/traces.md - トレース - ドキュメント
• references/calculating-costs.md - LLM のコスト計算 - ドキュメント

各プロバイダーのリファレンスには、そのプロバイダーまたはフレームワークに固有のインストール手順、SDK のセットアップ、コード例が記載されています。ユーザーの技術スタックに合うリファレンスを探し、その手順に従ってください。

ユーザーのプロバイダーが一覧にない場合は、フォールバックとして manual-capture.md を使用してください。これは、どのプロバイダーでも利用できる汎用的なイベントキャプチャの方法を説明しています。

主な原則

• 環境変数：PostHog と LLM プロバイダーのキーには、必ず環境変数を使用してください。コードに直接記述しないでください。
• 変更は最小限に：既存の LLM 呼び出しに加えて、LLM 分析を追加してください。既存のコードを置き換えたり、再構成したりしないでください。
• すべての生成をトレース：すべての LLM 呼び出しについて、入力トークン、出力トークン、モデル名、レイテンシ、コストをキャプチャしてください。
• ユーザーに関連付ける：可能な場合は、distinct ID を使って LLM の生成を識別済みユーザーに関連付けてください。
• 一度に一つのプロバイダー：ユーザーが実際に使用しているプロバイダーのみを計測してください。コードベースに存在しないプロバイダーの計測は追加しないでください。

フレームワークのガイドライン

• ソースコードは venv/site-packages ディレクトリにあることを覚えておいてください
• posthog は Python SDK のパッケージ名です
• pip install posthog または pip install -r requirements.txt で依存関係をインストールしてください。シェルコマンドで >= のような引用符で囲まれていないバージョン指定子を直接使用しないでください
• CLI やスクリプトでは、終了前に必ず posthog.shutdown() を呼び出してください。そうしないと、すべてのイベントが失われます
• モジュールレベルの posthog.api_key 設定ではなく、必ず Posthog() クラスのコンストラクター（インスタンスベースの API）を使用してください
• 例外を自動的に追跡するため、Posthog() コンストラクターには必ず enable_exception_autocapture=True を含めてください
• capture() のイベントプロパティに PII を絶対に送信しないでください。メールアドレス、氏名、電話番号、住所、IP アドレス、ユーザー生成コンテンツは含めないでください
• PII は capture() のイベントプロパティではなく、identify() の人物プロパティに設定してください。安全なイベントプロパティは、message_length、form_type、ブール値フラグなどのメタデータです
• 終了時にすべてのイベントがフラッシュされるよう、posthog_client.shutdown を atexit.register() に登録してください
• Python SDK には identify() メソッドがありません。人物プロパティを設定するには posthog_client.set(distinct_id=user_id, properties={...}) を使用するか、コンテキスト内で identify_context(user_id) を使用してください