Blue Note Logic caveauAI docs
Docs/Azure Search/Technical

Technical

Azure Search

An optional hybrid search surface for curated corpora that need managed keyword, vector, and semantic reranking in Azure AI Search.

Open in app All docs

Public and internal interfaces

These are the main routes, handlers, and integration surfaces used by this product area.

GET /api/portal/azure-search/catalog POST /api/portal/azure-search

Architecture notes

  • The frontend page is caveauai-web/src/pages/app/AzureSearch.tsx.
  • Catalog and query calls are plan-gated and session-authenticated.
  • Search scope currently targets indexed packages, not arbitrary private corpora.

Access and permissions

App pages are authenticated through the shared bnl_session cookie unless explicitly marked public. Public docs should describe integration behavior without including secrets, private tokens, private IPs, or tenant-specific records.

Troubleshooting

  • An unavailable screen means the plan or tenant is not enabled for Azure Search.
  • Empty results can indicate the wrong package, overly narrow terms, or missing Azure index data.