Crewai

2

Install CrewAI

Required

Install CrewAI. PostHog instruments your LLM calls through LiteLLM’s callback system that CrewAI uses natively.

pip install crewai litellm

3

Configure PostHog with LiteLLM

Required

Set your PostHog project token and host as environment variables, then configure LiteLLM to use PostHog as a callback handler. You can find your project token in your project settings (opens in a new tab).

import os
import litellm
from crewai import Agent, Task, Crew
# Set PostHog environment variables
os.environ["POSTHOG_API_KEY"] = "<ph_project_token>"
os.environ["POSTHOG_API_URL"] = "https://us.i.posthog.com"
# Enable PostHog callbacks in LiteLLM
litellm.success_callback = ["posthog"]
litellm.failure_callback = ["posthog"]

How this works

CrewAI uses LiteLLM under the hood for LLM provider access. By configuring PostHog as a LiteLLM callback, all LLM calls made through CrewAI are automatically captured as $ai_generation events without proxying your calls.

4

Run your crew

Required

Run your CrewAI agents as normal. PostHog automatically captures generation events for each LLM call.

researcher = Agent(
    role="Researcher",
    goal="Find interesting facts about hedgehogs",
    backstory="You are an expert wildlife researcher.",
)
task = Task(
    description="Research three fun facts about hedgehogs.",
    expected_output="A list of three fun facts.",
    agent=researcher,
)
crew = Crew(
    agents=[researcher],
    tasks=[task],
)
result = crew.kickoff()
print(result)

You can expect captured $ai_generation events to have the following properties:

Verify traces and generations

Recommended

Confirm LLM events are being sent to PostHog

Let’s make sure LLM events are being captured and sent to PostHog. Under AI Observability, you should see rows of data appear in the Traces and Generations tabs.

Check for LLM events in PostHog (opens in a new tab)

5

Next steps

Recommended

Now that you’re capturing AI conversations, continue with the resources below to learn what else AI Observability enables within the PostHog platform.