> ## 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 агентына API ачкычы белән HTTPS аша мөрәҗәгать итеп була. API аша килгән сорау Telegram, WhatsApp яки чат-бит белән бер үк эшләү мохитендә үтәлә: агентның система промпты, белем базасы, кораллары һәм диалог тарихы барысы да кулланыла, ә җаваплар хуҗаның балансыннан шул ук рәвешчә түләнә.

## 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="/tt/guides/streaming">
    Шул ук сорау, әмма җавап токен арты токен server-sent events рәвешендә килә.
  </Card>

  <Card title="Диалоглар" icon="comments" href="/tt/guides/conversations">
    Ачкычыгызның диалоглары исемлеген алыгыз һәм аларның хәбәрләрен битләп карагыз.
  </Card>

  <Card title="Тиз башлау" icon="rocket" href="/tt/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"}}`    |
| Сораулар лимиты | Һәр ачкычка 60 секундка 120 сорау                              |

Ачкыч нәкъ бер агентка карый. Аның рөхсәте я `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` — сезнең яктагы ахыргы кулланучының тотрыклы идентификаторы — күрсәтелә. Бер үк тышкы кулланучыдан бер үк ачкыч аша килгән һәр хәбәр шул ук диалогны дәвам итә; башка ачкычның, хәтта шул ук агент өчен булса да, үз аерым тарихы бар. [Диалоглар](/tt/guides/conversations) битен карагыз.

<Note>
  Бу чыгарылыш текст белән генә эшли: хәбәр — юл (string), кушымталар кабул ителми. Һәр җавапта `X-Request-ID` башламы бар; проблема турында хәбәр иткәндә аны күрсәтегез.
</Note>