copilot — ERP API

POST/api/erp/v1/copilot/ask

⭐⭐ İKİ kapı: yüzeyin kapısı (`erp.copilot.use`) ve VERİNİN kapısı

Oturum

(`erp.analytics.view`). İkincisi olmasa copilot, pivot ekranına yetkisi olmayan kullanıcı için analitik verinin arka kapısı olurdu.

İstek

curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/ask" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/erp/v1/copilot/catalog

Asistanın NE yapabildiği: örnek sorular, küp kataloğu ve araçlar (çağıranın izniyle

Oturum

birlikte). ⭐ `can_run`, aracı gösterip 403 ile şaşırtmamak için önden hesaplanır.

İstek

curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/catalog" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/erp/v1/copilot/sessions

Copilot sessions

Oturum

İstek

curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/erp/v1/copilot/sessions

Copilot create session

Oturum

İstek

curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/erp/v1/copilot/sessions/{id}

Copilot delete session

OturumYol parametresi: id

İstek

curl -X DELETE "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/erp/v1/copilot/sessions/{id}/messages

Copilot messages

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions/<id>/messages" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/erp/v1/copilot/sessions/{id}/tools

Copilot tool runs

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions/<id>/tools" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/erp/v1/copilot/sessions/{id}/tools

Copilot propose tool

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/sessions/<id>/tools" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/erp/v1/copilot/tools/{id}/execute

⭐⭐⭐ Yazma aracı yalnız BURADA çalışır ve aracın KENDİ izin anahtarını ister; `ask`

OturumYol parametresi: id

yolu hiçbir şey yazmaz. Sohbetteki "evet yap" cümlesi tek başına deftere kayıt atamaz.

İstek

curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/tools/<id>/execute" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/erp/v1/copilot/tools/{id}/reject

Copilot reject tool

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/copilot/tools/<id>/reject" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}