Skip to content

readonly-state-agent-context.md

Latest commit

 

History

History
73 lines (53 loc) · 3.58 KB

readonly-state-agent-context.md

File metadata and controls

73 lines (53 loc) · 3.58 KB
Raw

QA: Read-Only Agent Context — LangGraph (Python)

Prerequisites

  • Demo is deployed and accessible
  • Agent backend is healthy (check /api/health)
  • Graph readonly_state_agent_context is registered in the runtime (see api/copilotkit/route.ts)

Test Steps

1. Basic Functionality

  • Navigate to the readonly-state-agent-context demo page
  • Verify the "Agent Context" card is visible (data-testid="context-card")
  • Verify the description text references useAgentContext: "Read-only context provided to the agent via useAgentContext. The agent cannot modify these."
  • Verify the chat panel renders on the right with placeholder "Ask about your context..."
  • Send a basic message (e.g. "Hello") via the chat
  • Verify the agent responds with a text message

2. Feature-Specific Checks

Initial Context State

  • Verify the Name input (data-testid="ctx-name") defaults to "Atai"
  • Verify the Timezone dropdown (data-testid="ctx-timezone") defaults to "America/Los_Angeles"
  • Verify the Timezone dropdown offers: America/Los_Angeles, America/New_York, Europe/London, Europe/Berlin, Asia/Tokyo, Australia/Sydney
  • Verify the Recent Activity checkboxes list: "Viewed the pricing page", "Added 'Pro Plan' to cart", "Watched the product demo video", "Started the 14-day free trial", "Invited a teammate"
  • Verify two activities are checked by default: "Viewed the pricing page" and "Watched the product demo video"
  • Verify the Published Context JSON preview (data-testid="ctx-state-json") shows { "name": "Atai", "timezone": "America/Los_Angeles", "recentActivity": [...] }

Suggestions

  • Verify "Who am I?" suggestion is visible
  • Verify "Suggest next steps" suggestion is visible
  • Verify "Plan my morning" suggestion is visible

Agent Reads User Name (useAgentContext)

  • Click the "Who am I?" suggestion (or ask "What is my name?")
  • Verify the agent response addresses the user as "Atai"
  • Edit the Name input (data-testid="ctx-name") to "Jamie"
  • Verify the Published Context JSON updates to show "name": "Jamie"
  • Ask "What is my name?" again
  • Verify the agent now responds with "Jamie" (not "Atai")

Agent Reads Timezone

  • Change the Timezone dropdown (data-testid="ctx-timezone") to "Asia/Tokyo"
  • Verify the Published Context JSON updates to "timezone": "Asia/Tokyo"
  • Click the "Plan my morning" suggestion
  • Verify the agent's response references Tokyo / JST / Asia/Tokyo when discussing the time

Agent Reads Recent Activity

  • Uncheck all default activities, then check only "Started the 14-day free trial" and "Invited a teammate"
  • Verify the Published Context JSON shows the new recentActivity array
  • Click the "Suggest next steps" suggestion
  • Verify the agent's response references the trial and/or invited-teammate activities (not the pricing page or demo video)

3. Error Handling

  • Clear the Name input to an empty string and ask "What is my name?" — agent should handle gracefully (no crash)
  • Send an empty chat message — input should be rejected without error
  • Verify no console errors during normal usage
  • Verify the agent cannot modify context values (Name / Timezone / Activity checkboxes stay user-controlled)

Expected Results

  • Context card and chat load within 3 seconds
  • Agent responds within 10 seconds
  • Every change to Name / Timezone / Recent Activity reflects in the Published Context JSON immediately
  • Agent responses reflect the CURRENT context values on every turn (no stale context)
  • No UI errors or broken layouts