> For the complete documentation index, see [llms.txt](https://docs.tread.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tread.fi/agents/overview-and-getting-started.md).

# Overview and Getting Started

### What are Agents?

Agents are a chat-driven workspace on Tread where you hire an AI specialist to plan and run trades for you. Instead of manually filling in the order form and clicking buttons, you describe what you want in plain English ("work 500k of SOL on Binance over the next 2 hours, stay passive"), and the agent translates that into an order with the desired paramters.&#x20;

Each agent is a different specialist with its own personality and toolset:

* **Desk Trader** — Regular order execution.
* **Market Maker** — runs a market making bot on your behalf

**What agents can do:** read market data, place and manage orders on the accounts *you've explicitly whitelisted*, monitor positions, and respond to your follow-up instructions in chat.

**What agents can't do:** touch accounts you haven't whitelisted, move funds off the platform, override your existing  risk limits, or run forever silently.

> **Beta.** Agents is in beta. The first time you open it you'll be asked to accept the Beta Terms of Service. Expect occasional rough edges, and please send feedback.

***

### Whitelisting your Account

<figure><img src="/files/emampxk1yaWyXJmaoNcq" alt=""><figcaption></figcaption></figure>

&#x20;Open the Settings view and move at least one account into the *Whitelisted* column. Without this, agents have no account to trade on. This also prevents agents from touching any accounts you do not permit it to.&#x20;


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.tread.fi/agents/overview-and-getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
