Skip to main content

How to use prompts in Copilot

Prompts are reusable message templates. Use them for complex or repetitive tasks so you don't have to retype the same instructions every time.

Invoke a prompt from the chat input​

  1. Open Copilot.
  2. In the input field, type / followed by part of the prompt's code. An autocomplete list appears with matching prompts.
  3. Pick one with the arrow keys + Enter, or click it.

What happens next depends on the prompt:

  • Prompts without arguments fire immediately. The chat shows the prompt's title, not the full template text.
  • Prompts with arguments switch the input into argument-entry mode — each argument gets its own field. Fill the required ones, press Enter to send, or Escape to cancel.

Feature prompts on the welcome screen​

If you often use the same handful of prompts, put them as clickable cards on the welcome screen so your team can reach them in one click.

  1. Make sure your role has the Widget Configuration permission.
  2. Open Copilot, go to the welcome screen, and click the gear icon.
  3. Switch to the Welcome tab in the configuration panel.
  4. Scroll to the Prompts section and check Show prompts on welcome screen.
  5. Use the search box to find the prompts you want. Click a prompt row to toggle it. Selected prompts appear in the order you picked them.
  6. Click Save.

Selected prompts now render as clickable cards above the default questions on every Copilot welcome screen for this store. Clicking a card behaves the same as invoking the prompt via / — argument-free prompts fire immediately, prompts with arguments open the input in argument-entry mode.

tip

Prompts marked with a needs input tag in the selection list require arguments. They still work as welcome-screen cards, but clicking them moves the admin to the chat input to fill the arguments — it does not fire an empty prompt.

Create a new prompt​

Prompts are managed at Stores → Configuration → Mirasvit Extensions → AI Copilot → Slash Commands → Configure Slash Commands. The button opens the Prompts grid, shared with the AI Agent Connector extension — any prompt you create there becomes available in both Copilot and any connected external AI clients.

For the full reference and authoring guidance, see:

  • Prompts — form fields, arguments, dependencies, validation, REST API.
  • Create effective prompts — patterns for reliable prompts, argument design, multi-step workflows.

Any prompt you create immediately becomes available in Copilot's slash autocomplete and in the welcome-screen selector.

Who can see which prompts​

Prompts can declare Required tools. When Copilot builds the prompt list, it checks whether the currently authenticated admin has access to those tools. If any required tool is unavailable — because of ACL restrictions or a disabled source module — the prompt is hidden from that admin's slash autocomplete and from the welcome-screen selector.

This means you can confidently feature prompts that use the REST API or Database Reader: admins without those tools won't see them at all.