NeboAI
NeboAI
ይጀምሩ

የመተግበሪያ SDK

የመተግበሪያ SDK የመተግበሪያን ገጽ ከNebo ጋር ያገናኛል። Nebo ለእያንዳንዱ መተግበሪያ የሚያቀርበው አንድ ስክሪፕት ነው፣ በገጹ ላይም አንድ global፣ NeboAppSDK፣ ያስቀምጣል። የሚጫን ወይም የሚገነባ ምንም ነገር የለም።

SDKውን ይጫኑ

<script src="/sdk/nebo.global.js"></script>
<script>
  const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script>

globalው NeboAppSDK ነው፤ nebo global የለም። NeboAppSDK.nebo የSDK ቅጂው ነው፣ እያንዳንዱ ሞጁልም በከፍተኛው ደረጃ ይላካል፣ ስለዚህ NeboAppSDK.storage እና NeboAppSDK.nebo.storage አንድ ነገር ናቸው። አሳሹን ላለመሸፈን nebo.fetch እንደ neboFetch፣ nebo.WebSocket ደግሞ እንደ NeboWebSocket ይላካሉ።

identity

ጥሪየሚመልሰው
identity.get()ለመተግበሪያው ሰራተኛ {id, name, displayName, description, persona, model, skills, inputValues}። በማቆያ ውስጥ ይቀመጣል።
identity.invalidate()ማቆያውን (cache) ያጸዳል።

storage

ለመተግበሪያው የቁልፍ-እሴት ማከማቻ። storage:readwrite ያስፈልገዋል። የመተግበሪያው ሰራተኛ የሚያነበውና የሚለውጠው ያው ማከማቻ ነው፤ ባለቤቱ ሰራተኛውን በማነጋገር የሚያክለው መዝገብ በገጹ ላይ ይታያል፣ በገጹ ላይ የተተየበውም ሰራተኛው ሊያገኘው የሚችለው ነው።

const deals = (await NeboAppSDK.storage.getItem('deals')) ?? [];
deals.push({ name: 'Example renewal', closes: '2026-10-31' });
await NeboAppSDK.storage.setItem('deals', deals);
ጥሪባህሪ
storage.getItem(key)setItem ያከማቸውን በትክክል (ነገር፣ ዝርዝር፣ ቁጥር ወይም ሕብረ ቁምፊ)፣ ወይም null።
storage.setItem(key, value)ማንኛውንም የJSON እሴት ያከማቻል።
storage.removeItem(key)አንድ ቁልፍ ያስወግዳል፤ ከእንግዲህ በkeys() ውስጥ አይታይም።
storage.keys()ሁሉም ቁልፎች።
storage.clear()እያንዳንዱን ቁልፍ ያስወግዳል።
storage.onChange(handler)ከእያንዳንዱ መጻፍ በኋላ handler({appId, keys, action, source})ን ይጠራል፤ በሰራተኛው (source: "employee") ወይም በማንኛውም የተከፈተ የመተግበሪያው መስኮት፣ ይህኛውንም ጨምሮ (source: "page")። ማዳመጥን የሚያቆም ተግባር ይመልሳል።

ውሂቡ ሲለወጥ፣ ማንም ቢለውጠው፣ እንደገና ይሳሉ፡

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();
});

ይህን ማከማቻ የሚደርሰው የመተግበሪያው የራሱ ሰራተኛ ብቻ ነው፣ ለራሱ መተግበሪያ ብቻም፤ ሌላ ሰራተኛ የመተግበሪያውን ሰራተኛ ይጠይቃል። ሁለቱም ወገኖች ሊያገኟቸው የሚችሉ ቁልፎችን ይምረጡ (ዝርዝር የሚይዝ አንድ ቁልፍ፣ ወይም እንደ deal:42 ባለ ቅድመ ቅጥያ ስር ለእያንዳንዱ መዝገብ አንድ ቁልፍ)፣ በሰራተኛው መመሪያዎች ውስጥም ይግለጹዋቸው። ራሱ ትክክለኛ JSON የሆነ ሕብረ ቁምፊ፣ ለምሳሌ "42"፣ ተተንትኖ ይመለሳል፣ ስለዚህ ዓይነቱ አስፈላጊ ከሆነ በነገር ውስጥ ይጠቅልሉት። እያንዳንዱን እሴት ከ2 MB በጣም በታች ያድርጉት፤ መጻፍ ውድቅ ሲደረግ setItem ስህተት አይጥልም።

