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

# İnsan devri

> Asistandan firmae devretme — manuel ve otomatik tetikleyiciler.

İnsan devri, görüşmenin asistan kontrolünden çıkıp panel firmaünün eline geçmesidir. Hassas konular, şikayetler veya asistanın emin olamadığı durumlar için kritiktir.

## Devir tetikleyicileri

```mermaid theme={null}
flowchart TB
    M[Yeni mesaj] --> C{Tetikleyici?}
    C -->|Asistan kendi kararı<br/>trigger_support_handoff| D1[Asistan kendi devreder]
    C -->|Firma panel butonu| D2[Manuel devir]
    C -->|API call| D3[Programatik devir]
    D1 --> S[Asistan kapatıldı<br/>insan bekleniyor]
    D2 --> S
    D3 --> S
    S --> N[Firmae bildirim]
```

### Asistanın kendi devri

Asistanın kullanabildiği tool'lardan biri **`trigger_support_handoff`**'tur. Asistan, hastanın açıkça insana aktarılma talebi varsa (örn. "müdürle konuşmak istiyorum", "şikayetim var", karmaşık/hassas bir konu) bu tool'u çağırır ve görüşme insan yönetimine geçer.

<Note>
  Devir kararı **asistanın kendi yargısıdır** — panelden ayarlanabilir bir "anahtar kelime listesi" yoktur. Asistanın tonu ve devir eşiği [Asistan ayarları](/documentation/conversations/assistant-settings) üzerinden, prompt + tool tanımı ile şekillendirilir.
</Note>

### Manuel devir

Firma panelde sohbet ekranındaki **"Asistanı kapat"** butonuna basar. Görüşmede `agent_disabled = true` olur.

### Programatik devir

Kendi sisteminizden API üzerinden:

```bash theme={null}
POST /v1/conversations/{id}/agent/disable
```

Detay: [API: AI asistan kontrolü](/guides/ai-agent-control).

## Devir sonrası

| Aşama            | Davranış                                                  |
| ---------------- | --------------------------------------------------------- |
| `agent_disabled` | `true` olur, `agent_disabled_by` firma veya `system` olur |
| Gelen mesaj      | Asistan **yanıt vermez**                                  |
| Bildirim         | Firmae realtime + sesli bildirim                          |
| Mesajlaşma       | Firma manuel yazar                                        |
| Durum okuma      | `GET /conversations/{id}/agent` ile durum                 |
| Geri açma        | Firma butonla veya `POST .../agent/enable`                |

## Geri açma — manuel ve zamanlanmış

Conversation modelinde `agent_expires_at` alanı vardır. Asistan belirli süre sonra **otomatik tekrar aktive** edilecek şekilde de kapatılabilir; süre dolduğunda asistan devreye girer. Firma süre beklemeden de manuel açabilir.

## Sık yapılan hatalar

<Warning>
  **Devirden sonra mesaj unutulursa hasta yanıtsız kalır.** Firmalere kuyruktaki insan-yönetimindeki görüşmeleri gösteren ayrı bir filtre/panel tutun.
</Warning>

* Asistanı kapatıp kapatmadığını **görüşmeden görüşmeye** kontrol edin — başka kanaldaki görüşmede hâlâ açık olabilir.
* Toplu kapatmak (örn. iş saati dışında) yerine **kanal/firma varsayılanını** değiştirmek daha sürdürülebilir.
* "Asistanı kapat" sadece **otomatik yanıtı** durdurur; geçmiş yanıtları silmez.

## API tarafı

Programatik kontrol detayları: [API rehberi: AI Asistan kontrolü](/guides/ai-agent-control).
