Încarcă SDK-ul
<script src="/sdk/nebo.global.js"></script>
<script>
const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script> Obiectul global este NeboAppSDK; nu există un global nebo. NeboAppSDK.nebo este instanța SDK, iar fiecare modul e exportat și la nivelul de sus, așa că NeboAppSDK.storage și NeboAppSDK.nebo.storage sunt același obiect. Ca să nu umbrească funcțiile browserului, nebo.fetch e exportat ca neboFetch, iar nebo.WebSocket ca NeboWebSocket.
identity
| Apel | Returnează |
|---|---|
identity.get() | {id, name, displayName, description, persona, model, skills, inputValues} pentru angajatul aplicației. Păstrat în cache. |
identity.invalidate() | Golește memoria cache. |
storage
Un depozit cheie-valoare pentru aplicație. Are nevoie de storage:readwrite. Este același depozit pe care îl citește și îl modifică angajatul aplicației: o înregistrare adăugată de proprietar vorbind cu angajatul apare pe pagină, iar una introdusă în pagină poate fi găsită de angajat.
const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals); | Apel | Comportament |
|---|---|
storage.getItem(key) | Exact ce a stocat setItem (obiect, listă, număr sau șir) sau null. |
storage.setItem(key, value) | Stochează orice valoare JSON. |
storage.removeItem(key) | Elimină o cheie; nu mai apare în keys(). |
storage.keys() | Toate cheile. |
storage.clear() | Elimină toate cheile. |
storage.onChange(handler) | Apelează handler({appId, keys, action, source}) după fiecare scriere, făcută de angajat (source: "employee") sau de orice fereastră deschisă a aplicației, inclusiv aceasta (source: "page"). Returnează o funcție care oprește ascultarea. |
Redesenează când se schimbă datele, indiferent cine le-a schimbat:
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();
}); Doar angajatul aplicației ajunge la acest depozit și doar pentru propria aplicație; un alt angajat îl întreabă pe angajatul aplicației. Alege chei pe care le pot găsi ambele părți (o cheie care conține o listă sau câte o cheie pentru fiecare înregistrare, sub un prefix precum deal:42) și descrie-le în instrucțiunile angajatului. Un șir care este el însuși JSON valid, de exemplu "42", se întoarce parsat, așa că încapsulează-l într-un obiect dacă tipul contează. Păstrează fiecare valoare cu mult sub 2 MB; setItem nu aruncă o excepție când o scriere e refuzată.
agents
Întreabă-l pe angajatul aplicației sau pe un alt angajat și primește răspunsul. Ca să întrebi un alt angajat, ai nevoie de 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;
} | Apel | Returnează |
|---|---|
agents.invoke(message, {agent, data}) | {text, tools} când angajatul termină. |
agents.stream(message, {agent, data}) | Un iterator asincron de {text, done}. |
janus
Un apel direct către model, fără persona, memorie sau instrumente.
| Apel | Returnează |
|---|---|
janus.complete({messages, model, temperature, max_tokens, system}) | Textul răspunsului, ca șir. |
janus.stream(same) | Un iterator asincron de fragmente de text. |
decide
Decizii tipizate: pui întrebări cu nume despre niște date și primești fiecare răspuns cu probabilități și un nivel de încredere, într-un singur apel rapid. Nu se scrie nimic ca text, așa că folosește-l pentru judecăți (e acest client potențial fierbinte, din ce categorie face parte acest tichet, cât de urgent e) și păstrează numărătorile, datele și pragurile în propriul cod. Angajatul aplicației poate pune aceleași întrebări cu instrumentul lui decide, de exemplu asupra înregistrărilor stocate ale aplicației.
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. | Tipul întrebării | criteria | Răspuns |
|---|---|---|
choice | Un obiect cu 2 până la 255 de opțiuni cu nume, {option: description}. Adaugă o opțiune de rezervă, precum other, când lista nu e completă. | choice (opțiunea aleasă), confidence (de la 0 la 1) și probabilities pentru fiecare opțiune. |
score | O listă de 2 până la 10 niveluri ordonate, de la cel mai scăzut. | score (fracționar, 0 este primul nivel), confidence și probabilities pentru fiecare nivel. |
noul | Niciunul: întrebarea este o singură afirmație de judecat. | noul, probabilitatea ca afirmația să fie adevărată. Fără nivel de încredere separat. |
decide({state, questions})returnează{model, answers, usage}, cu fiecare răspuns sub numele pe care l-ai dat întrebării lui.stateeste text sau orice JSON. Limitează-l la câmpurile de care au nevoie întrebările și numește acele câmpuri între backticks îninstructions. Toată întrebarea stă îninstructions; numele întrebării doar etichetează răspunsul. O stare foarte lungă e scurtată la mijloc înainte să fie trimisă.- Aruncă o eroare al cărei mesaj este motivul. Eroarea nu are cod de stare, așa că compară mesajul dacă trebuie să deosebești cazurile:
- O întrebare formulată greșit, de exemplu o alegere cu o singură opțiune (botul răspunde cu 400 și spune ce e greșit).
- Nu mai e muncă disponibilă în contul proprietarului: „You've used all the work included in your account. Choose a plan or add credits to continue.” (429). Reîncercarea nu ajută până când proprietarul nu adaugă un plan sau credit.
- Prea multe decizii deodată: „Too many decisions at once. Try again in a moment.” (429).
- Botul nu e autentificat: „Decisions need NeboAI connected. Sign in to NeboAI and try again.” (503).
- Serviciul de decizii a eșuat (502).
- Deciziile sunt facturate în contul NeboAI al proprietarului botului, ca orice apel către model. Vezi prețurile.
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'); O cale relativă ajunge la sidecarul aplicației, la /apps/<id>/api/<path>. Un URL absolut http sau https trece prin proxyul lui Nebo și are nevoie de network:<host> sau network:*.
NeboWebSocket
new NeboAppSDK.NeboWebSocket() deschide un socket live către angajatul aplicației și se reconectează cu backoff. Nu primește argumente și are send(data), close(), onopen, onmessage, onerror și onclose.
surfaces și a2ui
surfaces.connect() deschide canalul live al aplicației. Astăzi transportă carduri interactive de la angajatul aplicației: apelează a2ui.init(processor) cu un MessageProcessor din @a2ui/web_core, pe care pagina ta îl include în bundle (SDK-ul nu are un renderer propriu). Un card ajunge doar la aplicația pentru care a fost creat, un clic pe el ajunge la angajatul acelei aplicații, iar o pagină deschisă după ce a fost trimis un card nu îl primește, așa că păstrează în storage ce trebuie să arate pagina întotdeauna.
SDK-ul definește și evenimente tipizate, precum text_content, state_delta și surface_update, cu surfaces.on(type, handler), surfaces.send(name, payload) și surfaces.state. Nebo nu trimite încă aceste evenimente către paginile aplicațiilor și nimic nu răspunde la send. Pentru date live, folosește storage.onChange.
chat
Încorporează în pagină chatul Nebo cu angajatul aplicației.
NeboAppSDK.chat.mount(document.getElementById('chat'), {
placeholder: 'Ask about a deal',
contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' }); | Apel | Comportament |
|---|---|
chat.mount(element, options) | Opțiuni: placeholder, theme, height, borderless, contextId, scope. |
chat.send(text) | Trimite un mesaj. |
chat.setContext(context) | Setează contextul pe care îl vede angajatul; null îl golește. |
chat.onMessage(handler) | Primește mesaje. |
chat.newThread() | Începe un fir nou. |
chat.unmount() | Elimină chatul. |
Configurare
În Nebo, SDK-ul găsește singur ID-ul aplicației și URL-ul de bază. Pentru o pagină servită în altă parte, apelează nebo.configure({appId, baseUrl}) sau NeboAppSDK.setAppId(id) și NeboAppSDK.setBaseUrl(url). getAppId() și getBaseUrl() le citesc înapoi.