agents

የመተግበሪያውን ሰራተኛ ወይም ሌላ ሰራተኛ ይጠይቁና መልሱን ያግኙ። ሌላ ሰራተኛን መጠየቅ 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;
}
ጥሪየሚመልሰው
agents.invoke(message, {agent, data})ሰራተኛው ሲጨርስ {text, tools}።
agents.stream(message, {agent, data})የ{text, done} async iterator።

janus

ስብዕና፣ ትውስታ ወይም መሣሪያዎች የሌሉት ቀጥተኛ የሞዴል ጥሪ።

ጥሪየሚመልሰው
janus.complete({messages, model, temperature, max_tokens, system})የምላሹ ጽሑፍ እንደ ሕብረ ቁምፊ።
janus.stream(same)የጽሑፍ ቁራጮች async iterator።

decide

በዓይነት የተለዩ ውሳኔዎች፤ ስለ አንዳንድ ውሂብ የተሰየሙ ጥያቄዎችን ይጠይቁና እያንዳንዱን መልስ ከዕድሎችና ከእርግጠኝነት ጋር በአንድ ፈጣን ጥሪ ያግኙ። ምንም ነገር እንደ ጽሑፍ አይጻፍም፣ ስለዚህ ለፍርዶች ይጠቀሙበት (ይህ የደንበኛ ዕጩ ትኩስ ነው ወይ፣ ይህ ቲኬት የየትኛው ምድብ ነው፣ ምን ያህል አስቸኳይ ነው)፣ መቁጠርን፣ ቀኖችንና ገደቦችን ግን በራስዎ ኮድ ውስጥ ያቆዩ። የመተግበሪያው ሰራተኛ ያንኑ ጥያቄ በdecide መሣሪያው መጠየቅ ይችላል፣ ለምሳሌ በመተግበሪያው በተከማቹ መዝገቦች ላይ።

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.
የጥያቄ ዓይነትcriteriaመልስ
choiceከ2 እስከ 255 የተሰየሙ አማራጮች ያሉት ነገር፣ {option: description}። ዝርዝሩ ያልተሟላ ሲሆን እንደ other ያለ የማምለጫ አማራጭ ያክሉ።choice (የተመረጠው አማራጭ)፣ confidence (ከ0 እስከ 1) እና ለእያንዳንዱ አማራጭ probabilities።
scoreከ2 እስከ 10 የተደረደሩ ደረጃዎች ዝርዝር፣ ዝቅተኛው መጀመሪያ።score (ክፍልፋይ፣ 0 የመጀመሪያው ደረጃ ነው)፣ confidence እና ለእያንዳንዱ ደረጃ probabilities።
noulየለም፤ ጥያቄው የሚፈረድበት አንድ መግለጫ ነው።noul፣ መግለጫው እውነት የመሆኑ ዕድል። የተለየ እርግጠኝነት የለም።
  • decide({state, questions}) ወደ {model, answers, usage} ይፈታል፤ እያንዳንዱ መልስ ለጥያቄው በሰጡት ስም ስር ይገኛል።
  • state ጽሑፍ ወይም ማንኛውም JSON ነው። ጥያቄዎቹ በሚያስፈልጓቸው መስኮች ብቻ ይገድቡት፣ እነዚያንም መስኮች በinstructions ውስጥ በbackticks ይሰይሟቸው። ሙሉው ጥያቄ የሚኖረው በinstructions ውስጥ ነው፤ የጥያቄው ስም መልሱን መሰየም ብቻ ነው። በጣም ረጅም state ከመላኩ በፊት በመሃሉ ይታጠራል።
  • መልዕክቱ ምክንያቱ የሆነ ስህተት ይወረውራል። ስህተቱ የሁኔታ ኮድ የለውም፣ ስለዚህ ጉዳዮቹን መለየት ካስፈለገዎት መልዕክቱን ያወዳድሩ፦
    • የተበላሸ ጥያቄ፣ ለምሳሌ አንድ አማራጭ ብቻ ያለው ምርጫ (ቦቱ ምን እንደተሳሳተ ገልጾ 400 ይመልሳል)።
    • በባለቤቱ መለያ ላይ የቀረ ሥራ የለም፡ "በመለያዎ ውስጥ የተካተተውን ሥራ ሁሉ ተጠቅመዋል። ለመቀጠል እቅድ ይምረጡ ወይም ክሬዲቶችን ያክሉ።" (429)። ባለቤቱ እቅድ ወይም ክሬዲቶችን እስኪያክል ድረስ እንደገና መሞከር አይረዳም።
    • በአንድ ጊዜ በጣም ብዙ ውሳኔዎች፡ "በአንድ ጊዜ በጣም ብዙ ውሳኔዎች። ትንሽ ቆይተው እንደገና ይሞክሩ።" (429)።
    • ቦቱ አልገባም፡ "ውሳኔዎች NeboAI እንዲገናኝ ይፈልጋሉ። ወደ NeboAI ይግቡና እንደገና ይሞክሩ።" (503)።
    • የውሳኔ አገልግሎቱ አልተሳካም (502)።
  • ውሳኔዎች ልክ እንደማንኛውም የሞዴል ጥሪ ለቦቱ ባለቤት የNeboAI መለያ ይከፈላሉ። ዋጋዎችን ይመልከቱ።

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');

