docs: add AI provider examples for all LLM analytics integrations (#478)

* docs: add AI provider examples for all LLM analytics integrations

Add 26 new example directories covering every provider documented in
our LLM analytics onboarding docs. This includes OpenAI-compatible
providers (Groq, DeepSeek, Mistral, xAI, Together AI, Ollama, Cohere,
Hugging Face, Perplexity, Cerebras, Fireworks AI, OpenRouter, Helicone,
Vercel AI Gateway, Azure OpenAI, Portkey) and custom integrations
(Instructor, LangGraph, AWS Bedrock, CrewAI, Mirascope, LlamaIndex,
DSPy, Semantic Kernel, smolagents, AutoGen).

* fix: use max_tokens instead of max_completion_tokens for Mistral example

Mistral's API doesn't support max_completion_tokens, causing 422 errors.

* fix: remove unsupported posthog_distinct_id kwarg from Mirascope example

Mirascope doesn't pass extra kwargs through to the OpenAI client.
Tracking still works via the wrapped client.

* fix: update Bedrock model ID and response parsing, fix Cerebras model

Author: richardsolomou

examples/example-ai-autogen/.env.example

@@ -0,0 +1,3 @@
+POSTHOG_API_KEY=phc_your_project_api_key
+POSTHOG_HOST=https://us.i.posthog.com
+OPENAI_API_KEY=sk-your_api_key

examples/example-ai-autogen/README.md

@@ -0,0 +1,22 @@
+# AutoGen + PostHog AI Examples
+
+Track AutoGen agent LLM calls with PostHog.
+
+## Setup
+
+```bash
+cp .env.example .env
+# Fill in your API keys in .env
+uv sync
+```
+
+## Examples
+
+- **agent.py** - AutoGen agent with PostHog tracking via OpenAI wrapper
+
+## Run
+
+```bash
+source .env
+uv run python agent.py
+```

examples/example-ai-autogen/agent.py

@@ -0,0 +1,31 @@
+"""AutoGen with PostHog tracking via OpenAI wrapper."""
+
+import os
+import asyncio
+from posthog import Posthog
+from posthog.ai.openai import OpenAI
+from autogen_agentchat.agents import AssistantAgent
+from autogen_ext.models.openai import OpenAIChatCompletionClient
+
+posthog = Posthog(
+    os.environ["POSTHOG_API_KEY"],
+    host=os.environ.get("POSTHOG_HOST", "https://us.i.posthog.com"),
+)
+openai_client = OpenAI(api_key=os.environ["OPENAI_API_KEY"], posthog_client=posthog)
+
+model_client = OpenAIChatCompletionClient(
+    model="gpt-4o-mini",
+    openai_client=openai_client,
+)
+
+agent = AssistantAgent("assistant", model_client=model_client)
+
+
+async def main():
+    result = await agent.run(task="Tell me a fun fact about hedgehogs.")
+    print(result)
+    await model_client.close()
+
+
+asyncio.run(main())
+posthog.shutdown()

examples/example-ai-autogen/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "example-ai-autogen"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = [
+    "posthog==7.9.12",
+    "autogen-agentchat>=0.4.0",
+    "autogen-ext[openai]>=0.4.0",
+]

examples/example-ai-autogen/uv.lock

@@ -0,0 +1 @@
+exclude-newer = "7 days"

examples/example-ai-autogen/uv.toml

@@ -0,0 +1,5 @@
+POSTHOG_API_KEY=phc_your_project_api_key
+POSTHOG_HOST=https://us.i.posthog.com
+AWS_REGION=us-east-1
+AWS_ACCESS_KEY_ID=your_access_key
+AWS_SECRET_ACCESS_KEY=your_secret_key

examples/example-ai-aws-bedrock/.env.example

@@ -0,0 +1,22 @@
+# AWS Bedrock + PostHog AI Examples
+
+Track AWS Bedrock LLM calls with PostHog via OpenTelemetry instrumentation.
+
+## Setup
+
+```bash
+cp .env.example .env
+# Fill in your API keys in .env
+uv sync
+```
+
+## Examples
+
+- **chat.py** - Bedrock Converse API with OpenTelemetry tracing to PostHog
+
+## Run
+
+```bash
+source .env
+uv run python chat.py
+```

examples/example-ai-aws-bedrock/README.md

@@ -0,0 +1,43 @@
+"""AWS Bedrock chat with OpenTelemetry instrumentation, tracked by PostHog."""
+
+import os
+import boto3
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from opentelemetry.sdk.resources import Resource, SERVICE_NAME
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from opentelemetry.instrumentation.botocore import BotocoreInstrumentor
+
+resource = Resource(attributes={SERVICE_NAME: "example-bedrock-app"})
+
+exporter = OTLPSpanExporter(
+    endpoint=f"{os.environ.get('POSTHOG_HOST', 'https://us.i.posthog.com')}/i/v0/ai/otel",
+    headers={"Authorization": f"Bearer {os.environ['POSTHOG_API_KEY']}"},
+)
+
+provider = TracerProvider(resource=resource)
+provider.add_span_processor(BatchSpanProcessor(exporter))
+trace.set_tracer_provider(provider)
+
+BotocoreInstrumentor().instrument()
+
+client = boto3.client(
+    "bedrock-runtime",
+    region_name=os.environ.get("AWS_REGION", "us-east-1"),
+)
+
+response = client.converse(
+    modelId="openai.gpt-oss-20b-1:0",
+    messages=[
+        {
+            "role": "user",
+            "content": [{"text": "Tell me a fun fact about hedgehogs."}],
+        }
+    ],
+)
+
+for block in response["output"]["message"]["content"]:
+    if "text" in block:
+        print(block["text"])
+        break

examples/example-ai-aws-bedrock/chat.py

@@ -0,0 +1,11 @@
+[project]
+name = "example-ai-aws-bedrock"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = [
+    "posthog==7.9.12",
+    "boto3>=1.35.0",
+    "opentelemetry-instrumentation-botocore>=0.49b0",
+    "opentelemetry-sdk>=1.30.0",
+    "opentelemetry-exporter-otlp-proto-http>=1.30.0",
+]