Reklam

agent

18 uç · /api/ads/v1/agent

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 18 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/ads/v1/agent/autonomy

🔴 Yükseltme akışının çekirdeği: her seviyede **neyin değiştiğini** anlatan merdiven.

Oturum

Seviye yükseltmek bir onay kutusu değil bir karardır. Kullanıcıya yalnız "tam otonom" etiketini gösterip seçtirmek, ona ne devrettiğini söylemeden imza attırmak olurdu. Bu yüzden her basamak "ne yapar" kadar **"ne yapmaz"** ile de tanımlanır: yükseltmenin gerçek bedeli, kaybedilen soru sorma anıdır. ⚠ Seviye burada DEĞİŞTİRİLMEZ. Değişim yalnız yeni bir mandatla olur (gerekirse ikinci onaycıyla) — yetki devri, bir ayar değişikliği gibi tek tıkla yapılamaz.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/autonomy" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/cost

"Bu ay ajan bize kaça mal oldu, tavanın neresindeyiz."

Oturum

🔴 Bu uç olmadan maliyet koruması kullanıcı için **var olmamış** demektir: tavan sessizce uygulanır, ajan bir gün düşünmeyi bırakır ve kimse nedenini göremez. İzin `ads.view` — harcamayı görmek, onu değiştirmekten daha dar bir yetkidir. ⚠ Rapor KİRACI kapsamlıdır (tavan kiracı başınadır), workspace kapsamlı değil.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/cost" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/exclusions

Yürürlükteki kapsam dışı bırakmalar. Süresi dolmuş satırlar **listelenmez** ama silinmez

Oturum

de: geçmişte ajanın neden beklediği sorusu kayıttan cevaplanabilir kalır.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/exclusions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/ads/v1/agent/exclusions

"Buna dokunma." Kalıcı olabilir — kullanıcının açık kararı, geçici bir beklemeden güçlüdür.

Oturum
İstek
curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/agent/exclusions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/ads/v1/agent/exclusions/{id}

Include entity

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.ads.blesyum.app/api/ads/v1/agent/exclusions/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/guardrails

Korumanın tetiklendiği anların defteri.

Oturum

🔴 Bu uç olmadan koruma **görünmez** olurdu: ajan bir şey yapmaz, kullanıcı sebebini bilmez ve çalışan bir korumayı bozuk bir üründen ayırt edemez. İzin `ads.view` — engellenen bir şeyi görmek, onu yapabilmekten daha dar bir yetki gerektirir.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/guardrails" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/halt

Ajanın durumu + **neden** durduğu + geçmiş + yeniden başlatma kontrol listesi.

Oturum

🔴 Dördü TEK yanıtta: kullanıcı "ajan neden çalışmıyor" sorusunu tek ekranda cevaplayamazsa, durdurmayı kaldırmak için gereken bilgiyi toplamak yerine tahmin eder. Kontrol listesi de burada döner — "önce durumu çek, sonra listeyi çek" ayrımı, panelin listeyi göstermeyi atlamasını kolaylaştırırdı.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/halt" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/ads/v1/agent/halt

🔴 **Fren.** İzin `ads.view` — bilerek sürdürmekten (mandat izni) daha geniş.

Oturum

Salt-okunur bir kullanıcının ajanı durdurabilmesi kabul edilmiş bir maliyettir: yanlış basılan fren geri alınabilir ve deftere aktörüyle yazılır; basılamayan fren ise harcamanın sürmesi demektir.

İstek
curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/agent/halt" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/ledger-months

Saklama süresi dolduğu için budanan ayların **kalıcı** özeti (BLE2-9766).

Oturum

Detay silinir, "o ay ne oldu" sorusu cevapsız kalmaz: kaç aksiyon uygulandı, ne kadar harcama yönlendirildi, kaç kez frenlendi.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/ledger-months" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/memory

🔴 Liste **zayıf hafızaları da** içerir. Yalnız ajanın kullandıklarını göstermek,

Oturum

"benim hakkımda ne biliyor" sorusunu yarım cevaplardı — KVKK şeffaflığı ajanın hangi bilgiyi işe yarar bulduğuna göre daralmaz.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/memory" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/ads/v1/agent/memory/{id}

Kullanıcı bir öğrenmeyi siler.

OturumYol parametresi: id

🔴 İzin `ads.agent.mandate`, `ads.view` DEĞİL: hafızayı silmek ajanın bir sonraki kararını değiştirir. Okumak şeffaflıktır, silmek müdahaledir.

İstek
curl -X DELETE "https://{slug}.ads.blesyum.app/api/ads/v1/agent/memory/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PATCH/api/ads/v1/agent/memory/{id}

Sabitleme: çıkarımı **kullanıcı beyanına** yükseltir — artık çürümez, budanmaz ve

OturumYol parametresi: id

çıkarım tavanına takılmaz. Kullanıcı "bunu ben söylüyorum" demiş olur.

İstek
curl -X PATCH "https://{slug}.ads.blesyum.app/api/ads/v1/agent/memory/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/ads/v1/agent/resume

Sürdürme. İzin `ads.agent.mandate`: ajanı yeniden çalıştırmak, harcama yetkisini geri

Oturum

vermektir — kampanya düzenleyebilen herkesin yapabileceği bir iş değildir.

İstek
curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/agent/resume" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/ads/v1/agent/scope/handover

Seçilen kampanyaları ajana devret (BLE2-9878).

Oturum

🔴 İzin `ads.agent.mandate`: bu, bir görüntüleme tercihi değil **yetki devridir**. Kampanya yazma izniyle açılsaydı, ajanı hiç yönetmeye yetkili olmayan bir kullanıcı ajanın neye dokunacağını belirleyebilirdi.

İstek
curl -X POST "https://{slug}.ads.blesyum.app/api/ads/v1/agent/scope/handover" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/scorecard

Karneyi hesapla.

Oturum

⚠ Yalnız **ajan** aksiyonları sayılır: insanın kendi yaptıkları da aynı defterde durur ama onlar ajanın karnesi değildir. Karıştırmak, panelde çalışkan bir kullanıcıyı başarılı bir ajan gibi gösterirdi.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/scorecard" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/tool-calls

Araç çağrı denetimi: "AI adına, X kullanıcısı yerine" (BLE2-9737).

Oturum

`denied=true` yalnız reddedilen ve uydurma çağrıları verir — denetimin ilk baktığı yer.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/tool-calls" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/tools

Ajanın **eli**: hangi araçları çağırabiliyor, hangi izni istiyor — ve bilerek NELERİ

Oturum

yapamıyor. 🔴 Yapamadıkları da döner. "Ajan neyi yapamaz" sorusunun cevabını kullanıcıya vermeyen bir liste, güven kurmaz: kişi listedeki boşluğu bir eksiklik mi yoksa bir karar mı olduğunu anlayamaz.

İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/tools" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/ads/v1/agent/wakeups

Ajanı sırasından önce uyandıran olaylar — "neden şimdi çalıştı" sorusunun cevabı.

Oturum
İstek
curl -X GET "https://{slug}.ads.blesyum.app/api/ads/v1/agent/wakeups" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?