Indlæs SDK'et
<script src="/sdk/nebo.global.js"></script>
<script>
const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script> Den globale hedder NeboAppSDK; der er ingen global nebo. NeboAppSDK.nebo er SDK-instansen, og hvert modul eksporteres også på øverste niveau, så NeboAppSDK.storage og NeboAppSDK.nebo.storage er det samme objekt. For ikke at skygge for browseren eksporteres nebo.fetch som neboFetch og nebo.WebSocket som NeboWebSocket.
identity
| Kald | Returnerer |
|---|---|
identity.get() | {id, name, displayName, description, persona, model, skills, inputValues} for appens medarbejder. Cachet. |
identity.invalidate() | Rydder cachen. |
storage
Et nøgle-værdi-lager til appen. Det kræver storage:readwrite. Det er det samme lager, som appens medarbejder læser og ændrer: en post, ejeren tilføjer ved at tale med medarbejderen, vises på siden, og en, der skrives ind på siden, kan medarbejderen finde.
const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals); | Kald | Adfærd |
|---|---|
storage.getItem(key) | Præcis det, setItem gemte (objekt, liste, tal eller streng), eller null. |
storage.setItem(key, value) | Gemmer enhver JSON-værdi. |
storage.removeItem(key) | Fjerner én nøgle; den vises ikke længere i keys(). |
storage.keys() | Alle nøgler. |
storage.clear() | Fjerner alle nøgler. |
storage.onChange(handler) | Kalder handler({appId, keys, action, source}) efter hver skrivning, udført af medarbejderen (source: "employee") eller af et hvilket som helst åbent vindue i appen, også dette (source: "page"). Returnerer en funktion, der stopper lytningen. |
Tegn igen, når dataene ændres, uanset hvem der ændrede 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();
}); Kun appens egen medarbejder når dette lager, og kun for sin egen app; en anden medarbejder spørger appens medarbejder. Vælg nøgler, som begge sider kan finde (én nøgle med en liste, eller én nøgle pr. post under et præfiks som deal:42), og beskriv dem i medarbejderens instruktioner. En streng, der selv er gyldig JSON, f.eks. "42", kommer tilbage fortolket, så pak den ind i et objekt, hvis typen betyder noget. Hold hver værdi et godt stykke under 2 MB; setItem kaster ikke en fejl, når en skrivning afvises.
agents
Spørg appens medarbejder eller en anden medarbejder, og få dens svar. At spørge en anden medarbejder 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;
} | Kald | Returnerer |
|---|---|
agents.invoke(message, {agent, data}) | {text, tools}, når medarbejderen er færdig. |
agents.stream(message, {agent, data}) | En asynkron iterator af {text, done}. |
janus
Et direkte modelkald uden persona, hukommelse eller værktøjer.
| Kald | Returnerer |
|---|---|
janus.complete({messages, model, temperature, max_tokens, system}) | Svarteksten som en streng. |
janus.stream(same) | En asynkron iterator af tekststykker. |
decide
Typede beslutninger: stil navngivne spørgsmål om nogle data, og få hvert svar tilbage med sandsynligheder og en sikkerhed, i ét hurtigt kald. Intet skrives som tekst, så brug det til vurderinger (er dette lead varmt, hvilken kategori hører denne sag til, hvor meget haster den), og hold optælling, datoer og tærskler i din egen kode. Appens medarbejder kan stille de samme spørgsmål med sit værktøj decide, for eksempel om appens gemte 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. | Spørgsmålstype | criteria | Svar |
|---|---|---|
choice | Et objekt med 2 til 255 navngivne muligheder, {option: description}. Tilføj en udvej som other, når listen ikke er komplet. | choice (den valgte mulighed), confidence (0 til 1) og probabilities pr. mulighed. |
score | En liste med 2 til 10 ordnede niveauer, laveste først. | score (decimaltal, 0 er det første niveau), confidence og probabilities pr. niveau. |
noul | Ingen: spørgsmålet er ét udsagn, der skal vurderes. | noul, sandsynligheden for, at udsagnet holder. Ingen separat sikkerhed. |
decide({state, questions})returnerer{model, answers, usage}, med hvert svar under det navn, du gav dets spørgsmål.stateer tekst eller enhver JSON. Begræns den til de felter, spørgsmålene har brug for, og navngiv de felter i backticks iinstructions. Hele spørgsmålet ligger iinstructions; spørgsmålets navn er kun en etiket på svaret. Meget lang state forkortes i midten, før den sendes.- Den kaster en fejl, hvis besked er årsagen. Fejlen har ingen statuskode, så sammenlign beskeden, hvis du skal kunne skelne tilfældene fra hinanden:
- Et forkert udformet spørgsmål, for eksempel et valg med kun én mulighed (botten svarer 400 med, hvad der er galt).
- Intet arbejde tilbage på ejerens konto: "You've used all the work included in your account. Choose a plan or add credits to continue." (429). Det hjælper ikke at prøve igen, før ejeren tilføjer en plan eller kredit.
- For mange beslutninger på én gang: "Too many decisions at once. Try again in a moment." (429).
- Botten er ikke logget ind: "Decisions need NeboAI connected. Sign in to NeboAI and try again." (503).
- Beslutningstjenesten fejlede (502).
- Beslutninger faktureres til bottens ejers NeboAI-konto som ethvert andet modelkald. 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 absolut http- eller https-URL går gennem Nebos proxy og kræver network:<host> eller network:*.
NeboWebSocket
new NeboAppSDK.NeboWebSocket() åbner en direkte socket til appens medarbejder og forbinder igen med backoff. Den tager ingen argumenter og har send(data), close(), onopen, onmessage, onerror og onclose.
surfaces og a2ui
surfaces.connect() åbner appens direkte kanal. I dag bærer den interaktive kort fra appens medarbejder: kald a2ui.init(processor) med en MessageProcessor fra @a2ui/web_core, som din side bundter (SDK'et har ingen egen renderer). Et kort når kun den app, det blev lavet til, et klik på det går til den apps medarbejder, og en side, der åbnes efter at et kort blev sendt, modtager det ikke, så gem det, siden altid skal vise, i storage.
SDK'et definerer også typede hændelser som text_content, state_delta og surface_update, med surfaces.on(type, handler), surfaces.send(name, payload) og surfaces.state. Nebo sender endnu ikke de hændelser til appsider, og intet svarer på send. Til direkte data skal du bruge storage.onChange.
chat
Indlejr Nebos chat med appens medarbejder på siden.
NeboAppSDK.chat.mount(document.getElementById('chat'), {
placeholder: 'Ask about a deal',
contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' }); | Kald | Adfærd |
|---|---|
chat.mount(element, options) | Valg: placeholder, theme, height, borderless, contextId, scope. |
chat.send(text) | Sender en besked. |
chat.setContext(context) | Angiver den kontekst, medarbejderen ser; null rydder den. |
chat.onMessage(handler) | Modtager beskeder. |
chat.newThread() | Starter en ny tråd. |
chat.unmount() | Fjerner chatten. |
Konfiguration
Inde i Nebo finder SDK'et selv app-id'et og base-URL'en. For en side, der serveres et andet sted, skal du kalde nebo.configure({appId, baseUrl}) eller NeboAppSDK.setAppId(id) og NeboAppSDK.setBaseUrl(url). getAppId() og getBaseUrl() læser dem tilbage.