Ö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ındaunknown_toololarak 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ür | Açıklama |
|---|---|---|
list_segments | okuma | Segment adları ve tahmini büyüklükleri (en çok 25). |
campaign_performance | okuma | Son 7/30/90 günde çalışan kampanyaların gönderim, teslim, açılma, tıklama, dönüşüm sayıları. |
delivery_summary | okuma | Son 1–30 günde kanala ve duruma göre teslimat sayıları. |
create_segment_draft | taslak | Sabit kural listesinden segment önerisi: clicked_7d, not_opened_7d, inactive_30d, event_7d. |
create_campaign_draft | taslak | Push 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.
| Alan | Açıklama |
|---|---|
| Talimat | Görev ve sınırlar (en çok 4000 karakter). |
| İzinli araçlar | Yukarıdaki katalogdan seçim. |
| Zamanlama | 5 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.