PushizoDocs

Özel AI ajanları

Kendi talimatınızla çalışan, izin verdiğiniz araçlarla segmentleri ve kampanya sonuçlarını inceleyen ve onayınız için taslak hazırlayan ajanlar. Zamanlanmış (cron) veya elle çalışır. Growth ve üzeri planlarda,…

Kendi talimatınızla çalışan, izin verdiğiniz araçlarla segmentleri ve kampanya sonuçlarını inceleyen ve onayınız için taslak hazırlayan ajanlar. Zamanlanmış (cron) veya elle çalışır. Growth ve üzeri planlarda, organizasyonda AI asistanı açıkken kullanılır (ADR-0089).

Güvenlik sınırı

  • Ajanın gönderim, zamanlama, yayın veya onay aracı yoktur. Model katalog dışı bir araç (ör. send_campaign) isterse çağrı yapılmaz ve çalışma kaydında unknown_tool olarak görünür; izin verilmeyen katalog aracı not_allowed.
  • Yazma araçları yalnızca taslak üretir. Taslağı bir kişi panelde uygular: segment taslağı segment, kampanya taslağı taslak durumunda kampanya olur. Taslak kampanya her zamanki yayın öncesi denetim ve onay akışından geçer.
  • Okuma araçları yalnızca toplu sayıları döndürür (kişi kimliği, e-posta, telefon yok). Araç argümanları ve sonuçları kaydedilmez.
  • Taslak metinleri ve özet yasaklı ifade denetiminden geçer.

Araçlar

AraçTürAçıklama
list_segmentsokumaSegment adları ve tahmini büyüklükleri (en çok 25).
campaign_performanceokumaSon 7/30/90 günde çalışan kampanyaların gönderim, teslim, açılma, tıklama, dönüşüm sayıları.
delivery_summaryokumaSon 1–30 günde kanala ve duruma göre teslimat sayıları.
create_segment_drafttaslakSabit kural listesinden segment önerisi: clicked_7d, not_opened_7d, inactive_30d, event_7d.
create_campaign_drafttaslakPush kampanya metni (başlık ≤ 65, gövde ≤ 240); kitle mevcut segmentler veya aynı çalışmanın segment taslağı.

Çalıştırma başına en çok 5 taslak yazılır.

Kurulum

Panel → Kampanyalar → Özel AI ajanları → Ajan oluştur.

AlanAçıklama
TalimatGörev ve sınırlar (en çok 4000 karakter).
İzinli araçlarYukarıdaki katalogdan seçim.
Zamanlama5 alanlı cron ve saat dilimi (boşsa app saat dilimi); en sık saatte bir. Boşsa yalnızca elle çalışır.
SınırlarÇalıştırma başına adım (varsayılan 6, en çok 10) ve aylık token tavanı (varsayılan 200.000).

Zamanlanmış çalıştırma yalnızca ajan açıkken işler; Şimdi çalıştır kapalı ajanda da denenebilir.

Çalıştırma ve kayıt

Worker zamanlayıcısı 5 dakikada bir zamanı gelen ajanları üstlenir ve custom-agent kuyruğuna ekler; AI sağlayıcısı API sürecinde olduğundan iş API'deki tüketicide işlenir. Aynı ajanın bekleyen veya süren çalıştırması varken yenisi açılmaz. Çalışma kaydı durumları: pending, running, succeeded, failed, skipped (AI kapalı, kota/kredi dolu, plan özelliği yok veya aylık token tavanı aşıldı).

API

curl -X POST "https://api.pushizo.com/v1/apps/$APP_ID/custom-agents" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Haftalık analist","enabled":true,"instructions":"Geçen haftanın kampanyalarını incele ve bir geri kazanım kampanyası taslağı hazırla.","tools":["list_segments","campaign_performance","create_segment_draft","create_campaign_draft"],"schedule":{"cron":"0 9 * * 1","timezone":"Europe/Istanbul"}}'

Okuma uçları (GET .../custom-agents, .../runs, .../drafts) analytics:read, yazma ve POST .../{id}/run admin kapsamı ister. Taslak uygulama ve reddetme yalnızca panel oturumunda yapılır. Node SDK: hs.customAgents.

Bu sayfada