Skip to content

Person Disambiguation Agent

Ambiguous person reference resolution agent.

Configuration

  • File: src/chatbot/agentic/agents/person_disambiguation_agent.py
  • Model profile: tenant-configured large
  • State: OverallState

Key Features

  • Resolves ambiguous person references
  • Handles multiple name matches
  • Interactive clarification
  • Context-aware selection

Tools

  • person_disambiguation_tool - Resolve ambiguous person references

Middleware

  • Chat history limiting for focused disambiguation

Use Cases

  • Multiple users with similar names
  • Common first/last name combinations
  • Clarifying "John" when multiple Johns exist
  • Department-specific name resolution

Durable clarification

Interactive HTTP chat uses the generic HITL contract. The person tool snapshots lookup candidates and requires confirmation or a unique choice. An ambiguous reply pauses again; cancellation ends the task. The confirmed identifier is preserved for simulation and the main graph continues the original request through the supervisor.