NeboAI
NeboAI
Kom igång

App-SDK

App SDK kopplar en apps sida till Nebo. Det är ett enda skript som Nebo serverar till varje app, och det lägger ett enda globalt objekt på sidan, NeboAppSDK. Det finns inget att installera eller bygga.

Läs in SDK:n

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

Det globala objektet heter NeboAppSDK; det finns inget globalt nebo. NeboAppSDK.nebo är SDK-instansen, och varje modul exporteras också på toppnivå, så NeboAppSDK.storage och NeboAppSDK.nebo.storage är samma objekt. För att inte skugga webbläsarens egna objekt exporteras nebo.fetch som neboFetch och nebo.WebSocket som NeboWebSocket.

identity

AnropReturnerar
identity.get(){id, name, displayName, description, persona, model, skills, inputValues} för appens medarbetare. Cachelagras.
identity.invalidate()Tömmer cachen.

storage

Ett nyckel-värde-lager för appen. Det kräver storage:readwrite. Det är samma lager som appens medarbetare läser och ändrar: en post som ägaren lägger till genom att prata med medarbetaren syns på sidan, och en post som skrivs in på sidan kan medarbetaren hitta.

const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals);
AnropBeteende
storage.getItem(key)Exakt det som setItem sparade (objekt, lista, tal eller sträng), eller null.
storage.setItem(key, value)Sparar valfritt JSON-värde.
storage.removeItem(key)Tar bort en nyckel; den syns inte längre i keys().
storage.keys()Alla nycklar.
storage.clear()Tar bort alla nycklar.
storage.onChange(handler)Anropar handler({appId, keys, action, source}) efter varje skrivning, av medarbetaren (source: "employee") eller av något öppet fönster i appen, inklusive det här (source: "page"). Returnerar en funktion som slutar lyssna.

Rita om när datan ändras, oavsett vem som ändrade den:

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();
});

Bara appens egen medarbetare når det här lagret, och bara för sin egen app; andra medarbetare frågar appens medarbetare. Välj nycklar som båda sidor kan hitta (en nyckel som innehåller en lista, eller en nyckel per post under ett prefix som deal:42) och beskriv dem i medarbetarens instruktioner. En sträng som i sig är giltig JSON, till exempel "42", kommer tillbaka tolkad, så slå in den i ett objekt om typen spelar roll. Håll varje värde klart under 2 MB; setItem kastar inget fel när en skrivning nekas.

agents

Fråga appens medarbetare, eller en annan medarbetare, och få svaret. Att fråga en annan medarbetare kräver subagent:<employee-id>.

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;
}
AnropReturnerar
agents.invoke(message, {agent, data}){text, tools} när medarbetaren är klar.
agents.stream(message, {agent, data})En asynkron iterator av {text, done}.

janus

Ett direkt modellanrop utan persona, minne eller verktyg.

AnropReturnerar
janus.complete({messages, model, temperature, max_tokens, system})Svarstexten som en sträng.
janus.stream(same)En asynkron iterator av textstycken.

decide

Typade beslut: ställ namngivna frågor om viss data och få tillbaka varje svar med sannolikheter och en säkerhet, i ett enda snabbt anrop. Inget skrivs som text, så använd det för bedömningar (är det här leadet hett, vilken kategori hör ärendet till, hur brådskande är det) och håll räkning, datum och tröskelvärden i din egen kod. Appens medarbetare kan ställa samma frågor med sitt decide-verktyg, till exempel om appens sparade poster.

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.
FrågetypcriteriaSvar
choiceEtt objekt med 2 till 255 namngivna alternativ, {option: description}. Lägg till ett reservalternativ som other när listan inte är fullständig.choice (det valda alternativet), confidence (0 till 1) och probabilities per alternativ.
scoreEn lista med 2 till 10 ordnade nivåer, lägsta först.score (decimaltal, 0 är den första nivån), confidence och probabilities per nivå.
noulInga: frågan är ett enda påstående att bedöma.noul, sannolikheten att påståendet stämmer. Ingen separat säkerhet.
  • decide({state, questions}) returnerar {model, answers, usage}, där varje svar ligger under det namn du gav dess fråga.
  • state är text eller valfri JSON. Begränsa den till de fält som frågorna behöver och namnge fälten inom backticks i instructions. Hela frågan finns i instructions; frågans namn är bara en etikett för svaret. Mycket långa tillstånd kortas av i mitten innan de skickas.
  • Det kastar ett fel vars meddelande är orsaken. Felet har ingen statuskod, så jämför meddelandet om du behöver skilja fallen åt:
    • En felaktigt formulerad fråga, till exempel ett val med bara ett alternativ (boten svarar 400, med vad som är fel).
    • Inget arbete kvar på ägarens konto: ”Du har använt allt arbete som ingår i ditt konto. Välj en plan eller fyll på krediter för att fortsätta.” (429). Nya försök hjälper inte förrän ägaren lägger till en plan eller krediter.
    • För många beslut samtidigt: ”För många beslut samtidigt. Försök igen om en stund.” (429).
    • Boten är inte inloggad: ”Beslut kräver att NeboAI är anslutet. Logga in på NeboAI och försök igen.” (503).
    • Beslutstjänsten misslyckades (502).
  • Beslut debiteras bottens ägares NeboAI-konto precis som alla modellanrop. Se priser.

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');

En relativ sökväg går till appens sidecar på /apps/<id>/api/<path>. En absolut http- eller https-URL går via Nebos proxy och kräver network:<host> eller network:*.

NeboWebSocket

new NeboAppSDK.NeboWebSocket() öppnar en live-socket till appens medarbetare och återansluter med backoff. Den tar inga argument och har send(data), close(), onopen, onmessage, onerror och onclose.

surfaces och a2ui

surfaces.connect() öppnar appens livekanal. I dag bär den interaktiva kort från appens medarbetare: anropa a2ui.init(processor) med en MessageProcessor från @a2ui/web_core, som din sida paketerar (SDK:n har ingen egen renderare). Ett kort når bara den app det skapades för, ett klick på det går till den appens medarbetare, och en sida som öppnas efter att ett kort skickats får inte kortet, så spara det som sidan alltid måste visa i storage.

SDK:n definierar också typade händelser som text_content, state_delta och surface_update, med surfaces.on(type, handler), surfaces.send(name, payload) och surfaces.state. Nebo skickar ännu inte de händelserna till appsidor, och inget svarar på send. Använd storage.onChange för livedata.

chat

Bädda in Nebos chatt med appens medarbetare på sidan.

NeboAppSDK.chat.mount(document.getElementById('chat'), {
  placeholder: 'Ask about a deal',
  contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' });
AnropBeteende
chat.mount(element, options)Alternativ: placeholder, theme, height, borderless, contextId, scope.
chat.send(text)Skickar ett meddelande.
chat.setContext(context)Anger kontexten som medarbetaren ser; null rensar den.
chat.onMessage(handler)Tar emot meddelanden.
chat.newThread()Startar en ny tråd.
chat.unmount()Tar bort chatten.

Konfiguration

Inuti Nebo hittar SDK:n app-id:t och bas-URL:en på egen hand. För en sida som serveras någon annanstans anropar du nebo.configure({appId, baseUrl}), eller NeboAppSDK.setAppId(id) och NeboAppSDK.setBaseUrl(url). getAppId() och getBaseUrl() läser tillbaka dem.