Skip to content

Creating Agents

Agents are the backbone of Sprigr Team. Each agent is a specialist that handles a specific area of your business — answering customer questions, managing schedules, processing requests, or coordinating between departments. This guide walks you through creating your first agent and setting it up for success.

When you open the Agents page at team.sprigr.com, you will see two distinct sections:

  • YOUR AI — This section displays your personal companion agent. Every user gets one automatically. Think of it as your personal assistant within Sprigr Team.
  • AGENTS — The agents you can work with. Owners and admins see every agent in the organisation; other team members see the agents they have been assigned to. If your organisation uses agent teams, the list is grouped by team, with an “Other agents” group for agents not in a team. Each agent appears as a card with its name, status, role, and connected channels.

Every agent has a type that determines who can talk to it and how it is managed:

  • Companion — A personal agent paired one-to-one with a user. Automatically provisioned for every team member.
  • Shared agent — An organisation agent. Owners and admins can open and chat with any shared agent; other team members can use the ones they have been assigned to (see Assigned Users on the agent’s settings page). Most agents you create are this type.
  1. Click “New Agent”

    From the Agents page, click the New Agent button. This opens the Create New Agent form.

  2. Enter an agent name

    Give your agent a clear, descriptive name that reflects its purpose. For example, “Customer Support Agent”, “Bookings Assistant”, or “HR Helper”. Team members will see this name when they interact with the agent.

  3. Select a role

    Choose the agent’s role within your organisation:

    • Member — Standard access. The agent can use its assigned tools, search knowledge bases, and communicate with other agents it has been connected to.
    • Owner — Elevated access. The agent skips your approval policies for most actions (it still cannot create agents or change policies on its own) and can read your organisation’s admin and escalation data. Use this sparingly, for orchestrator agents that genuinely need it. The Owner option only appears if you are an owner or admin yourself.
  4. Choose a performance tier

    Select the tier that best matches what this agent needs to do:

    • Auto (Sprigr’s recommended model, currently Balanced) — The default. The agent runs on the model Sprigr currently recommends, which today is the Balanced model, for every message. Pick one of the tiers below if you want to fix the model yourself.
    • Fast — quick & affordable — Optimised for quick, straightforward responses. Best for simple Q&A, greetings, and routine lookups.
    • Balanced — best all-round — A good all-rounder for most tasks. Handles multi-step reasoning, document searches, and standard business workflows.
    • Advanced — most capable — Maximum reasoning capability. Use this for agents that need to handle complex analysis, nuanced decision-making, or multi-tool workflows.
  5. Write a persona

    The Persona / Instructions field tells the agent who it is, how it should behave, and what it should focus on. It is optional at creation time (you can add it later from the agent’s settings), but it is the most important part of a well-behaved agent — see the section below for tips. Personas are capped at 24,000 characters; keep it concise, since it is replayed on every turn, and move bulk reference material into a knowledge base instead.

  6. Click “Create Agent”

    Hit Create Agent. You are taken to the new agent’s settings page, where its status shows provisioning for a moment and then active. If your plan’s agent limit has been reached, the form shows an error instead; remove an agent or upgrade your plan to add another.

The persona is the instruction set your agent follows in every conversation. A well-written persona dramatically improves the quality of responses.

Here is an example of a strong persona:

You are the front-desk assistant for GreenLeaf Landscaping. You help customers book consultations, answer questions about our services (lawn care, garden design, tree removal), and provide basic pricing from the price list in shared knowledge. You are friendly, professional, and always confirm details before booking. If a customer has a complaint, empathise first, then escalate to the Operations Manager agent.

Agents can delegate work to each other by name (for example, in a persona: “if the amount is over $500, ask the Finance Agent to approve”). Sprigr Team ignores capitalisation in agent names and treats spaces, dashes and underscores as the same — Root Cause Engineer, root-cause-engineer, and ROOT_CAUSE_ENGINEER all resolve to the same agent. Name matching uses the agent’s current name. If you rename an agent, update any personas or instructions that mention it by its old name.

Once created, each agent appears as a card on the Agents page. Cards display several useful details at a glance:

  • Status — A status dot and label next to the agent’s name showing whether the agent is active (ready to respond), provisioning (still being set up), or suspended (temporarily disabled).
  • Role — The agent’s role (member or owner) appears under its name so you can quickly see each agent’s access level.
  • Companion badge — Companion agents carry a “Companion” pill so they stand out from shared agents.
  • Message count — How many messages the agent received in the last 7 days (shown as msgs/wk), so you can see at a glance which agents are busy.
  • Footer — The first person assigned to the agent (or its model tier if nobody is assigned) and an Open link to its detail page.

Each card also has a menu with Open chat and Settings. Owners and admins also get Pause (or Resume) and Delete, except on a companion agent’s card, which has no Delete. Delete asks you to confirm, then permanently deletes the agent and all its data, exactly like Delete Agent on the settings page. Use Pause if you only want to stop it for a while.

Now that your agent is created, here is what to do next:

  • Agent Settings — Fine-tune your agent’s persona, directives, performance tier, integrations, and more.
  • Agent Teams — Add your agent to a team so it can collaborate with other agents.
  • Tools Reference — See what tools are available for your agent to use.
  • Knowledge Bases — Give your agent access to company documents and data so it can answer questions accurately.
  • Channels — Connect your agent to Slack, WhatsApp, Telegram, or your website so customers and staff can reach it.