Agents are the core of ToeBox. Each agent is an AI-powered assistant configured for a specific task on your Shopify store.Documentation Index
Fetch the complete documentation index at: https://docs.toebox.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Agent types
When creating an agent, you select a type that pre-configures recommended tools and system prompts:| Type | Best for |
|---|---|
| Customer Support | Answering product questions, handling inquiries |
| Product Recommendation | Helping shoppers find the right products |
| Order Management | Order status, tracking, modifications |
| Marketing | Campaign copy, promotions, product descriptions |
| Inventory Management | Stock levels, restocking alerts |
| Returns & Exchanges | Processing returns, exchange policies |
| Shipping & Fulfillment | Shipping rates, delivery estimates |
| Loyalty & Rewards | Points programs, reward redemption |
| Content & SEO | Product descriptions, meta tags, blog content |
| Sales Assistant | Guided selling, upselling, cross-selling |
| Analytics & Reporting | Data insights, report generation |
| Custom | Build from scratch with no defaults |
Creating an agent
Configure basic settings
- Name — A descriptive name for your agent (e.g., “Product Finder Bot”).
- Type — Select from the list above. This pre-selects recommended MCP tools.
- Description (optional) — A short summary of what this agent does.
Choose a model
Select the AI model that powers your agent. Available models include:Anthropic (Direct)
- Claude Sonnet 4.6 — Fast, capable. Best for most agent tasks.
- Claude Haiku 4.5 — Fastest and cheapest. Good for simple lookups.
- Claude Opus 4.6 — Most capable. Best for complex orchestration.
- GPT-4o, GPT-4.1, GPT-4.1 Mini (OpenAI)
- Gemini 2.5 Flash, Gemini 2.5 Pro (Google)
- Llama 4 Scout (Meta, free tier)
- DeepSeek V3 (free tier)
- Claude Sonnet 4.6 (Bedrock)
- Claude Haiku 4.5 (Bedrock)
Write a system prompt
The system prompt defines your agent’s personality, tone, and behavior. Each agent type generates a sensible default, but you can customize it.A good system prompt includes:
- The agent’s role and persona
- What it should and should not do
- Tone of voice (friendly, professional, casual)
- Any store-specific policies (return windows, shipping thresholds)
Adjust advanced settings
- Temperature (0.0 - 1.0) — Controls randomness. Lower values produce more focused responses. Default: 0.7.
- Max Tokens — Maximum response length. Default: 4096.
- Timeout — How long to wait for a response. Default: 30 seconds.
- Max Retries — Number of retry attempts on failure. Default: 3.
Agent knowledge base
You can upload files to give your agent additional context. Supported file types include PDF, TXT, CSV, and Markdown. Uploaded files are parsed and made available to the agent during conversations.Knowledge base files are stored securely and are only accessible to your agent. They are not shared across agents.
Editing and deleting agents
- Click an agent card to edit its configuration at any time.
- Delete an agent by clicking the delete icon on the agent card. This action is permanent.
- If an agent is linked to a chatbot, you must update the chatbot configuration before deleting the agent.