Kabinde çalışan danışmanın aynısı uygulamanızdan da kullanılabilir. Bir oturum oluşturur, bir mesaj gönderirsiniz; asistanın yanıtı açık bir akış üzerinden parça parça gelir.
tools:chat kapsamını ister. Temel adres: https://developers.grem.capital/api/v1.
Nasıl çalışır
- Bir oturum oluşturun - konuşmanın bağlamını o tutar.
- O oturum için olay akışını açın.
- Bir mesaj gönderin.
- Yanıt, bitene dek akış üzerinden parça parça gelir.
Sıra önemlidir: akışı mesajı göndermeden önce açın, yoksa yanıtın ilk parçaları sizi ıskalar.
Oturumlar
POST /chat/sessions create
GET /chat/sessions list
PATCH /chat/sessions/{id} rename, pin
DELETE /chat/sessions/{id} move to the archive
Oturum oluşturma:
curl -X POST https://developers.grem.capital/api/v1/chat/sessions \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"title":"Client question about a mortgage"}'
Yanıt, sonraki her çağrıda geçireceğiniz oturum kimliğini taşır.
API size genel danışmanı verir. Kabinin CRM'i içinde çalışan otomatik yanıtlayıcı modu dışarıdan açılamaz.
Mesaj gönderme
curl -X POST https://developers.grem.capital/api/v1/chat/messages \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "…",
"text": "What does a two-room flat in Podil cost?",
"clientMessageId": "msg-0001"
}'
clientMessageId mesajın sizdeki kimliğidir. Gönderdiğinizle akışta geleni birbirine bağlar; böylece bağlantı yeniden kurulduğunda hiçbir şey iki kez gösterilmez.
İsteğe bağlı style alanı yanıtın uzunluğunu belirler: short, normal ya da detailed.
Yanıt akışı
GET /chat/stream?sessionId=…
Authorization: Bearer gsk_live_...
Accept: text/event-stream
Bağlantı uzun ömürlüdür ve olaylar yanıt üretildikçe gelir:
| Olay | Anlamı |
|---|---|
assistant.started | asistan yanıtlamaya başladı; ardından metin parçaları gelir |
assistant.delta | metnin sıradaki parçası, delta alanında |
assistant.done | yanıt tamamlandı; text alanı tümünü taşır |
Bağlantı koparsa aynı sessionId ile yeniden bağlanın: sunucu o anki turu baştan yeniden oynatır. Bu yüzden assistant.started, o mesaj için biriktirilen metni temizlemeli; yoksa metin ikilenir.
Geçmiş
GET /chat/history?sessionId=…&limit=50
Oturumun saklanan mesajlarını döndürür. Arayüzünüz yeniden yüklendiğinde konuşmayı geri getirmek için kullanın.
Ne kadar tutuyor
Yalnızca mesaj göndermek (POST /chat/messages) ücretlendirilir. Oturum oluşturma, oturum listesi, geçmiş ve akışın kendisi ücretsizdir ve API çağrısı sayılmaz.
İlgili yazılar
- TypeScript SDK - akışa abone olan hazır istemci.
- Hatalar - ret kodlarının anlamı.
- API üzerinden araçlar - platformun diğer araçları.