Modes

Path A: local

createLocalAdapter() or omit both adapter and publishableKey. No keys. No network. The sample company is Northwind Outfitters.

Path B: Hosted

Publish an app, then pass appId and publishableKey. The widget posts { sessionId, question, pageContext } to POST /api/v1/ask?appId=. createHostedAdapter does the same when you want the client yourself. Hosted stores approved sources, the derived index, visitor questions, optional conversations, unanswered items, and citations.

Path C: BYO

Same app config. Your server implements ask. Knowledge, retrieval, the model, and visitor logs stay on your backend. Live config still needs BYO ($9.99) or Hosted ($19.99).

Related: Adapter · Quickstart