# Chat agent onboarding

This page is a guide to getting started with Spara Chat agents.

### Step 1: Install AI Chat

Deploying AI Chat requires installing a Javascript snippet on your webpages. This should take a web engineer 5-15 minutes. After choosing which Chat interfaces you'd like to deploy, follow the installation guides listed above.

Spara Chat is designed to be deployed to your marketing website. Spara offers three different interfaces:

* [Installing Spara Navigator](/guides/installation-guides/readme/installing-spara-navigator.md)
* [Installing Smartbar](/guides/installation-guides/readme/installing-smartbar.md)
* [Installing Spara Fullscreen](/guides/installation-guides/readme/installing-spara-fullscreen.md)

These interfaces work together. For example, a lead may start a conversation on your Pricing page using [https://docs.spara.com/agents/chat-agents/spara-navigator](https://docs.spara.com/agents/chat-agents/spara-navigator "mention"). That same conversation might continue when the lead returns 48 hours later and engages with [https://docs.spara.com/agents/chat-agents/spara-navigator](https://docs.spara.com/agents/chat-agents/spara-navigator "mention").

All interfaces rely on [https://docs.spara.com/developers/spara-api/query-parameters](https://docs.spara.com/developers/spara-api/query-parameters "mention") to ingest lead enrichment data. By supplying Spara with this information you ensure that Spara will a) not attempt to recapture this data, and b) may modify its behavior to better suit each conversation.

All interfaces also expose Spara events to your DOM via [https://docs.spara.com/developers/spara-api/javascript-api](https://docs.spara.com/developers/spara-api/javascript-api "mention").

### Step 2: Configure a Chat agent

1. Navigate to [Chat](https://app.spara.co/settings/chat). This page lists all of your Chat agents.
2. Click "Create New." This will create a new Chat agent and load its Agent Editor page.
   1. Alternatively, you may duplicate an existing Chat agent by clicking on its "three dots" dropdown menu.

Let's pause. The Agent Editor page is split into two panes. The left hand side is the Agent Instructions, often called a "prompt." These are instructions, written in plain English, that tell the agent how to behave in any situation.

The right hand side lets you toggle between Testing and Ask AI interfaces. Testing makes it easy to "pretend" to be your buyer so that you can verify your Chat agent is behaving as desired. It is side-by-side with the Agent Instructions on the left to make it easy to modify the agent's instructions as you test.

Ask AI is a chat-like interface to assist you in configuring your agent. You can ask it questions about your agent. Some actions in the Testing interface, such as clicking "thumbs down" for negative feedback, will open Ask AI to provide more information.

Resuming our instructions...

3. Your new Chat agent comes prefilled with Agent Instructions. Read through them and update the text to fit the exact behavior you want from your agent.
4. Run your first test by clicking "New Test" in the Testing interface. Try to break the bot!


---

# Agent Instructions: 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/installation-guides/readme.md?ask=<question>
```

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.
