> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chattler.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Шарҳи умумӣ

> Бо ҳар агенти Chattler аз коди худ тавассути REST API-и хурд муошират кунед.

Ба ҳар агенти Chattler тавассути HTTPS бо калиди API дастрасӣ пайдо кардан мумкин аст. Дархост тавассути API ҳамон муҳити иҷроро мегузарад, ки Telegram, WhatsApp ё саҳифаи чат мегузаранд: system prompt-и агент, пойгоҳи дониш, абзорҳо ва таърихи муколама ҳама татбиқ мешаванд, ва ҷавобҳо ба ҳамон тарз аз баланси соҳиб пардохт мешаванд.

## API чӣ кор мекунад

<CardGroup cols={2}>
  <Card title="Чат" icon="message" href="/api-reference/public-api/send-a-message-to-the-agent-and-wait-for-the-reply">
    Як паёми корбарро фиристед ва ҷавоби агентро бо истифодаи токенҳо ва маблағи пардохтшуда гиред.
  </Card>

  <Card title="Ҷавоби ҷараёнӣ" icon="bolt" href="/tj/guides/streaming">
    Ҳамон дархост, аммо ҷавоб токен ба токен ҳамчун server-sent events мерасад.
  </Card>

  <Card title="Муколамаҳо" icon="comments" href="/tj/guides/conversations">
    Муколамаҳои калиди худро рӯйхат кунед ва паёмҳои онҳоро саҳифа ба саҳифа хонед.
  </Card>

  <Card title="Оғози зуд" icon="rocket" href="/tj/get-started/quickstart">
    Аввалин ҷавоб дар панҷ дақиқа бо curl, Python ё Node.
  </Card>
</CardGroup>

## Асосҳо

|                      |                                                                               |
| -------------------- | ----------------------------------------------------------------------------- |
| URL-и асосӣ          | `https://api.chattler.ai`                                                     |
| Префикси роҳ         | `/v1`                                                                         |
| Аутентификатсия      | `Authorization: Bearer cht_live_<key_id>.<secret>`                            |
| Формат               | JSON дар вуруд, JSON дар баромад; `text/event-stream` барои эндпоинти ҷараёнӣ |
| Хатоҳо               | Як конверт: `{"error": {"code", "message", "request_id"}}`                    |
| Маҳдудияти дархостҳо | 120 дархост дар 60 сония барои ҳар калид                                      |

Калид ба маҳз як агент тааллуқ дорад. Иҷозати он ё `read-only` (рӯйхати муколамаҳо ва хондани паёмҳо) ё `full` (илова бар ин, чат) аст.

## Эндпоинтҳо

| Метод  | Роҳ                                                              | Иҷозат               |
| ------ | ---------------------------------------------------------------- | -------------------- |
| `POST` | `/v1/agents/{agent_id}/chat`                                     | `full`               |
| `POST` | `/v1/agents/{agent_id}/chat/stream`                              | `full`               |
| `GET`  | `/v1/agents/{agent_id}/conversations`                            | `read-only` ё `full` |
| `GET`  | `/v1/agents/{agent_id}/conversations/{conversation_id}/messages` | `read-only` ё `full` |

## Муколамаҳо чӣ тавр кор мекунанд

Шумо муколамаҳоро намесозед. Ҳар дархости чат `external_user_id`-ро номбар мекунад, яъне идентификатори устувори корбари ниҳоӣ дар тарафи шумо. Ҳар паём аз ҳамон корбари беруна тавассути ҳамон калид ҳамон муколамаро идома медиҳад; калиди дигар, ҳатто барои ҳамон агент, таърихи алоҳидаи худро дорад. Ниг. [Муколамаҳо](/tj/guides/conversations).

<Note>
  Ин нашр танҳо матнӣ аст: паём сатр аст ва замимаҳо қабул намешаванд. Ҳар ҷавоб сарлавҳаи `X-Request-ID`-ро дорад; ҳангоми гузориш дар бораи мушкил онро иқтибос кунед.
</Note>