> ## 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-ը կամ չատ-էջը. գործում են գործակալի համակարգային հրահանգը, գիտելիքների բազան, գործիքները և երկխոսության պատմությունը, իսկ պատասխանները վճարվում են սեփականատիրոջ հաշվեկշռից նույն կերպ:

## Ինչ է անում 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="/am/guides/streaming">
    Նույն հարցումն է, բայց պատասխանը գալիս է թոքեն առ թոքեն՝ server-sent events-ի տեսքով:
  </Card>

  <Card title="Խոսակցություններ" icon="comments" href="/am/guides/conversations">
    Ստացեք ձեր բանալու խոսակցությունների ցանկը և էջ առ էջ կարդացեք դրանց հաղորդագրությունները:
  </Card>

  <Card title="Արագ մեկնարկ" icon="rocket" href="/am/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`՝ վերջնական օգտատիրոջ կայուն նույնացուցիչը ձեր կողմում: Նույն արտաքին օգտատիրոջ յուրաքանչյուր հաղորդագրություն նույն բանալիով շարունակում է նույն խոսակցությունը; մեկ այլ բանալի, նույնիսկ նույն գործակալի համար, ունի իր առանձին պատմությունը: Տե՛ս [Խոսակցություններ](/am/guides/conversations):

<Note>
  Այս թողարկումը միայն տեքստային է. հաղորդագրությունը տող է, և կցորդներ չեն ընդունվում: Յուրաքանչյուր պատասխան պարունակում է `X-Request-ID` վերնագիր; նշեք այն, երբ հայտնում եք խնդրի մասին:
</Note>