> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raptora.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Агентын ажиллагаа
> Дуудлага, чат бүрт agent алхам алхмаар юу хийснийг харна.
Agent буруу хариулсан, удаан хариулсан, хэрэгсэл ажиллаагүй үед шалтгааныг эндээс олно.
> [!NOTE]
>
> Зөвхөн Эзэмшигч, Админ үзнэ. Ажиллагааг 30 хоног хадгална.
Дуудлага эсвэл чатын «Ажиллагаа» табаас ч мөн нээгдэнэ. «Ярианы тэмдэглэл» юу ярьсныг, «Ажиллагаа» agent юу хийснийг харуулна.
## Хайх, шүүх
| Шүүлтүүр | Сонголт |
| - | - |
| Хайх | Дуудлага, чат эсвэл trace ID |
| Хугацаа | Сүүлийн 1 цаг, 24 цаг, 7 хоног (анхдагч), 30 хоног |
| Agent | Бүх agent эсвэл нэг agent |
| Төлөв | Явагдаж байна, Дууссан, Алдаатай, Цуцлагдсан |
| Суваг | Бүгд, Дуудлага, Чат |
## Нэг ажиллагаа нээх
Жагсаалтаас нэг мөр дарна. Дээд хэсэгт Суваг, Хугацаа, Ээлжийн тоо, Token (орсон / гарсан), Алдаатай span-ийн тоо гарна.
Доор ээлж бүрийн алхмууд цагийн дарааллаар харагдана: харилцагчийн яриаг таньсан (STT), модел шийдсэн (LLM), хэрэгсэл дуудсан (Tool) эсвэл мэдлэгийн сангаас хайсан (Retrieval), хариуг уншсан (TTS). Баганын урт нь тухайн алхам хэр удсаныг харуулна. Алхам дээр дарахад баруун талд Input, Output гарна.
```mermaid theme={null}
flowchart LR
S[STT
яриа → текст] --> L[LLM
шийдвэр]
L -->|хэрэгтэй бол| T[Tool / Retrieval]
T --> L2[LLM
хариу]
L --> V[TTS
текст → дуу]
L2 --> V
```
| Харах хэлбэр | Юуг харуулах вэ |
| - | - |
| Ээлжүүд | Ээлж бүрт хэрэглэгч юу хэлж, agent юу хариулсан. STT, LLM, TTS алхмууд, тэдний хоорондох хүлээлт |
| Хугацааны шугам | Бүх алхам цагийн дарааллаар. «Бүгдийг дэлгэх», «Бүгдийг хураах» |
Ээлж дээр «STT ирээгүй», «Яриа танигдаагүй», «Хариулж чадаагүй» гэж гарвал тэр алхам дутуу эсвэл амжилтгүй болсон.
## Span-ийн төрлүүд
Span нь agent-ын хийсэн нэг алхам.
| Span | Утга |
| - | - |
| Conversation | Нэг дуудлага эсвэл чатын бүх алхам |
| Turn | Нэг асуулт, түүнд өгсөн хариу |
| Agent | Agent хариугаа бэлтгэсэн |
| STT | Хэрэглэгчийн яриаг текст болгосон |
| LLM | Модел юу хариулахаа шийдсэн |
| Tool | Agent хэрэгсэл дуудсан |
| Retrieval | Мэдлэгийн сангаас хайсан |
| TTS | Хариуг дуу болгож уншсан |
| Internal | Системийн дотоод алхам |
STT, TTS зөвхөн дуудлагад байна.
Span дээр дарахад үргэлжилсэн хугацаа, Input, Output (LLM дээр System, User, Assistant мессежүүд), Attributes, Events харагдана. «Span ID хуулах», «Trace ID хуулах» товч Raptora-гийн дэмжлэгт хандахад хэрэгтэй.
| Хугацаа | Утга |
| - | - |
| TTFT (LLM) | LLM-ийн эхний token хүртэл |
| TTFB (STT) | STT-ийн эхний текст хүртэл |
| TTFB (TTS) | TTS-ийн эхний дуу хүртэл |
## Асуудал олох
> [accordion] Agent удаан хариулсан
>
> «Ээлжүүд»-ээс удаан ээлжийг олоод аль алхам урт байгааг харна.
>
> * **LLM урт, TTFT өндөр:** заавар хэт урт байж магадгүй. Товчилно.
> * **Tool урт:** танай API удаан хариулж байна.
> * **Retrieval урт:** давтагдвал Trace ID-тай нь Raptora-д мэдэгдэнэ.
> * **TTS TTFB өндөр:** хариу хэт урт. Зааварт «1-2 өгүүлбэрээр хариул» гэж бичнэ.
> [accordion] Agent буруу хариулсан
>
> 1. STT-ийн Output: харилцагчийн хэлснийг зөв сонссон уу.
> 2. Retrieval: мэдлэгийн сангаас юу олсон. Буруу эсвэл хоосон бол [баримтаа](https://docs.raptora.io/agent/knowledge-base.md) засна.
> 3. LLM-ийн Input: agent ямар заавар, мэдээлэлтэй хариулсан.
> 4. Tool-ийн Output: API юу буцаасан.
> [accordion] Хэрэгсэл ажиллаагүй
>
> «Алдаатай» Tool span-ийн Output, Attributes-аас алдааг харна. Ихэвчлэн URL буруу, нэвтрэх түлхүүр хүчингүй, эсвэл заавал параметр дутуу. [Хэрэгсэл](https://docs.raptora.io/integrations/tools.md) хуудаснаас ижил утгаар туршина.
> [!NOTE]
>
> Энэ хуудас зөвхөн харах зориулалттай. 30 хоногоос хуучин ажиллагаа олдохгүй.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.