- Go to Agents in the sidebar.
- Click New Agent.
- Fill in the form.
Required fields
| Field | Notes |
|---|---|
| Name | Short label — shown in chat and conversation history |
| Type | Assistant (general-purpose) or Specialist (narrower, task-focused) |
| Status | Active to enable chat; Disabled to park it |
| Model | See Models. Defaults to Claude Sonnet 4.6. |
System prompt
Open the System Prompt section to customize behavior. Write in plain English — describe the agent’s role, tone, any rules, and what kind of output you want. If left blank, a sensible default per type is used.LLM settings
Advanced settings in the accordion — safe to leave at defaults for most cases:| Setting | Typical range | What it does |
|---|---|---|
| Temperature | 0 – 2 | Randomness. Lower = more deterministic |
| Max tokens | Varies by model | Cap on output length per turn |
| Top P | 0 – 1 | Nucleus sampling cutoff |
| Top K | Integer | Candidate token cap |
| Frequency penalty | -2 – 2 | Discourages repetition |
| Presence penalty | -2 – 2 | Encourages new topics |
| Max steps | Integer (default 5) | How many tool-call cycles the agent can run per turn |
| Max retries | Integer | Retries on provider errors |
Saving
Click Save. The agent is created immediately. Tool permissions default to the regular-user baseline — open the new agent’s detail page and visit the Tools tab to adjust. See Tool Permissions.Default agent
Each organization can have one default agent, marked with a badge in the list. The default agent is what ShingleAI suggests when you haven’t picked another one explicitly. To mark an agent as default, toggle the flag on its detail page.Next steps
Models
Available OpenRouter models
Tool permissions
Decide what the agent can do