When a spoken phrase could match several entities in our catalog — same region, similar names, or partial matches — who is responsible for disambiguation: Siri via App Schemas and entity resolution, or the app via EntityStringQuery returning multiple candidates? What’s the recommended UX pattern for ‘Did you mean A or B?’
The best way to integrate your app with Siri and Apple Intelligence is by conforming your AppEntities to the IndexedEntity protocol and indexing your app's content to the semantic index at runtime. By exposing your content to the system, the orchestrator will handle disambiguation on your behalf by surfacing relevant entities that best match the user's request. The system takes care of disambiguating request on your behalf.