Migrate Ask AI to Agent Studio

Ask AI is now part of Agent Studio, where you build and manage AI agents. Migrate your existing Ask AI assistant, publish the new agent, then point DocSearch or your custom API client to Agent Studio.

Migrate your assistant

Start the migration in the dashboard

Sign in to the Algolia dashboard.
Open Ask AI.
Select your assistant and click Migrate to Agent Studio.

The wizard creates a draft Agent Studio agent from your assistant configuration, including the prompt, model, indices, and related settings. After migration, the assistant and agent are independent and don’t stay in sync.

Review and publish the agent

Open Agents in Agent Studio.
Review the migrated agent.
Publish the agent when you’re ready to go live.

Copy the agent ID. You use it in DocSearch and in custom API clients.

Update your integration

Choose the path that matches how you embed Ask AI today:

DocSearch v4
DocSearch v5
Custom Ask AI API

Your existing Ask AI assistant keeps serving traffic until Ask AI is fully retired. Switch your client to the Agent Studio agent when you’re ready.

Update DocSearch

For the full DocSearch reference, see Migrate Ask AI to Agent Studio in the DocSearch docs.

DocSearch v4

Set agentStudio to true inside the askAi object and pass your Agent Studio agent ID as assistantId:

import docsearch from '@docsearch/js';

import '@docsearch/css';

docsearch({
  container: '#docsearch',
  appId: 'YourApplicationID',
  apiKey: 'YourSearchOnlyAPIKey',
  indexName: 'YourIndexName',
  askAi: {
    assistantId: 'YOUR_AGENT_ID',
    agentStudio: true,
  },
});

import { DocSearch } from '@docsearch/react';

import '@docsearch/css';

function App() {
  return (
    <DocSearch
      appId="YourApplicationID"
      apiKey="YourSearchOnlyAPIKey"
      indexName="YourIndexName"
      askAi={{
        assistantId: 'YOUR_AGENT_ID',
        agentStudio: true,
      }}
    />
  );
}

export default App;

Notes:

Put agentStudio inside askAi, not as a top-level DocSearch prop.
When agentStudio is true, DocSearch sends chat requests to Agent Studio for you.

DocSearch v5

In DocSearch v5, Agent Studio is the default chat backend. Pass your Agent Studio agent ID directly as askAi. You don’t need an agentStudio flag:

import docsearch from '@docsearch/js';

import '@docsearch/css';

docsearch({
  container: '#docsearch',
  appId: 'YourApplicationID',
  apiKey: 'YourSearchOnlyAPIKey',
  indices: ['YourIndexName'],
  askAi: 'YOUR_AGENT_ID',
});

import { DocSearchAI } from '@docsearch/react';

import '@docsearch/css';

function App() {
  return (
    <DocSearchAI
      appId="YourApplicationID"
      apiKey="YourSearchOnlyAPIKey"
      indices={['YourIndexName']}
      askAi="YOUR_AGENT_ID"
    />
  );
}

export default App;

Custom Ask AI API integrations

If you call the Ask AI HTTP API yourself instead of using DocSearch, point your client at Agent Studio instead of https://askai.algolia.com. Don’t build new integrations against the Ask AI chat API. Use the Agent Studio APIs:

Integrate Agent Studio
Agent Studio API
Completions endpoint example: https://{APPLICATION_ID}.algolia.net/agent-studio/1/agents/{AGENT_ID}/completions

Authenticate with your application ID and a search-only API key. For DocSearch users, prefer the SDK configuration above— DocSearch wires the Agent Studio transport when agentStudio is true.

Search and Discovery platform

Optimization and Personalization

AI-powered experiences

Production and scale

Migrate Ask AI to Agent Studio

Migrate your assistant

Update DocSearch

DocSearch v4

DocSearch v5

Custom Ask AI API integrations

See also

​Migrate your assistant

​Update DocSearch

​DocSearch v4

​DocSearch v5

​Custom Ask AI API integrations

​See also

Migrate your assistant

Update DocSearch

DocSearch v4

DocSearch v5

Custom Ask AI API integrations

See also