# Description in natural language

## Overview

The **description** is the heart of your agent: it's the text you write in the chat to express your intent. From this description, Obside:

* Rephrases your request to verify correct understanding.
* Selects the relevant assets.
* Activates the necessary capabilities (trading, notifications, AI, news).
* Generates the code that formalizes your intent.

{% hint style="info" %}
The description and the code of the agent are accessible at any time in the **Description** and **Code** tabs of the agent's page. You can iterate on the description through the linked chat to fine-tune the behavior.
{% endhint %}

***

## How to write a good description

Obside's AI understands a very wide range of phrasings, but a **smooth and logical syntax** maximizes interpretation efficiency. Well-structured, clearly punctuated sentences reduce the risk of error.

{% hint style="danger" %}
The AI is not a magical technology that's supposed to guess what hasn't been explicitly stated. An omission or an unspecified inference can result in a partial or incorrect interpretation of your request.
{% endhint %}

{% hint style="success" %}
A good way to write a clear description is to ask yourself:

"If I were teaching my strategy to someone else using only this description, would they understand everything or would they have questions on unclear aspects?".

This approach helps you maximize the precision of your request.
{% endhint %}

***

## What you can express

Depending on the type of agent you want to create, your description can include:

* **For a scheduled trade** — what to buy/sell, at what time, under what conditions.
* **For a trading bot** — entry rules, exit rules, risk management, target assets. See [Entry rules](/agents/create-an-agent/entry-rules.md) and [Exit rules](/agents/create-an-agent/exit-rules.md).
* **For an AI trader** — mandate, asset universe, risk constraints, style.
* **For an alert** — the condition to watch, the notification channel.
* **For monitoring** — the metrics or events to track on your portfolio.

***

## Iterating on your agent

Once your agent is created, you can **continue the conversation** in the chat linked to the agent to:

* Adjust a parameter (e.g. change the entry threshold).
* Add a condition (e.g. exclude certain hours).
* Modify risk management.
* Extend the agent to new assets.

The agent is **automatically updated** with each validated adjustment.


---

# 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.obside.com/agents/create-an-agent/description.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.