NeboAI
NeboAI
Eñepyrũ

App SDK

App SDK ombojoaju peteĩ aplicación kuatiarogue Nebo ndive. Ha'e peteĩ script Nebo ome'ẽva opaite aplicación-pe, ha omoĩ peteĩ global añoite kuatiaroguépe, NeboAppSDK. Ndaipóri mba'eve remoĩ térã remopu'ã hag̃ua.

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óiOme'ẽ 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óiReko
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óiOme'ẽ 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óiOme'ẽ 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'eichaguacriteriaMbohovái
choicePeteĩ 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.
scorePeteĩ 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.
noulNdaipó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.
  • state ha'e jehaipy térã oimeraẽ JSON. Eñongatu umi campo porandu oikotevẽva añoite ha ehai ko'ã campo réra backtick-pe instructions ryepýpe. Opaite porandu oiko instructions-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óiReko
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.