> For the complete documentation index, see [llms.txt](https://docs.spara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spara.com/guides/platform-guides/building-an-agent.md).
# Building Your First Agent
An **Agent** in Spara solves a complete business problem by coordinating [https://docs.spara.com/agents/capabilities](https://docs.spara.com/agents/capabilities "mention") (the channels it engages buyers through) and [https://docs.spara.com/agents/workflows](https://docs.spara.com/agents/workflows "mention") (the automated sequences it runs). This guide walks through assembling one from the [**Agents**](https://app.spara.co/agents) page. For background on the model, see [https://docs.spara.com/agents](https://docs.spara.com/agents "mention").
An Agent's detail page: its Goal, capabilities grouped by trigger, and workflows.
{% stepper %}
{% step %}
### Set the Goal
Open an Agent and give it a **Name** and a **Goal**. The Goal is a short, plain-language description of the business outcome the Agent is responsible for, for example "Qualify inbound leads from paid traffic and book them into a demo." Everything you add to the Agent should serve that Goal.
{% endstep %}
{% step %}
### Add capabilities
Click **Add capability** and choose a channel:
* **Chat**: a website chat experience ([https://docs.spara.com/agents/capabilities/chat/spara-navigator](https://docs.spara.com/agents/capabilities/chat/spara-navigator "mention"), [https://docs.spara.com/agents/capabilities/chat/spara-smartbar](https://docs.spara.com/agents/capabilities/chat/spara-smartbar "mention"), or [https://docs.spara.com/agents/capabilities/chat/spara-fullscreen](https://docs.spara.com/agents/capabilities/chat/spara-fullscreen "mention"))
* **Email**: automated replies and outreach cadences
* **Phone**: incoming and outgoing AI phone calls
* **SMS**: text-message conversations
* **Product Demo**: a live, voice-narrated product walkthrough
Each capability opens in its own editor, where you configure its instructions, abilities, and trigger. See [https://docs.spara.com/agents/capabilities/configuring](https://docs.spara.com/agents/capabilities/configuring "mention").
Capabilities are listed by channel and grouped by their **trigger**, the condition that activates them. Chat capabilities are grouped by the page they appear on, Phone and SMS by their phone number, and Email by the address they reply from. Grouping by trigger is also how [https://docs.spara.com/agents/capabilities/configuring/a-b-testing](https://docs.spara.com/agents/capabilities/configuring/a-b-testing "mention") are organized: variants that share a trigger split that trigger's traffic.
{% endstep %}
{% step %}
### Add workflows
Click **Add workflow** to build an automated sequence the Agent runs in the background, for example "After a lead submits the demo form, send an email, wait a day, then place a follow-up call." Workflows are made of [https://docs.spara.com/agents/workflows/steps](https://docs.spara.com/agents/workflows/steps "mention") and appear in their own section of the Agent, separate from capabilities. See [https://docs.spara.com/agents/workflows/configuring](https://docs.spara.com/agents/workflows/configuring "mention") for the editor and settings.
{% endstep %}
{% step %}
### Publish
Capabilities and workflows each have a private draft and a published version. Leads only ever interact with the published version. Edit and [https://docs.spara.com/agents/capabilities/configuring/testing](https://docs.spara.com/agents/capabilities/configuring/testing "mention") freely, then publish when you're ready. See [https://docs.spara.com/agents/capabilities/configuring/saving-and-publishing](https://docs.spara.com/agents/capabilities/configuring/saving-and-publishing "mention").
{% endstep %}
{% endstepper %}
## FAQ
### Does an Agent need both capabilities and workflows?
No. Many Agents start with a single capability (a Chat capability on your homepage, say) and add more over time. Workflows are optional and used when you need automated, time-based follow-up.
### How many capabilities can one Agent have?
There's no fixed limit. Add a capability for each channel and trigger the Agent needs to cover. Keep them aligned to the Agent's Goal; unrelated work belongs in a separate Agent.
### How do I move a capability or workflow to a different Agent?
Use the capability or workflow's menu and choose **Move to Agent**, then pick the destination Agent.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.spara.com/guides/platform-guides/building-an-agent.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.