NeboAI
NeboAI
Kom i gang

App-SDK

App SDK kobler en apps side til Nebo. Det er ett skript som Nebo serverer til alle apper, og det legger én enkelt global variabel på siden, NeboAppSDK. Det er ingenting å installere eller bygge.

Last inn SDK-en

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

Den globale variabelen er NeboAppSDK; det finnes ingen global nebo. NeboAppSDK.nebo er SDK-instansen, og hver modul eksporteres også på toppnivå, så NeboAppSDK.storage og NeboAppSDK.nebo.storage er samme objekt. For å unngå å skygge for nettleseren eksporteres nebo.fetch som neboFetch og nebo.WebSocket som NeboWebSocket.

identity

KallReturnerer
identity.get(){id, name, displayName, description, persona, model, skills, inputValues} for appens ansatt. Hurtigbufret.
identity.invalidate()Tømmer hurtigbufferen.

storage

Et nøkkel-verdi-lager for appen. Det krever storage:readwrite. Det er det samme lageret som appens ansatt leser og endrer: en oppføring eieren legger til ved å snakke med den ansatte, vises på siden, og en som skrives inn på siden, kan den ansatte finne.

const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals);
KallOppførsel
storage.getItem(key)Nøyaktig det setItem lagret (objekt, liste, tall eller streng), eller null.
storage.setItem(key, value)Lagrer en hvilken som helst JSON-verdi.
storage.removeItem(key)Fjerner én nøkkel; den vises ikke lenger i keys().
storage.keys()Alle nøkler.
storage.clear()Fjerner alle nøkler.
storage.onChange(handler)Kaller handler({appId, keys, action, source}) etter hver skriving, av den ansatte (source: "employee") eller av et hvilket som helst åpent vindu i appen, inkludert dette (source: "page"). Returnerer en funksjon som slutter å lytte.

Tegn på nytt når dataene endres, uansett hvem som endret dem:

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

Bare appens egen ansatt når dette lageret, og bare for sin egen app; en annen ansatt spør appens ansatt. Velg nøkler begge sider kan finne (én nøkkel som inneholder en liste, eller én nøkkel per oppføring under et prefiks som deal:42), og beskriv dem i den ansattes instruksjoner. En streng som selv er gyldig JSON, som "42", kommer tilbake tolket, så pakk den inn i et objekt hvis typen betyr noe. Hold hver verdi godt under 2 MB; setItem kaster ingen feil når en skriving avvises.

agents

Spør appens ansatt, eller en annen ansatt, og få svaret. Å spørre en annen ansatt krever 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;
}
KallReturnerer
agents.invoke(message, {agent, data}){text, tools} når den ansatte er ferdig.
agents.stream(message, {agent, data})En asynkron iterator av {text, done}.

janus

Et direkte modellkall uten persona, minne eller verktøy.

KallReturnerer
janus.complete({messages, model, temperature, max_tokens, system})Svarteksten som en streng.
janus.stream(same)En asynkron iterator av tekstbiter.

decide

Typede beslutninger: still navngitte spørsmål om noen data og få hvert svar tilbake med sannsynligheter og en konfidens, i ett raskt kall. Ingenting skrives som tekst, så bruk det til vurderinger (er dette kundeemnet varmt, hvilken kategori hører denne saken til, hvor mye haster det) og hold telling, datoer og terskler i din egen kode. Appens ansatt kan stille de samme spørsmålene med verktøyet decide, for eksempel over appens lagrede oppføringer.

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.
SpørsmålstypecriteriaSvar
choiceEt objekt med 2 til 255 navngitte alternativer, {option: description}. Legg til et reservealternativ som other når listen ikke er komplett.choice (valget som ble tatt), confidence (0 til 1) og probabilities per alternativ.
scoreEn liste med 2 til 10 ordnede nivåer, lavest først.score (brøk, 0 er første nivå), confidence og probabilities per nivå.
noulIngen: spørsmålet er én påstand som skal vurderes.noul, sannsynligheten for at påstanden stemmer. Ingen separat konfidens.
  • decide({state, questions}) returnerer {model, answers, usage}, med hvert svar under navnet du ga spørsmålet.
  • state er tekst eller hvilken som helst JSON. Begrens det til feltene spørsmålene trenger, og nevn disse feltene i backticks inne i instructions. Hele spørsmålet ligger i instructions; spørsmålets navn er bare en etikett på svaret. Svært lang state forkortes på midten før den sendes.
  • Den kaster en feil der meldingen er årsaken. Feilen har ingen statuskode, så sammenlign meldingen hvis du må skille tilfellene fra hverandre:
    • Et feilformet spørsmål, for eksempel et valg med bare ett alternativ (boten svarer 400, med hva som er feil).
    • Ikke mer arbeid igjen på eierens konto: «Du har brukt alt arbeidet som er inkludert i kontoen din. Velg en plan eller legg til kreditt for å fortsette.» (429). Nye forsøk hjelper ikke før eieren legger til en plan eller kreditt.
    • For mange beslutninger samtidig: «For mange beslutninger samtidig. Prøv igjen om et øyeblikk.» (429).
    • Boten er ikke logget inn: «Beslutninger krever at NeboAI er tilkoblet. Logg inn på NeboAI og prøv igjen.» (503).
    • Beslutningstjenesten mislyktes (502).
  • Beslutninger faktureres til boteierens NeboAI-konto som ethvert modellkall. 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 sti går til appens sidecar på /apps/<id>/api/<path>. En absolutt http- eller https-URL går gjennom Nebos proxy og krever network:<host> eller network:*.

NeboWebSocket

new NeboAppSDK.NeboWebSocket() åpner en direkte socket til appens ansatt og kobler til igjen med backoff. Den tar ingen argumenter og har send(data), close(), onopen, onmessage, onerror og onclose.

surfaces og a2ui

surfaces.connect() åpner appens direktekanal. I dag bærer den interaktive kort fra appens ansatt: kall a2ui.init(processor) med en MessageProcessor fra @a2ui/web_core, som siden din pakker med (SDK-en har ingen egen gjengiver). Et kort når bare appen det ble laget for, et klikk på det går til den appens ansatt, og en side som åpnes etter at et kort ble sendt, mottar det ikke, så hold det siden alltid må vise, i storage.

SDK-en definerer også typede hendelser som text_content, state_delta og surface_update, med surfaces.on(type, handler), surfaces.send(name, payload) og surfaces.state. Nebo sender ikke disse hendelsene til appsider ennå, og ingenting svarer på send. For sanntidsdata bruker du storage.onChange.

chat

Bygg inn Nebos chat med appens ansatt på siden.

NeboAppSDK.chat.mount(document.getElementById('chat'), {
  placeholder: 'Ask about a deal',
  contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' });
KallOppførsel
chat.mount(element, options)Alternativer: placeholder, theme, height, borderless, contextId, scope.
chat.send(text)Sender en melding.
chat.setContext(context)Angir konteksten den ansatte ser; null tømmer den.
chat.onMessage(handler)Mottar meldinger.
chat.newThread()Starter en ny tråd.
chat.unmount()Fjerner chatten.

Konfigurasjon

Inne i Nebo finner SDK-en app-ID-en og basis-URL-en selv. For en side som serveres et annet sted, kaller du nebo.configure({appId, baseUrl}), eller NeboAppSDK.setAppId(id) og NeboAppSDK.setBaseUrl(url). getAppId() og getBaseUrl() leser dem tilbake.