Generate prompt suggestions for your pages

​

Before you begin

• You need an Algolia application with the Agent Studio feature enabled.
• To preview PDP or PLP configurations, you need an agent with an Algolia Search tool connected to an index.

​

Create a prompt configuration

1

Open the prompt configurations list

In the Agent Studio dashboard, open your agent, go to the Components section, and select the Prompt suggestions component.

2

Create a configuration

Select Create and fill in:

• Name. An internal label. It’s not used in the integration.
• Context mode. The page context the agent uses to generate suggestions.
• Goal. What the generated suggestions should help users do.

Context mode	Suggestions are generated from
PDP (Single record)	A single record in focus on the page, such as a product detail page
PLP (Search results)	The current query, filters, and visible search results
Custom	A context payload your integration defines, such as a guide page

3

Choose a goal

Pick one of the built-in goals, such as comparing options or narrowing results, or select Custom and write your own instructions.Choosing a goal replaces the Instructions text. Editing the instructions switches the goal to Custom.

​

Configure the generated suggestions

• Number of suggestions. The number of suggestion chips to generate.
• Maximum words per suggestion. Keeps chips short enough to scan.
• Provider override and Model override. Leave as Agent default to use the agent’s provider and model.
• Base system prompt. The prompt sent to the model. It’s updated from the number of suggestions and maximum words. Select Customize to edit it.

​

Preview suggestions

• PDP. Select an index and search for a record.
• PLP. Select an index and enter a preview query.
• Custom. Enter a JSON context payload of 64 KiB or less.

​

Enable and integrate a configuration

<PromptSuggestions
  agentId="AGENT_ID"
  configurationId="CONFIGURATION_ID"
/>

promptSuggestions({
  container: '#prompt-suggestions',
  agentId: 'AGENT_ID',
  configurationId: 'CONFIGURATION_ID',
});

​

Manage configurations

• Search configurations by name and filter them by context mode.
• Duplicate a configuration to use it as a starting point.
• Delete a configuration. Disable it first: you can’t delete an enabled configuration.