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
| Anrop | Returnerar |
|---|---|
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); | Anrop | Beteende |
|---|---|
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;
} | Anrop | Returnerar |
|---|---|
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.
| Anrop | Returnerar |
|---|---|
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ågetyp | criteria | Svar |
|---|---|---|
choice | Ett 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. |
score | En 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å. |
noul | Inga: 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 iinstructions. Hela frågan finns iinstructions; 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' }); | Anrop | Beteende |
|---|---|
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.