SDK লোড করুন
<script src="/sdk/nebo.global.js"></script>
<script>
const { nebo, identity, storage, agents, janus, decide, chat, surfaces } = NeboAppSDK;
</script> গ্লোবালটি হলো NeboAppSDK; কোনো nebo গ্লোবাল নেই। 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() | ক্যাশ পরিষ্কার করে। |
storage
অ্যাপের জন্য একটি key-value স্টোর। এর জন্য 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-এর ভেতরে ব্যাকটিকে সেই ফিল্ডগুলোর নাম দিন। পুরো প্রশ্নটি থাকেinstructions-এ; প্রশ্নের নাম শুধু উত্তরের লেবেল দেয়। খুব দীর্ঘ state পাঠানোর আগে মাঝখান থেকে ছোট করা হয়।- এটি একটি ত্রুটি দেখায়, যার মেসেজই হলো কারণ। ত্রুটিটির কোনো স্ট্যাটাস কোড নেই, তাই আলাদা ক্ষেত্রগুলো চিনতে হলে মেসেজটি মিলিয়ে দেখুন:
- ভুল গঠনের প্রশ্ন, যেমন একটিমাত্র বিকল্পসহ একটি choice (বট 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>-এ। একটি অ্যাবসোলিউট http বা https URL যায় Nebo-র প্রক্সির মাধ্যমে এবং এর জন্য network:<host> বা network:* লাগে।
NeboWebSocket
new NeboAppSDK.NeboWebSocket() অ্যাপের কর্মীর সাথে একটি লাইভ সকেট খোলে এবং ব্যাকঅফসহ আবার সংযুক্ত হয়। এটি কোনো আর্গুমেন্ট নেয় না এবং এতে আছে send(data), close(), onopen, onmessage, onerror ও onclose।
surfaces ও a2ui
surfaces.connect() অ্যাপের লাইভ চ্যানেল খোলে। আজ এটি অ্যাপের কর্মীর কাছ থেকে ইন্টারঅ্যাক্টিভ কার্ড বহন করে: @a2ui/web_core-এর একটি MessageProcessor দিয়ে a2ui.init(processor) কল করুন, যা আপনার পাতা বান্ডেল করে (SDK-এর নিজস্ব কোনো রেন্ডারার নেই)। একটি কার্ড শুধু সেই অ্যাপেই পৌঁছায় যার জন্য তৈরি, তাতে ক্লিক করলে তা যায় সেই অ্যাপের কর্মীর কাছে, এবং কার্ড পাঠানোর পরে খোলা পাতা সেটি পায় না, তাই পাতায় যা সবসময় দেখাতে হবে তা 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 নিজেই app id ও base URL খুঁজে নেয়। অন্য কোথাও থেকে পরিবেশিত কোনো পেজের জন্য nebo.configure({appId, baseUrl}) কল করুন, অথবা NeboAppSDK.setAppId(id) ও NeboAppSDK.setBaseUrl(url)। getAppId() ও getBaseUrl() সেগুলো আবার পড়ে দেয়।