:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from typing import Any, cast
from uuid import uuid4
import pydantic
from drf_spectacular.types import OpenApiTypes
from drf_spectacular.utils import extend_schema
from rest_framework import serializers
from rest_framework.decorators import action
from rest_framework.permissions import IsAuthenticated
from rest_framework.request import Request
from rest_framework.response import Response
from rest_framework.viewsets import GenericViewSet
from posthog.api.routing import TeamAndOrgViewSetMixin
from posthog.auth import OAuthAccessTokenAuthentication, PersonalAPIKeyAuthentication
from posthog.event_usage import get_event_source
from posthog.models.user import User
from posthog.rate_limit import AIBurstRateThrottle, AISustainedRateThrottle
from posthog.renderers import SafeJSONRenderer
from products.posthog_ai.backend.models.assistant import Conversation
from ee.hogai.utils.types import AssistantState
class InsightsToolCallSerializer(serializers.Serializer):
query = serializers.CharField(required=True, max_length=1000)
insight_type = serializers.ChoiceField(choices=["trends", "funnel", "retention", "sql"])
def validate(self, data: dict[str, Any]):
try:
tool_call_state = AssistantState(
root_tool_call_id=str(uuid4()),
root_tool_insight_plan=data["query"],
root_tool_insight_type=data["insight_type"],
messages=[],
)
data["state"] = tool_call_state
except pydantic.ValidationError:
raise serializers.ValidationError("Invalid state content.")
return data
class MaxToolsViewSet(TeamAndOrgViewSetMixin, GenericViewSet):
scope_object = "project"
queryset = Conversation.objects.all()
permission_classes = [IsAuthenticated]
renderer_classes = [SafeJSONRenderer]
throttle_classes = [AIBurstRateThrottle, AISustainedRateThrottle]
authentication_classes = [PersonalAPIKeyAuthentication, OAuthAccessTokenAuthentication]
@extend_schema(request=InsightsToolCallSerializer, responses={200: OpenApiTypes.OBJECT})
@action(
detail=False,
methods=["POST"],
url_path="create_and_query_insight",
required_scopes=["insight:read", "query:read"],
)
def create_and_query_insight(self, request: Request, *args, **kwargs):
from ee.hogai.insights_assistant import InsightsAssistant
serializer = InsightsToolCallSerializer(data=request.data)
serializer.is_valid(raise_exception=True)
conversation = self.get_queryset().create(user=request.user, team=self.team, type=Conversation.Type.TOOL_CALL)
assistant = InsightsAssistant(
self.team,
conversation,
user=cast(User, request.user),
is_new_conversation=False, # we don't care about the conversation id being sent back to the client
initial_state=serializer.validated_data["state"],
is_agent_billable=False,
# This endpoint has no session auth, so it is never the web assistant — it is reached
# only by an agent through the MCP server. Resolving from the request rather than
# pinning `mcp` keeps the surface that wrapped MCP (desktop, Slack, the CLI) visible.
event_source=get_event_source(request),
)
return Response(
[
{"type": event_type, "data": data.model_dump(exclude_none=True)}
for event_type, data in assistant.invoke()
]
)