I-load ang SDK
<script src="/sdk/nebo.global.js"></script>
<script>
const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script> Ang global ay NeboAppSDK; walang nebo global. Ang NeboAppSDK.nebo ang SDK instance, at ine-export din sa top level ang bawat module, kaya iisang object ang NeboAppSDK.storage at NeboAppSDK.nebo.storage. Para hindi matabunan ang browser, ine-export ang nebo.fetch bilang neboFetch at ang nebo.WebSocket bilang NeboWebSocket.
identity
| Tawag | Ibinabalik |
|---|---|
identity.get() | {id, name, displayName, description, persona, model, skills, inputValues} para sa empleyado ng app. Naka-cache. |
identity.invalidate() | Nililinis ang cache. |
storage
Isang key-value store para sa app. Kailangan nito ng storage:readwrite. Ito rin ang store na binabasa at binabago ng empleyado ng app: lumalabas sa pahina ang record na idinagdag ng may-ari sa pakikipag-usap sa empleyado, at ang na-type sa pahina ay mahahanap ng empleyado.
const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals); | Tawag | Kilos |
|---|---|
storage.getItem(key) | Eksakto kung ano ang inimbak ng setItem (object, list, number o string), o null. |
storage.setItem(key, value) | Iniimbak ang kahit anong JSON value. |
storage.removeItem(key) | Inaalis ang isang key; hindi na ito lalabas sa keys(). |
storage.keys() | Lahat ng key. |
storage.clear() | Inaalis ang bawat key. |
storage.onChange(handler) | Tinatawag ang handler({appId, keys, action, source}) pagkatapos ng bawat pagsulat, ng empleyado (source: "employee") o ng kahit anong bukas na window ng app, kasama ito (source: "page"). Nagbabalik ng function na humihinto sa pakikinig. |
I-redraw kapag nagbago ang data, sinuman ang nagbago nito:
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();
}); Ang sariling empleyado lang ng app ang nakakaabot sa store na ito, at para lang sa sarili nitong app; nagtatanong ang ibang empleyado sa empleyado ng app. Pumili ng mga key na mahahanap ng dalawang panig (isang key na may hawak na listahan, o isang key bawat record sa ilalim ng prefix gaya ng deal:42) at ilarawan ang mga ito sa mga tagubilin ng empleyado. Ang string na mismong balidong JSON, gaya ng "42", ay bumabalik na naka-parse, kaya ibalot ito sa isang object kung mahalaga ang uri. Panatilihing mas mababa nang malaki sa 2 MB ang bawat value; hindi nagtatapon ng error ang setItem kapag tinanggihan ang isang pagsulat.
agents
Magtanong sa empleyado ng app, o sa ibang empleyado, at makuha ang sagot nito. Kailangan ng subagent:<employee-id> para magtanong sa ibang empleyado.
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;
} | Tawag | Ibinabalik |
|---|---|
agents.invoke(message, {agent, data}) | {text, tools} kapag tapos na ang empleyado. |
agents.stream(message, {agent, data}) | Isang async iterator ng {text, done}. |
janus
Isang direktang model call na walang persona, memory o tool.
| Tawag | Ibinabalik |
|---|---|
janus.complete({messages, model, temperature, max_tokens, system}) | Ang text ng sagot bilang string. |
janus.stream(same) | Isang async iterator ng mga text chunk. |
decide
Mga typed decision: magtanong ng mga may-pangalang tanong tungkol sa ilang data at makuha ang bawat sagot na may mga probability at confidence, sa iisang mabilis na tawag. Walang isinusulat bilang text, kaya gamitin ito para sa mga paghuhusga (mainit ba ang lead na ito, saang kategorya kabilang ang ticket na ito, gaano ito ka-urgent) at panatilihin sa sarili mong code ang pagbibilang, mga petsa at mga threshold. Maitatanong din ng empleyado ng app ang parehong mga tanong gamit ang decide tool nito, halimbawa sa mga nakaimbak na record ng app.
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. | Uri ng tanong | criteria | Sagot |
|---|---|---|
choice | Isang object ng 2 hanggang 255 may-pangalang opsyon, {option: description}. Magdagdag ng escape option gaya ng other kapag hindi kumpleto ang listahan. | choice (ang napiling opsyon), confidence (0 hanggang 1) at probabilities bawat opsyon. |
score | Isang listahan ng 2 hanggang 10 nakaayos na antas, pinakamababa ang una. | score (fractional, 0 ang unang antas), confidence at probabilities bawat antas. |
noul | Wala: isang pahayag na huhusgahan ang tanong. | noul, ang probability na totoo ang pahayag. Walang hiwalay na confidence. |
- Nagre-resolve ang
decide({state, questions})sa{model, answers, usage}, at nasa ilalim ng pangalang ibinigay mo sa bawat tanong ang sagot nito. - Text o kahit anong JSON ang
state. Limitahan ito sa mga field na kailangan ng mga tanong at pangalanan ang mga field na iyon sa backticks sa loob nginstructions. Nasainstructionsang buong tanong; label lang ng sagot ang pangalan ng tanong. Pinaiikli sa gitna ang napakahabang state bago ito ipadala. - Nagto-throw ito ng error na ang mensahe ay ang dahilan. Walang status code ang error, kaya ihambing ang mensahe kung kailangan mong paghiwalayin ang mga kaso:
- Isang maling tanong, halimbawa isang choice na may iisang opsyon (sumasagot ang bot ng 400, kasama kung ano ang mali).
- Wala nang natitirang trabaho sa account ng may-ari: "You've used all the work included in your account. Choose a plan or add credits to continue." (429). Hindi makakatulong ang pag-ulit hangga’t hindi nagdadagdag ang may-ari ng plan o credit.
- Sobrang daming desisyon nang sabay: "Too many decisions at once. Try again in a moment." (429).
- Hindi naka-sign in ang bot: "Decisions need NeboAI connected. Sign in to NeboAI and try again." (503).
- Pumalya ang decision service (502).
- Sinisingil ang mga desisyon sa NeboAI account ng may-ari ng bot gaya ng anumang model call. Tingnan ang pricing.
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'); Napupunta ang relative path sa sidecar ng app sa /apps/<id>/api/<path>. Dumadaan sa proxy ng Nebo ang absolute na http o https URL at nangangailangan ng network:<host> o network:*.
NeboWebSocket
Nagbubukas ang new NeboAppSDK.NeboWebSocket() ng live socket sa empleyado ng app at muling kumokonekta nang may backoff. Wala itong tinatanggap na argument at may send(data), close(), onopen, onmessage, onerror at onclose.
surfaces at a2ui
Binubuksan ng surfaces.connect() ang live channel ng app. Sa ngayon, nagdadala ito ng mga interactive card mula sa empleyado ng app: tawagin ang a2ui.init(processor) gamit ang isang MessageProcessor mula sa @a2ui/web_core, na isinasama ng pahina mo sa bundle nito (walang sariling renderer ang SDK). Ang card ay nakakarating lang sa app na pinaggawaan nito, napupunta sa empleyado ng app na iyon ang click dito, at hindi ito natatanggap ng pahinang binuksan pagkatapos maipadala ang card, kaya ilagay sa storage ang dapat laging ipakita ng pahina.
Nagtatakda rin ang SDK ng mga typed event gaya ng text_content, state_delta at surface_update, kasama ang surfaces.on(type, handler), surfaces.send(name, payload) at surfaces.state. Hindi pa ipinapadala ng Nebo ang mga event na iyon sa mga pahina ng app, at walang sumasagot sa send. Para sa live na data, gamitin ang storage.onChange.
chat
I-embed sa pahina ang chat ng Nebo kasama ang empleyado ng app.
NeboAppSDK.chat.mount(document.getElementById('chat'), {
placeholder: 'Ask about a deal',
contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' }); | Tawag | Kilos |
|---|---|
chat.mount(element, options) | Mga opsyon: placeholder, theme, height, borderless, contextId, scope. |
chat.send(text) | Nagpapadala ng mensahe. |
chat.setContext(context) | Itinatakda ang context na nakikita ng empleyado; nililinis ito ng null. |
chat.onMessage(handler) | Tumatanggap ng mga mensahe. |
chat.newThread() | Nagsisimula ng bagong thread. |
chat.unmount() | Inaalis ang chat. |
Configuration
Sa loob ng Nebo, kusang nahahanap ng SDK ang app id at base URL. Para sa page na sine-serve sa ibang lugar, tawagin ang nebo.configure({appId, baseUrl}), o ang NeboAppSDK.setAppId(id) at NeboAppSDK.setBaseUrl(url). Binabasa ulit ng getAppId() at getBaseUrl() ang mga ito.