copilotkit--copilotkit/showcase/integrations/pydantic-ai/qa/beautiful-chat.md

QA: Beautiful Chat — PydanticAI

Prerequisites

• Demo is deployed and accessible
• Agent backend is healthy (check /api/health)
• OPENAI_API_KEY set

Test Steps

1. Basic Functionality

• Navigate to /demos/beautiful-chat
• Verify the polished two-column layout renders with the chat column and a toggle between "Chat" and "App" modes
• Verify suggestion pills render in the chat

2. Controlled Generative UI (Charts)

• Click "Pie Chart (Controlled Generative UI)"
• Verify the agent calls query_data then renders a pie chart inline
• Click "Bar Chart" and verify a bar chart renders

3. A2UI

• Click "Search Flights (A2UI Fixed Schema)"
• Verify 2 flight cards render inline via the fixed flight catalog
• Click "Sales Dashboard (A2UI Dynamic)"
• Verify a dashboard with metrics + charts renders

4. Open Generative UI

• Click "Calculator App (Open Generative UI)"
• Verify a sandboxed calculator iframe mounts

5. Shared State (Todos)

• Click "Task Manager (Shared State)"
• Verify the layout flips to "App" mode and todos appear in the right-hand canvas
• Toggle a todo's checkbox; verify the UI updates locally
• Edit a todo title/description; verify it persists

6. Frontend Tools

• Click "Toggle Theme (Frontend Tools)"
• Verify the dark/light theme flips via the toggleTheme tool

7. HITL

• Click "Schedule Meeting (Human In The Loop)"
• Verify a time picker modal opens in chat

Known Limitations vs. langgraph-python port

• MCP Apps (Excalidraw): not wired on the PydanticAI backend; the "Excalidraw Diagram" suggestion pill is intentionally omitted here. Tracked in PARITY_NOTES.md.
• Per-token state streaming: langgraph-python uses StateStreamingMiddleware to stream per-token todo deltas. PydanticAI's agent.to_ag_ui() emits a single STATE_SNAPSHOT on manage_todos completion instead. Functionally equivalent — the todo list still appears — but does not animate character-by-character.

Expected Results

• Fixed-schema flight cards, dynamic-schema dashboards, sandboxed iframes, the HITL time picker, and the shared todos canvas all render in a single combined cell powered by the beautiful_chat PydanticAI agent.