Ask AI /chat/token request has empty body - AI-201 error

[liu-huitao]

VitePress version: 2.0.0-alpha.17
@docsearch/js version: 4.6.2

The /chat/token request to askai.algolia.com has an empty request body,
causing AI-201 error. The assistantId is not being passed to the request.

Config:
askAi: {
assistantId: 'xxx',
sidePanel: { panel: { variant: 'floating', side: 'right' } }
},
mode: 'hybrid'

[Zhengqbbb]

I encountered this issue again while setting up on the new site this afternoon, and it caused me 3 hours of debugging.

I eventually found that the old assistantId was very short, while the new agentId is much longer and has a flag.

vitepress/docs/.vitepress/config.ts

Line 116 in cb8f553

assistantId: 'YaVSonfX5bS8',

I think DocSearch and Algolia are undergoing product iteration, which causes newly registered agents to be unusable in the current version.

[Zhengqbbb]

Using: https://community.algolia.com/docsearch-playground/

The API of Agent Studio and AskAI is different !!! 🫠 🙃

[Zhengqbbb]

💡 Found it — I hacked this component and added it here, successfully switching the API

vitepress/src/client/theme-default/components/VPAlgoliaSearchBox.vue

Lines 108 to 125 in cb8f553

	...(askAi.sidePanel === true ? {} : askAi.sidePanel),
	container: '#vp-docsearch-sidepanel',
	indexName: askAi.indexName ?? userOptions.indexName,
	appId: askAi.appId ?? userOptions.appId,
	apiKey: askAi.apiKey ?? userOptions.apiKey,
	assistantId: askAi.assistantId,
	onOpen: focusInput,
	onClose: onClose.bind(null, 'sidepanel'),
	onReady: () => {
	if (openOnReady === 'askAi') {
	openOnReady = null
	onBeforeOpen('sidepanel', () => sidepanelInstance?.open())
	}
	},
	keyboardShortcuts: {
	'Ctrl/Cmd+I': false
	}
	} as SidepanelProps)

      container: '#vp-docsearch-sidepanel',
++    agentStudio: true,
++    suggestedQuestions: true,
      indexName: askAi.indexName ?? userOptions.indexName,

@brc-dd A not-so-professional idea — maybe the user-defined askAi options could be extended here, lol 🤣

[liu-huitao]

Resolved by patching node_modules/vitepress/dist/client/theme-default/components/VPAlgoliaSearchBox.vue

The root cause is that VitePress does not pass agentStudio: true to the sidepanel initialization, which causes the /chat/token request to have an empty body, triggering the AI-201 error.

Temporary fix: Manually add agentStudio: true in the sidepanel options inside VPAlgoliaSearchBox.vue:

sidepanelInstance = sidepanel({
  ...(askAi.sidePanel === true ? {} : askAi.sidePanel),
  container: '#vp-docsearch-sidepanel',
  agentStudio: true,  // ← add this line
  indexName: askAi.indexName ?? userOptions.indexName,
  ...
})

Use patch-package to persist the fix across npm install.

Hope the VitePress team can fix this officially. Thanks to @Zhengqbbb for the hint in the comments!