NeboAI
NeboAI
Başlayın

Uygulama SDK'sı

App SDK, bir uygulamanın sayfasını Nebo'ya bağlar. Nebo'nun her uygulamaya sunduğu tek bir betiktir ve sayfaya tek bir global nesne ekler: NeboAppSDK. Yüklenecek veya derlenecek bir şey yoktur.

SDK'yı yükleyin

<script src="/sdk/nebo.global.js"></script>
<script>
  const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script>

Global nesne NeboAppSDK'dir; nebo diye bir global yoktur. NeboAppSDK.nebo SDK örneğidir ve her modül en üst düzeyde de dışa aktarılır, yani NeboAppSDK.storage ile NeboAppSDK.nebo.storage aynı nesnedir. Tarayıcıyı gölgelememek için nebo.fetch, neboFetch olarak; nebo.WebSocket ise NeboWebSocket olarak dışa aktarılır.

identity

ÇağrıDöndürdüğü
identity.get()Uygulamanın çalışanı için {id, name, displayName, description, persona, model, skills, inputValues}. Önbelleğe alınır.
identity.invalidate()Önbelleği temizler.

storage

Uygulama için bir anahtar-değer deposu. storage:readwrite gerektirir. Uygulamanın çalışanının okuduğu ve değiştirdiği depoyla aynıdır: sahibinin çalışanla konuşarak eklediği bir kayıt sayfada görünür, sayfaya yazılan bir kaydı da çalışan bulabilir.

const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals);
ÇağrıDavranış
storage.getItem(key)setItem ne sakladıysa tam olarak o (nesne, liste, sayı veya dize) ya da null.
storage.setItem(key, value)Herhangi bir JSON değerini saklar.
storage.removeItem(key)Bir anahtarı kaldırır; artık keys() içinde görünmez.
storage.keys()Tüm anahtarlar.
storage.clear()Tüm anahtarları kaldırır.
storage.onChange(handler)Çalışan (source: "employee") veya uygulamanın açık herhangi bir penceresi — bu pencere dahil — (source: "page") tarafından yapılan her yazmadan sonra handler({appId, keys, action, source}) çağırır. Dinlemeyi durduran bir işlev döndürür.

Veri değiştiğinde, kim değiştirirse değiştirsin yeniden çizin:

async function load() {
  render((await NeboAppSDK.storage.getItem('deals')) ?? []);
}
load();
const stop = NeboAppSDK.storage.onChange((change) => {
  // { appId, keys: ['deals'], action: 'set' | 'delete', source: 'employee' | 'page' }
  if (change.keys.includes('deals')) load();
});

Bu depoya yalnızca uygulamanın kendi çalışanı ve yalnızca kendi uygulaması için erişir; başka bir çalışan, uygulamanın çalışanına sorar. Her iki tarafın da bulabileceği anahtarlar seçin (bir liste tutan tek bir anahtar ya da deal:42 gibi bir önek altında kayıt başına bir anahtar) ve bunları çalışanın talimatlarında açıklayın. Kendisi de geçerli JSON olan bir dize, örneğin "42", ayrıştırılmış olarak döner; tür önemliyse onu bir nesneye sarın. Her değeri 2 MB'ın epey altında tutun; bir yazma reddedildiğinde setItem hata fırlatmaz.

agents

Uygulamanın çalışanına ya da başka bir çalışana sorun ve yanıtını alın. Başka bir çalışana sormak subagent:<employee-id> gerektirir.

const { text } = await NeboAppSDK.agents.invoke('Which open deals close this month?');

for await (const part of NeboAppSDK.agents.stream('Summarize the pipeline.')) {
  output.textContent += part.text;
}
ÇağrıDöndürdüğü
agents.invoke(message, {agent, data})Çalışan bitirdiğinde {text, tools}.
agents.stream(message, {agent, data}){text, done} öğelerinden oluşan eşzamansız bir yineleyici.

janus

Kişilik, bellek veya araç olmadan doğrudan bir model çağrısı.

ÇağrıDöndürdüğü
janus.complete({messages, model, temperature, max_tokens, system})Dize olarak yanıt metni.
janus.stream(same)Metin parçalarından oluşan eşzamansız bir yineleyici.

decide

Türlü kararlar: bazı veriler hakkında adlandırılmış sorular sorun ve her yanıtı olasılıklar ve bir güven değeriyle tek, hızlı bir çağrıda geri alın. Hiçbir şey metin olarak yazılmaz; bu yüzden yargılar için kullanın (bu potansiyel müşteri sıcak mı, bu talep hangi kategoriye ait, ne kadar acil) ve sayma, tarih ve eşik işlerini kendi kodunuzda tutun. Uygulamanın çalışanı da aynı soruları decide aracıyla, örneğin uygulamanın saklanan kayıtları üzerinde sorabilir.

const { answers } = await NeboAppSDK.decide({
  state: { company: 'Example Co', status: 'asked for a quote today' },
  questions: {
    tier: {
      type: 'choice',
      instructions: 'How warm is this lead, judging by `status`?',
      criteria: { hot: 'ready to buy', warm: 'interested', cold: 'not now', other: "can't tell" }
    },
    fit: {
      type: 'score',
      instructions: 'How well does `company` fit our customers?',
      criteria: ['poor', 'fair', 'good', 'great']
    },
    reply: { type: 'noul', instructions: '`status` asks us for a reply.' }
  }
});

