Help

Overview Admin Chat UI Design Curated Answers Search Settings Conversational Intelligence Data Sync Upload Documents Human Handoff Admin Console Authorisation Contact Support

Guided Search Overview

Airgentic Help

Guided Program Search (legacy)

Prefer Catalog Search for new work. Use Catalog Search (search_catalog) for new catalog and program agents. It validates plans against your Search Configuration instead of hand-building search URLs.

This page documents the legacy search_guided / URL-construction pattern (EducationPlannerBC-style). Keep that pattern only where agents still build Funnelback-style paths and pass them to search_guided().


When to keep search_guided

  • Existing EPBC-style integrations that construct /search/url/... paths in prompts
  • Agents that are not yet migrated to descriptor-backed search_catalog

For new services, use Search Configuration → Catalog Search and Enable Catalog Search on the agent instead.


Legacy flow (summary)

  1. Concierge builds a search URL from Query Building rules
  2. Calls search_guided(search_url)
  3. Platform fetches results and activates Search Guide
  4. Search Guide summarises hits for the user

Search Guide (search_guide) is still required for summarisation in both legacy and Catalog Search flows.


Migration path

  1. Configure catalog facets and scopes on Search Configuration
  2. Refresh Catalog Allowlists
  3. On the Concierge agent, click Enable Catalog Search (removes search_guided from that agent)
  4. Validate plans in the Catalog Search test console
  5. Retire URL-construction sections from Query Building once demos pass

See Catalog Search for the full admin workflow.

You have unsaved changes