Using the AI Agent
Chat with the built-in AI assistant to manage your store using natural language.
The AI Agent is a streaming chat assistant built into the admin. Ask it to look up data, draft content, or perform actions — it confirms before making changes.
Where to find it
Click the Agent button (Sparkles icon) in the topbar, or press Cmd+K (Mac) / Ctrl+K (Windows). The agent opens as a right-side sheet with a conversation list sidebar and chat.
How it works
The agent streams responses token-by-token using the AI SDK. It understands your shop context — the active shop and the page you're on (pageContext) — so questions like "summarize my recent orders" are grounded in your real data.
Tool use & confirmation
The agent can take actions via tools. When it wants to perform a mutating action (like updating an order or creating a product), it presents a confirmation card. You approve or reject before anything changes — a human-in-the-loop safety mechanism.
Try these prompts
Conversations
Conversations are saved per user and shop. The conversation list shows past chats; open one to continue, rename it, or delete it. Messages persist so you can resume a task later.
Rate limits
The agent chat endpoint is rate-limited to 120 messages per minute, and the action confirmation endpoint to 60 per minute. These limits keep the service responsive for all users.
/agent/chat/agent/confirm/agent/conversations/agent/conversations/:id/agent/conversations/:id/agent/conversations/:id