if (answers.tier.choice === 'hot' && answers.tier.confidence > 0.8) flag(lead);
// answers.fit.score is fractional: 0 is "poor", 1.5 is between "fair" and "good".
// answers.reply.noul is the probability the statement holds, from 0 to 1.
Soru türücriteriaYanıt
choice2 ile 255 arası adlandırılmış seçenekten oluşan bir nesne, {option: description}. Liste eksiksiz değilse other gibi bir kaçış seçeneği ekleyin.Seçenek başına choice (seçilen seçenek), confidence (0 ile 1 arası) ve probabilities.
scoreEn düşükten başlayarak sıralanmış 2 ile 10 arası seviyeden oluşan bir liste.Seviye başına score (kesirli, 0 ilk seviyedir), confidence ve probabilities.
noulYok: soru, değerlendirilecek tek bir ifadedir.noul, ifadenin doğru olma olasılığı. Ayrı bir güven değeri yoktur.
  • decide({state, questions}), {model, answers, usage} değerini döndürür; her yanıt, sorusuna verdiğiniz adın altında yer alır.
  • state metin veya herhangi bir JSON'dur. Onu soruların ihtiyaç duyduğu alanlarla sınırlı tutun ve bu alanları instructions içinde ters tırnak içinde adlandırın. Sorunun tamamı instructions içinde yer alır; sorunun adı yalnızca yanıtı etiketler. Çok uzun state, gönderilmeden önce ortasından kısaltılır.
  • Mesajı nedeni belirten bir hata fırlatır. Hatanın durum kodu yoktur; bu nedenle durumları birbirinden ayırmanız gerekiyorsa mesajı karşılaştırın:
    • Hatalı biçimlendirilmiş bir soru, örneğin tek seçenekli bir choice (bot neyin yanlış olduğunu belirterek 400 ile yanıt verir).
    • Sahibinin hesabında iş kalmadı: "Hesabınıza dahil olan tüm işi kullandınız. Devam etmek için bir plan seçin veya kredi ekleyin." (429). Sahip bir plan veya kredi ekleyene kadar yeniden denemek işe yaramaz.
    • Aynı anda çok fazla karar: "Aynı anda çok fazla karar var. Birazdan tekrar deneyin." (429).
    • Bot oturum açmamış: "Kararlar için NeboAI bağlantısı gerekir. NeboAI'a giriş yapın ve tekrar deneyin." (503).
    • Karar hizmeti başarısız oldu (502).
  • Kararlar, her model çağrısı gibi bot sahibinin NeboAI hesabına faturalandırılır. Bkz. fiyatlandırma.

neboFetch

// Relative path: the app's own sidecar.
const res = await NeboAppSDK.neboFetch('/deals?stage=open');

// Absolute URL: through Nebo's proxy. Needs network:api.example.com.
const rates = await NeboAppSDK.neboFetch('https://api.example.com/rates');

Göreli bir yol, uygulamanın sidecar'ına /apps/<id>/api/<path> adresinde gider. Mutlak bir http veya https URL'si Nebo'nun proxy'sinden geçer ve network:<host> ya da network:* gerektirir.

NeboWebSocket

new NeboAppSDK.NeboWebSocket(), uygulamanın çalışanına canlı bir soket açar ve geri çekilmeyle yeniden bağlanır. Argüman almaz; send(data), close(), onopen, onmessage, onerror ve onclose öğelerine sahiptir.

surfaces ve a2ui

surfaces.connect(), uygulamanın canlı kanalını açar. Bugün bu kanal, uygulamanın çalışanından gelen etkileşimli kartları taşır: sayfanızın paketlediği @a2ui/web_core içinden bir MessageProcessor ile a2ui.init(processor) çağırın (SDK'nın kendi oluşturucusu yoktur). Bir kart yalnızca oluşturulduğu uygulamaya ulaşır, üzerine yapılan tıklama o uygulamanın çalışanına gider ve kart gönderildikten sonra açılan bir sayfa onu almaz; bu yüzden sayfanın her zaman göstermesi gerekenleri storage içinde tutun.

SDK ayrıca surfaces.on(type, handler), surfaces.send(name, payload) ve surfaces.state ile text_content, state_delta ve surface_update gibi türlü olaylar tanımlar. Nebo bu olayları henüz uygulama sayfalarına göndermez ve send çağrısını yanıtlayan bir şey yoktur. Canlı veriler için storage.onChange kullanın.

chat

Nebo'nun uygulamanın çalışanıyla sohbetini sayfaya gömün.

NeboAppSDK.chat.mount(document.getElementById('chat'), {
  placeholder: 'Ask about a deal',
  contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' });
ÇağrıDavranış
chat.mount(element, options)Seçenekler: placeholder, theme, height, borderless, contextId, scope.
chat.send(text)Bir mesaj gönderir.
chat.setContext(context)Çalışanın gördüğü bağlamı ayarlar; null onu temizler.
chat.onMessage(handler)Mesajları alır.
chat.newThread()Yeni bir ileti dizisi başlatır.
chat.unmount()Sohbeti kaldırır.

Yapılandırma

Nebo içinde SDK, uygulama kimliğini ve temel URL’yi kendisi bulur. Başka bir yerde sunulan bir sayfa için nebo.configure({appId, baseUrl}) ya da NeboAppSDK.setAppId(id) ve NeboAppSDK.setBaseUrl(url) çağırın. getAppId() ve getBaseUrl() bunları geri okur.