istGalaxy.
Geliştirici API

Aynı ajan, sizin arayüzünüzde.

Galaxy'nin beynini kendi ürününüze bağlayın: cevap üretme ve bilgi arama kapıları dışarıya açık, kendi sistemleriniz de içeriye bağlanır — kargo ucunuz, üyelik sisteminiz, stok servisiniz ajanın eli olur. Beyin bizde, arayüz sizde.

İki kapı

dışarıya: cevap üretme (POST /reply) ve bilgi tabanında kaynaklı arama (POST /search) — kendi API anahtarınızla

31 araç

ajanın elinin altında; kendi HTTP ucunuzu panelden tanımlarsınız, sizinki de aralarına katılır

Aynı beyin

API'den gelen soru da paneldekiyle aynı yoldan geçer: bilgi tabanınıza dayanır, aynı frenlerden geçer

dışarıya açık kapılar

Cevabı üretelim, ekranı siz çizin

Mobil uygulamanız, üye paneliniz ya da kendi siteniz — müşterinin sorusunu bize gönderirsiniz, kaynaklı cevabı size döneriz; nasıl göstereceğiniz tamamen size kalmış. Bilgi arama kapısıyla da bilgi tabanınızda arama yapar, sonucu kendi ekranınızda listelersiniz.

Cevap üretme

Soruyu gönderin, ajanın cevabını alın — bilgi tabanınıza dayalı, kaynaklı. Arayüz, marka, akış: hepsi sizin.

Kaynaklı arama

Bilgi tabanınızda arama yapın; sonuçlar hangi maddeye dayandığıyla birlikte gelir.

Anahtarla erişim

Erişim API anahtarıyladır; anahtarları panelden açar, kapatır, yenilersiniz.

Uçlar: POST /reply · POST /search — her istek yalnız kendi çalışma alanınızın verisine erişir.

içeriye bağlanan sistemler

Kendi sisteminiz, ajanın eli

Müşteri "kargom nerede?" diye sorduğunda ajanın sizin kargo sisteminize bakması gerekir. Kendi HTTP ucunuzu panelden tanımlarsınız; ajan konuşmanın ortasında onu çağırır, dönen bilgiyi müşterinin diliyle anlatır. Kargo, stok, üyelik, sipariş — hangi sisteminiz varsa.

Panelden tanım

Ucun adresi, ne işe yaradığı, hangi bilgiyi istediği — tek formla tanımlanır; kod tarafında değişiklik gerekmez.

Yeni nesil bağlantı

MCP standardını konuşan sistemlere de bağlanır: araç sunan bir servisiniz varsa ajan onu güvenli yetki devriyle kullanır.

Dışarıdan tetik

Kendi sisteminizde bir olay olduğunda Galaxy'ye haber verirsiniz; ilgili otomasyon akışı kendiliğinden başlar.

Her çağrı kayıtlıdır: hangi araç, hangi konuşmada, ne zaman çağrıldı — denetim günlüğünde durur.

güvenlik

Açık kapı, gevşek kapı demek değil

Dışarı açılan her yüzey aynı disipline bağlıdır: istekler anahtarla doğrulanır, her istek yalnız kendi çalışma alanınıza kilitlidir, dış sistemlerden gelen her haber imza kontrolünden geçer. Ajanın frenleri API'de de aynen çalışır — kaynağı olmayan iddia API'den de çıkmaz.

Alan kilidi

Her anahtar tek çalışma alanına bağlıdır; başka müşterinin verisine hiçbir istek ulaşamaz.

İmzalı haberleşme

Dış sistemlerden gelen her bildirim imza doğrulamasından geçer; imzasız istek işlenmez.

Frenler aynen

Yasaklı konular, insan onayı gerektiren işler, kaynak zorunluluğu — panelde neyse API'de de o.

Kendi sisteminizin araca dönüşme yolculuğu

  1. Panelden tanımlarsınız: ucun adresi + ne işe yaradığı + hangi bilgiyi beklediği
  2. Müşteri sorar: "Kargom nerede?" — ajan sizin kargo ucunuzu çağırır
  3. Dönen bilgiyi müşterinin dilinde, anlaşılır bir cümleyle iletir
  4. Çağrı denetim günlüğüne işlenir: hangi konuşma, hangi araç, ne zaman

Tanımı siz yaparsınız, siz kaldırırsınız; tanımlamadığınız hiçbir uç çağrılmaz.

Sık sorulanlar

API'den gelen cevap da aynı frenlerden geçer mi?

Evet. Cevap üretme kapısı paneldeki ajanla aynı beyni kullanır: bilgi tabanınıza dayanır, kaynak gösterir, yasaklı konularda durur, gerekirse insana devreder.

Bağlamak için ne kadar teknik bilgi gerekir?

Cevap ve arama kapıları için basit bir istek atabilen herhangi bir geliştirici yeterli. Kendi sisteminizi araç olarak bağlamaksa panelden tek formdur. Kurulum haftasında ilk bağlantıyı birlikte yaparız.

Anahtarım çalınırsa ne olur?

Anahtarı panelden anında kapatır, yenisini açarsınız. Her anahtar yalnız sizin çalışma alanınıza kilitli olduğu için başka müşterinin verisine zaten erişemez.

Sitem için de API mi kullanmam gerekiyor?

Hayır. Websitenizdeki sohbet kutusu tek satır kodla girer, hiç API gerektirmez. API, kendi arayüzünüzü çizmek ya da kendi sistemlerinizi ajana bağlamak istediğinizde devreye girer.

Beyni biz kurduk. Nereye bağlayacağınız size kalmış.

Kurulumu ilk hafta biz yapıyoruz; ilk bağlantınızı örnek isteklerle birlikte kurarız.