PushizoDocs

Konuşmalı AI ajanı

WhatsApp, SMS, RCS ve canlı sohbette müşteriye otomatik yanıt veren, sizin sistemlerinize (sipariş durumu, randevu) danışan ve gerektiğinde konuşmayı temsilciye devreden ajan. Growth ve üzeri planlarda, organizasyonda…

WhatsApp, SMS, RCS ve canlı sohbette müşteriye otomatik yanıt veren, sizin sistemlerinize (sipariş durumu, randevu) danışan ve gerektiğinde konuşmayı temsilciye devreden ajan. Growth ve üzeri planlarda, organizasyonda AI asistanı açıkken çalışır (ADR-0085).

Nasıl çalışır

  1. Kanalda açık bir ajan varsa, atanmamış yeni konuşmayı ajan üstlenir (konuşma "bot" durumuna geçer, otomatik atama beklemeye alınır). STOP, START, HELP ve özel anahtar sözcük mesajları ajana gitmez.
  2. Her gelen mesajda ajan son mesajları okur ve bir karar verir: yanıt ver, araç çağır veya temsilciye devret. Araç sonucu bir sonraki adımda kullanılır; mesaj başına en çok 6 adım.
  3. Yanıt müşteriye konuşmanın kanalından gider ve gelen kutusunda "bot" göndericisiyle görünür.
  4. Temsilci konuşmaya yazdığı anda ajan durur. Devredilen konuşmaya ajan, konuşma çözülüp yeniden açılana kadar dönmez.

Kurulum

Panel → Gelen kutusu → AI ajanı → Ajan oluştur.

AlanAçıklama
Kanallarwhatsapp, sms, rcs, chat. Bir kanal aynı anda yalnızca bir açık ajana atanabilir.
TalimatTon, görev ve sınırlar (en çok 4000 karakter).
SSSEn çok 50 soru-yanıt. Ajan bilgi uydurmaz; yanıt yoksa devreder.
AraçlarEn çok 10 webhook aracı (aşağıda).
DevirDevir sözcükleri, konuşma başına en çok bot yanıtı, olumsuz duyguda devir, devir mesajı.
SınırlarAylık token tavanı (varsayılan 500.000) ve mesaj başına en çok adım (varsayılan 4).
AI duyguAçıksa ajanın işlediği konuşmalarda kişinin last_sentiment değeri AI kararıyla güncellenir.

API ile: POST /v1/apps/{app_id}/ai-agents (admin kapsamı). Okuma uçları users:read kapsamıyla çalışır.

Araçlar (webhook)

Ajan bir aracı çağırdığında Pushizo aracın adresine imzalı bir POST gönderir:

{
  "type": "ai_agent.tool_call",
  "tool": "order_status",
  "arguments": { "order_id": "SP12345" },
  "agent_id": "aia_…",
  "app_id": "app_…",
  "conversation": { "id": "cnv_…", "channel": "whatsapp", "language": "tr" },
  "user": { "id": "usr_…", "external_id": "musteri-42" }
}
  • Kişinin kimliği (user, conversation) modelden değil sunucudan eklenir; model kişisel veri görmez.
  • İstek Pushizo-Signature başlığıyla ajanın imza anahtarı kullanılarak imzalanır (webhook imzasıyla aynı biçim; doğrulama için webhook'lar). Anahtar yalnızca ajan oluşturulduğunda ve yenilendiğinde bir kez gösterilir.
  • Yalnızca https adresleri; özel ağ adresleri reddedilir, yönlendirme izlenmez, zaman aşımı 5 saniye, yanıt en çok 64 KB. 2xx dışındaki yanıt araç hatası sayılır ve konuşma temsilciye devredilir.
  • Yanıt gövdesi (JSON veya metin) kısaltılıp kişisel verisi maskelenerek modele verilir. Araç argümanları ve yanıtları çalışma kaydında saklanmaz.

Güvenlik ve gizlilik

  • Modele giden dökümde ad, e-posta, telefon, kimlik numarası ve bağlantılar maskelenir.
  • Yanıt metni organizasyonun yasaklı ifade listesinden geçer; eşleşirse gönderilmez, konuşma devredilir.
  • Ajan; müşteri temsilci isterse, devir sözcüğü geçerse, bot yanıt sınırına ulaşılırsa, olumsuz duygu (isteğe bağlı), araç hatası, AI kotasının dolması veya sağlayıcı hatasında devreder.
  • AI asistanı kapalıysa veya plan özelliği yoksa ajan çalışmaz; konuşmalar her zamanki gibi temsilcilere atanır.

Maliyet

Her karar adımı bir AI isteğidir ve organizasyonun AI kredisi ile token kotasından düşer (özellik adı agent). Ajanın aylık token tavanı dolunca ajan o ay yeni mesaj almaz, konuşma temsilciye devredilir (çalışma sonucu skipped_cap).

Kayıt ve ölçüm

  • GET /v1/apps/{app_id}/ai-agents/runs: gelen mesaj başına sonuç (replied, handed_off, skipped_cap, failed), adımlar (araç adı, HTTP durumu, süre), token ve devir nedeni.
  • GET /v1/apps/{app_id}/ai-agents/{agent_id}/metrics: son 30 gün yanıt, devir, devirsiz çözüm oranı, ortalama adım, araç hata oranı ve token.

Çalıştırma

Ajan işleri ai-agent kuyruğunda API süreçlerince işlenir. Bir API replikasında tüketiciyi kapatmak için AI_AGENT_CONSUMER=false.

Bu sayfada