Emyenyhẽ SDK
<script src="/sdk/nebo.global.js"></script>
<script>
const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script> Global ha'e NeboAppSDK; ndaipóri global nebo. NeboAppSDK.nebo ha'e SDK instancia, ha opaite módulo oñemoherakuã avei nivel yvatetépe, upévare NeboAppSDK.storage ha NeboAppSDK.nebo.storage ha'e upe objeto voi. Ani hag̃ua ojaho'i navegador, nebo.fetch oñemoherakuã neboFetch ramo ha nebo.WebSocket NeboWebSocket ramo.
identity
| Ñehenói | Ome'ẽ jey |
|---|---|
identity.get() | {id, name, displayName, description, persona, model, skills, inputValues} aplicación mba'apohárape g̃uarã. Caché-pe. |
identity.invalidate() | Omopotĩ caché. |
storage
Peteĩ ñeñongatu llave-valor aplicación-pe g̃uarã. Oikotevẽ storage:readwrite. Ha'e upe ñeñongatu voi aplicación mba'apohára omoñe'ẽ ha omoambuéva: peteĩ registro jára ombojoapýva oñe'ẽvo mba'apohára ndive ojehecha kuatiaroguépe, ha peteĩ ojehaíva kuatiaroguépe mba'apohára ikatu ojuhu.
const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals); | Ñehenói | Reko |
|---|---|
storage.getItem(key) | Pe setItem oñongatuva'ekue voi (objeto, lísta, papapy térã string), térã null. |
storage.setItem(key, value) | Oñongatu oimeraẽ valor JSON. |
storage.removeItem(key) | Ombogue peteĩ llave; ndojehechavéi keys()-pe. |
storage.keys() | Opaite llave. |
storage.clear() | Ombogue opaite llave. |
storage.onChange(handler) | Ohenói handler({appId, keys, action, source}) opaite jehai rire, mba'apohára (source: "employee") térã oimeraẽ aplicación ventana ijurujáva, kóva jepe (source: "page"). Ome'ẽ jey peteĩ función ojokóva ñehendu. |
Ehai jey marandu oñemoambue jave, oimeraẽva omoambue jepe:
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();
}); Aplicación mba'apohára ae añoite og̃uahẽ ko ñeñongatúpe, ha iaplicación ae-pe g̃uarã añoite; ambue mba'apohára oporandu aplicación mba'apohárape. Eiporavo llave mokõive pehẽ ikatúva ojuhu (peteĩ llave oguerekóva peteĩ lísta, térã peteĩ llave peteĩteĩ registro-pe peteĩ ñepyrũrã guýpe ha'eháicha deal:42) ha emombe'u mba'apohára mbo'epýpe. Peteĩ string ha'éva JSON hekopegua, ha'eháicha "42", ou jey oñemyesakãmava, upévare ejaho'i peteĩ objeto-pe mba'eichagua iñimportánteramo. Peteĩteĩ valor tomichĩve 2 MB-gui; setItem nomombo'ýi jejavy peteĩ jehai oñemboyke jave.
agents
Eporandu aplicación mba'apohárape, térã ambue mba'apohárape, ha ehupyty imbohovái. Ambue mba'apohárape ñeporandu oikotevẽ 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;
} | Ñehenói | Ome'ẽ jey |
|---|---|
agents.invoke(message, {agent, data}) | {text, tools} mba'apohára opa vove. |
agents.stream(message, {agent, data}) | Peteĩ async iterator {text, done} rehegua. |
janus
Peteĩ modelo ñehenói voi teko, mandu'a ni tembiporu'ỹre.
| Ñehenói | Ome'ẽ jey |
|---|---|
janus.complete({messages, model, temperature, max_tokens, system}) | Mbohovái jehaipy string ramo. |
janus.stream(same) | Peteĩ async iterator jehaipy pehẽ rehegua. |
decide
Jeporavo mba'eichagua reheve: ejapo porandu héra reheve peteĩ marandu rehe ha ehupyty peteĩteĩ mbohovái probabilidad ha jerovia reheve, peteĩ ñehenói pya'épe. Mba'eve ndojehaíri jehaipy ramo, upévare eipuru jepy'amongetarã (ko cliente ikatúva ipy'aku'ípa, mba'e mba'e ñemohendápe oĩ ko ticket, mboýpa ipya'e) ha eñongatu papapy, ára ha rapykuere nde código-pe. Aplicación mba'apohára ikatu ojapo upe porandu voi itembiporu decide reheve, techapyrã aplicación registro oñeñongatúvare.
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. | Porandu mba'eichagua | criteria | Mbohovái |
|---|---|---|
choice | Peteĩ objeto 2 guive 255 peve opción héra reheve, {option: description}. Embojoapy peteĩ opción jesẽrã ha'eháicha other lísta ndahenyhẽiramo. | choice (opción ojeporavóva), confidence (0 guive 1 peve) ha probabilities peteĩteĩ opción-pe. |
score | Peteĩ lísta 2 guive 10 peve nivel oñemohendáva, michĩvéva raẽ. | score (fraccional, 0 ha'e peteĩha nivel), confidence ha probabilities peteĩteĩ nivel-pe. |
noul | Ndaipóri: porandu ha'e peteĩ ñe'ẽ ojehesa'ỹijótava. | noul, probabilidad pe ñe'ẽ añeteha. Ndaipóri jerovia ojeipe'áva. |
decide({state, questions})ome'ẽ{model, answers, usage}, peteĩteĩ mbohovái oĩva téra reme'ẽva iporandúpe guýpe.stateha'e jehaipy térã oimeraẽ JSON. Eñongatu umi campo porandu oikotevẽva añoite ha ehai ko'ã campo réra backtick-peinstructionsryepýpe. Opaite porandu oikoinstructions-pe; porandu réra ome'ẽ téra mbohováipe añoite. State ipukueterei oñemombyky mbytépe oñemondo mboyve.- Omombo peteĩ jejavy imarandu ha'éva mba'érepa. Pe jejavy ndoguerekói status code, upévare embojoja pe marandu reikotevẽramo rehechakuaa umi caso:
- Peteĩ porandu ojejapo vaíva, techapyrã peteĩ choice peteĩ opción añoite reheve (bot ombohovái 400, mba'épa ndoikói reheve).
- Ndaipóri tembiapo opytáva jára kuéntape: "Reiporupáma opa tembiapo oĩva ne kuéntape. Eiporavo peteĩ plan térã embojoapy crédito resegi hag̃ua." (429). Ñeha'ã jey nopytyvõi jára ombojoapy peve peteĩ plan térã crédito.
- Hetaiterei jeporavo peteĩ jave: "Hetaiterei jeporavo peteĩ jave. Eñeha'ã jey sapy'ami." (429).
- Bot ndoikéi: "Jeporavo oikotevẽ NeboAI ojoaju. Eike NeboAI-pe ha eñeha'ã jey." (503).
- Jeporavo servicio ndoikói (502).
- Jeporavo ojecobra bot jára kuénta NeboAI-pe oimeraẽ modelo ñehenóicha. Ehecha hepykuéra.
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'); Peteĩ rape relativo oho aplicación sidecar-pe /apps/<id>/api/<path>-pe. Peteĩ URL absoluto http térã https ohasa Nebo proxy rupi ha oikotevẽ network:<host> térã network:*.
NeboWebSocket
new NeboAppSDK.NeboWebSocket() oipe'a peteĩ socket ko'ag̃aitegua aplicación mba'apohára ndive ha ojoaju jey backoff reheve. Ndohupytýi argumento ha oguereko send(data), close(), onopen, onmessage, onerror ha onclose.
surfaces ha a2ui
surfaces.connect() oipe'a aplicación canal ko'ag̃aitegua. Ko'ag̃a ogueraha tarjeta ojeporu ojuehéva aplicación mba'apohára mba'e: ehenói a2ui.init(processor) peteĩ MessageProcessor @a2ui/web_core-gui reheve, nde kuatiarogue ombyatýva (SDK ndoguerekói renderer ijehegui). Peteĩ tarjeta og̃uahẽ pe aplicación ojejapo haguépe g̃uarã añoite, peteĩ clic hese oho upe aplicación mba'apohárape, ha peteĩ kuatiarogue ojepe'áva peteĩ tarjeta oñemondo rire ndohupytýi, upévare eñongatu storage-pe pe kuatiarogue ohechaukava'erã akóinte.
SDK omoha'ãnga avei jehu mba'eichagua reheve ha'eháicha text_content, state_delta ha surface_update, surfaces.on(type, handler), surfaces.send(name, payload) ha surfaces.state ndive. Nebo nomondói gueteri ko'ã jehu aplicación kuatiaroguépe, ha mba'eve ndombohováii send. Marandu ko'ag̃aiteguápe g̃uarã, eipuru storage.onChange.
chat
Emoinge Nebo chat aplicación mba'apohára ndive kuatiaroguépe.
NeboAppSDK.chat.mount(document.getElementById('chat'), {
placeholder: 'Ask about a deal',
contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' }); | Ñehenói | Reko |
|---|---|
chat.mount(element, options) | Opción: placeholder, theme, height, borderless, contextId, scope. |
chat.send(text) | Omondo peteĩ ñe'ẽmondo. |
chat.setContext(context) | Omoĩ tekoha mba'apohára ohecháva; null omopotĩ. |
chat.onMessage(handler) | Ohupyty ñe'ẽmondo. |
chat.newThread() | Oñepyrũ peteĩ hilo pyahu. |
chat.unmount() | Ombogue chat. |
Ñemboheko
Nebo ryepýpe, SDK ojuhu ijehegui app id ha base URL. Peteĩ pagina oñeme'ẽvape ambue hendápe, ehenói nebo.configure({appId, baseUrl}), térã NeboAppSDK.setAppId(id) ha NeboAppSDK.setBaseUrl(url). getAppId() ha getBaseUrl() omoñe'ẽjey umíva.