አንጻራዊ ዱካ በ/apps/<id>/api/<path> ወደ መተግበሪያው sidecar ይሄዳል። ፍጹም የhttp ወይም የhttps URL በNebo proxy በኩል ያልፋል፣ network:<host> ወይም network:*ም ያስፈልገዋል።

NeboWebSocket

new NeboAppSDK.NeboWebSocket() ወደ መተግበሪያው ሰራተኛ የቀጥታ socket ይከፍታል፣ በbackoffም እንደገና ይገናኛል። ምንም ነጋሪ እሴት አይቀበልም፣ send(data)፣ close()፣ onopen፣ onmessage፣ onerror እና onclose አሉት።

surfaces እና a2ui

surfaces.connect() የመተግበሪያውን የቀጥታ ቻናል ይከፍታል። ዛሬ ከመተግበሪያው ሰራተኛ የሚመጡ በይነተገናኝ ካርዶችን ይይዛል፤ ገጽዎ በሚያጠቃልለው (SDKው የራሱ ማሳያ የለውም) @a2ui/web_core ካለው MessageProcessor ጋር a2ui.init(processor)ን ይጥሩ። ካርድ የሚደርሰው ለተሠራለት መተግበሪያ ብቻ ነው፣ በላዩ ላይ የሚደረግ ጠቅታ ወደዚያ መተግበሪያ ሰራተኛ ይሄዳል፣ ካርድ ከተላከ በኋላ የተከፈተ ገጽም አይቀበለውም፣ ስለዚህ ገጹ ሁልጊዜ ማሳየት ያለበትን በstorage ውስጥ ያቆዩ።

SDKው እንደ text_content፣ state_delta እና surface_update ያሉ በዓይነት የተለዩ ክስተቶችንም ከsurfaces.on(type, handler)፣ surfaces.send(name, payload) እና surfaces.state ጋር ይገልጻል። Nebo እነዚያን ክስተቶች ገና ወደ መተግበሪያ ገጾች አይልክም፣ sendንም የሚመልስ ምንም ነገር የለም። ለቀጥታ ውሂብ storage.onChangeን ይጠቀሙ።

chat

ከመተግበሪያው ሰራተኛ ጋር ያለውን የNebo ውይይት በገጹ ውስጥ ያካትቱ።

NeboAppSDK.chat.mount(document.getElementById('chat'), {
  placeholder: 'Ask about a deal',
  contextId: 'deal-42'
});
NeboAppSDK.chat.setContext({ deal: 'Example renewal' });
ጥሪባህሪ
chat.mount(element, options)አማራጮች፡ placeholder፣ theme፣ height፣ borderless፣ contextId፣ scope።
chat.send(text)መልዕክት ይልካል።
chat.setContext(context)ሰራተኛው የሚያየውን አውድ ያዘጋጃል፤ null ያጸዳዋል።
chat.onMessage(handler)መልዕክቶችን ይቀበላል።
chat.newThread()አዲስ ክር ይጀምራል።
chat.unmount()ውይይቱን ያስወግዳል።

ውቅር

በNebo ውስጥ SDKው የመተግበሪያ IDውን እና መሠረታዊ URLውን በራሱ ያገኛል። ሌላ ቦታ ለሚቀርብ ገጽ nebo.configure({appId, baseUrl})ን፣ ወይም NeboAppSDK.setAppId(id) እና NeboAppSDK.setBaseUrl(url)ን ይጥሩ። getAppId() እና getBaseUrl() መልሰው ያነቧቸዋል።