প্রম্পট API

Thomas Steiner

Alexandra Klepper

প্রকাশিত: 20 মে, 2025, সর্বশেষ আপডেট: জুলাই 21, 2025

ব্যাখ্যাকারী	ওয়েব	এক্সটেনশন	ক্রোম স্ট্যাটাস	অভিপ্রায়
গিটহাব	অরিজিন ট্রায়ালে	ক্রোম 138	দেখুন	পরীক্ষা করার অভিপ্রায়

প্রম্পট API-এর সাহায্যে, আপনি ব্রাউজারে জেমিনি ন্যানোকে প্রাকৃতিক ভাষার অনুরোধ পাঠাতে পারেন।

আপনি একটি ওয়েব অ্যাপ্লিকেশন বা ওয়েবসাইটে প্রম্পট API ব্যবহার করতে পারেন এমন অনেক উপায় রয়েছে৷ উদাহরণস্বরূপ, আপনি নির্মাণ করতে পারেন:

• এআই-চালিত অনুসন্ধান : একটি ওয়েব পৃষ্ঠার বিষয়বস্তুর উপর ভিত্তি করে প্রশ্নের উত্তর দিন।
• ব্যক্তিগতকৃত সংবাদ ফিড : একটি ফিড তৈরি করুন যা গতিশীলভাবে নিবন্ধগুলিকে বিভাগগুলির সাথে শ্রেণীবদ্ধ করে এবং ব্যবহারকারীদের সেই বিষয়বস্তুর জন্য ফিল্টার করার অনুমতি দেয়৷

এগুলি মাত্র কয়েকটি সম্ভাবনা, এবং আপনি যা তৈরি করেন তা দেখে আমরা উত্তেজিত।

প্রম্পট API ব্যবহার করুন

প্রম্পট API Chrome-এ Gemini Nano মডেল ব্যবহার করে। যখন এপিআই ক্রোমে বিল্ট করা হয়, তখন প্রথমবার কোনো অরিজিন API ব্যবহার করলে মডেলটি আলাদাভাবে ডাউনলোড করা হয়।

মডেলটি ব্যবহারের জন্য প্রস্তুত কিনা তা নির্ধারণ করতে, LanguageModel.availability() কল করুন। যদি availability() এর প্রতিক্রিয়া downloadable হয়, তাহলে ডাউনলোডের অগ্রগতি শুনুন এবং ব্যবহারকারীকে জানান, কারণ ডাউনলোডে সময় লাগতে পারে।

const availability = await LanguageModel.availability();

ডাউনলোডটি ট্রিগার করতে এবং ভাষা মডেলটি ইনস্ট্যান্টিয়েট করতে, ব্যবহারকারীর সক্রিয়করণ পরীক্ষা করুন। তারপর, অ্যাসিঙ্ক্রোনাস LanguageModel.create() ফাংশনটি কল করুন।

const session = await LanguageModel.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
});

মডেল পরামিতি

params() ফাংশন আপনাকে ভাষা মডেলের পরামিতি সম্পর্কে অবহিত করে। বস্তুটির নিম্নলিখিত ক্ষেত্র রয়েছে:

• defaultTopK : ডিফল্ট টপ-কে মান।
• maxTopK : সর্বোচ্চ টপ-কে মান।
• defaultTemperature : ডিফল্ট তাপমাত্রা ।
• maxTemperature : সর্বোচ্চ তাপমাত্রা।

await LanguageModel.params();
// {defaultTopK: 3, maxTopK: 128, defaultTemperature: 1, maxTemperature: 2}

একটি অধিবেশন তৈরি করুন

একবার প্রম্পট API রান করতে পারলে, আপনি create() ফাংশন দিয়ে একটি সেশন তৈরি করুন।

প্রতিটি সেশন একটি ঐচ্ছিক বিকল্প বস্তু ব্যবহার করে topK এবং temperature সাথে কাস্টমাইজ করা যেতে পারে। এই প্যারামিটারগুলির জন্য ডিফল্ট মানগুলি LanguageModel.params() থেকে ফেরত দেওয়া হয়।

const params = await LanguageModel.params();
// Initializing a new session must either specify both `topK` and
// `temperature` or neither of them.
const slightlyHighTemperatureSession = await LanguageModel.create({
  temperature: Math.max(params.defaultTemperature * 1.2, 2.0),
  topK: params.defaultTopK,
});

create() ফাংশনের ঐচ্ছিক অপশন অবজেক্টটিও একটি signal ফিল্ড নেয়, যা আপনাকে সেশনটি ধ্বংস করতে AbortSignal পাস করতে দেয়।

const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const session = await LanguageModel.create({
  signal: controller.signal,
});

প্রাথমিক প্রম্পট সহ প্রসঙ্গ যোগ করুন

প্রাথমিক প্রম্পটের সাহায্যে, আপনি পূর্ববর্তী ইন্টারঅ্যাকশন সম্পর্কে প্রসঙ্গ সহ ভাষা মডেল প্রদান করতে পারেন, উদাহরণস্বরূপ, ব্রাউজার পুনরায় চালু হওয়ার পরে ব্যবহারকারীকে একটি সঞ্চিত সেশন পুনরায় শুরু করার অনুমতি দিতে।

const session = await LanguageModel.create({
  initialPrompts: [
    { role: 'system', content: 'You are a helpful and friendly assistant.' },
    { role: 'user', content: 'What is the capital of Italy?' },
    { role: 'assistant', content: 'The capital of Italy is Rome.' },
    { role: 'user', content: 'What language is spoken there?' },
    {
      role: 'assistant',
      content: 'The official language of Italy is Italian. [...]',
    },
  ],
});

একটি উপসর্গ দিয়ে প্রতিক্রিয়া সীমাবদ্ধ

মডেলের পূর্ববর্তী প্রতিক্রিয়াগুলিকে বিশদভাবে ব্যাখ্যা করতে আপনি পূর্ববর্তী ভূমিকা ছাড়াও একটি "assistant" ভূমিকা যোগ করতে পারেন৷ যেমন:

const followup = await session.prompt([
  {
    role: "user",
    content: "I'm nervous about my presentation tomorrow"
  },
  {
    role: "assistant",
    content: "Presentations are tough!"
  }
]);

কিছু ক্ষেত্রে, একটি নতুন প্রতিক্রিয়া অনুরোধ করার পরিবর্তে, আপনি "assistant" - ভূমিকা প্রতিক্রিয়া বার্তার অংশটি আগে থেকে পূরণ করতে চাইতে পারেন৷ এটি একটি নির্দিষ্ট প্রতিক্রিয়া বিন্যাস ব্যবহার করার জন্য ভাষা মডেলকে গাইড করতে সহায়ক হতে পারে। এটি করার জন্য, prefix: true অনুগামী "assistant" ভূমিকা বার্তায় সত্য। যেমন:

const characterSheet = await session.prompt([
  {
    role: 'user',
    content: 'Create a TOML character sheet for a gnome barbarian',
  },
  {
    role: 'assistant',
    content: '```toml\n',
    prefix: true,
  },
]);

বার্তা যোগ করুন

অনুমানে কিছু সময় লাগতে পারে, বিশেষ করে যখন মাল্টিমোডাল ইনপুটগুলির সাথে প্রম্পট করা হয়। সেশনটি পপুলেট করার জন্য পূর্বনির্ধারিত প্রম্পটগুলি পাঠানোর জন্য এটি কার্যকর হতে পারে, যাতে মডেলটি প্রক্রিয়াকরণের শুরু করতে পারে।

initialPrompts সেশন তৈরিতে উপযোগী হলেও, সেশন তৈরি হওয়ার পরে অতিরিক্ত অতিরিক্ত প্রাসঙ্গিক প্রম্পট দেওয়ার জন্য prompt() বা promptStreaming() পদ্ধতির সাথে append() পদ্ধতি ব্যবহার করা যেতে পারে।

যেমন:

const session = await LanguageModel.create({
  initialPrompts: [
    {
      role: 'system',
      content:
        'You are a skilled analyst who correlates patterns across multiple images.',
    },
  ],
  expectedInputs: [{ type: 'image' }],
});

fileUpload.onchange = async () => {
  await session.append([
    {
      role: 'user',
      content: [
        {
          type: 'text',
          value: `Here's one image. Notes: ${fileNotesInput.value}`,
        },
        { type: 'image', value: fileUpload.files[0] },
      ],
    },
  ]);
};

analyzeButton.onclick = async (e) => {
  analysisResult.textContent = await session.prompt(userQuestionInput.value);
};

প্রম্পটটি যাচাই করা, প্রক্রিয়া করা এবং সেশনে যুক্ত হওয়ার পরে append() দ্বারা প্রত্যাবর্তিত প্রতিশ্রুতি পূরণ হয়। প্রতিশ্রুতি প্রত্যাখ্যান করা হয় যদি প্রম্পট যুক্ত করা না যায়।

অধিবেশন অধ্যবসায় এবং সীমা

প্রতিটি সেশন কথোপকথনের প্রেক্ষাপট ট্র্যাক রাখে। সেশনের প্রসঙ্গ উইন্ডোটি পূর্ণ না হওয়া পর্যন্ত পূর্ববর্তী মিথস্ক্রিয়াগুলি ভবিষ্যতের মিথস্ক্রিয়াগুলির জন্য বিবেচনা করা হয়।

const session = await LanguageModel.create({
  initialPrompts: [
    {
      role: 'system',
      content:
        'You are a friendly, helpful assistant specialized in clothing choices.',
    },
  ],
});

const result1 = await session.prompt(
  'What should I wear today? It is sunny. I am unsure between a t-shirt and a polo.',
);
console.log(result1);

const result2 = await session.prompt(
  'That sounds great, but oh no, it is actually going to rain! New advice?',
);
console.log(result2);

প্রতিটি সেশনে সর্বাধিক সংখ্যক টোকেন রয়েছে যা এটি প্রক্রিয়া করতে পারে। নিম্নলিখিতগুলির সাথে এই সীমার দিকে আপনার অগ্রগতি পরীক্ষা করুন:

console.log(`${session.inputUsage}/${session.inputQuota}`);

একটি JSON স্কিমা পাস করুন

মান হিসাবে একটি JSON স্কিমা পাস করতে prompt() বা promptStreaming() পদ্ধতিতে responseConstraint ক্ষেত্র যোগ করুন। তারপর আপনি প্রম্পট API এর সাথে কাঠামোগত আউটপুট ব্যবহার করতে পারেন।

নিম্নলিখিত উদাহরণে, JSON স্কিমা নিশ্চিত করে যে প্রদত্ত বার্তাটি মৃৎশিল্প সম্পর্কে হলে শ্রেণীবদ্ধ করতে মডেলটি true বা false সাথে প্রতিক্রিয়া জানায়৷

const session = await LanguageModel.create();

const schema = {
  "type": "boolean"
};

const post = "Mugs and ramen bowls, both a bit smaller than intended, but that
happens with reclaim. Glaze crawled the first time around, but pretty happy
with it after refiring.";

const result = await session.prompt(
  `Is this post about pottery?\n\n${post}`,
  {
    responseConstraint: schema,
  }
);
console.log(JSON.parse(result));
// true

মডেলে পাঠানো বার্তার অংশ হিসেবে আপনার বাস্তবায়নে JSON স্কিমা বা রেগুলার এক্সপ্রেশন অন্তর্ভুক্ত থাকতে পারে। এটি কিছু ইনপুট কোটা ব্যবহার করে। আপনি session.measureInputUsage() এ responseConstraint বিকল্পটি পাস করার মাধ্যমে এটি কতটা ইনপুট কোটা ব্যবহার করবে তা পরিমাপ করতে পারেন।

আপনি omitResponseConstraintInput বিকল্পের মাধ্যমে এই আচরণ এড়াতে পারেন। আপনি যদি তা করেন, আমরা আপনাকে প্রম্পটে কিছু নির্দেশিকা অন্তর্ভুক্ত করার পরামর্শ দিই:

const result = await session.prompt(`
  Summarize this feedback into a rating between 0-5. Only output a JSON
  object { rating }, with a single property whose value is a number:
  The food was delicious, service was excellent, will recommend.
`, { responseConstraint: schema, omitResponseConstraintInput: true });

একটি সেশন ক্লোন করুন

সম্পদ সংরক্ষণ করতে, আপনি clone() ফাংশন দিয়ে একটি বিদ্যমান সেশন ক্লোন করতে পারেন। কথোপকথনের প্রসঙ্গ রিসেট করা হয়েছে, কিন্তু প্রাথমিক প্রম্পট অক্ষত রয়েছে। clone() ফাংশনটি একটি signal ক্ষেত্র সহ একটি ঐচ্ছিক বিকল্প অবজেক্ট নেয়, যা আপনাকে ক্লোন সেশনটি ধ্বংস করতে একটি AbortSignal পাস করতে দেয়।

const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const clonedSession = await session.clone({
  signal: controller.signal,
});

মডেল প্রম্পট

আপনি prompt() বা promptStreaming() ফাংশনগুলির সাথে মডেলটিকে প্রম্পট করতে পারেন।

অ-প্রবাহিত আউটপুট

আপনি যদি একটি সংক্ষিপ্ত ফলাফল আশা করেন, আপনি prompt() ফাংশনটি ব্যবহার করতে পারেন যা একবার উপলব্ধ হলে প্রতিক্রিয়া প্রদান করে।

// Start by checking if it's possible to create a session based on the
// availability of the model, and the characteristics of the device.
const { defaultTemperature, maxTemperature, defaultTopK, maxTopK } =
  await LanguageModel.params();

const available = await LanguageModel.availability();

if (available !== 'unavailable') {
  const session = await LanguageModel.create();

  // Prompt the model and wait for the whole result to come back.
  const result = await session.prompt('Write me a poem!');
  console.log(result);
}

প্রবাহিত আউটপুট

যদি আপনি একটি দীর্ঘ প্রতিক্রিয়া আশা করেন, তাহলে আপনাকে promptStreaming() ফাংশন ব্যবহার করা উচিত যা আপনাকে মডেল থেকে আসা আংশিক ফলাফলগুলি দেখাতে দেয়। promptStreaming() ফাংশন একটি ReadableStream প্রদান করে।

const { defaultTemperature, maxTemperature, defaultTopK, maxTopK } =
  await LanguageModel.params();

const available = await LanguageModel.availability();
if (available !== 'unavailable') {
  const session = await LanguageModel.create();

  // Prompt the model and stream the result:
  const stream = session.promptStreaming('Write me an extra-long poem!');
  for await (const chunk of stream) {
    console.log(chunk);
  }
}

প্রম্পট করা বন্ধ করুন

prompt() এবং promptStreaming() উভয়ই একটি signal ক্ষেত্রের সাথে একটি ঐচ্ছিক দ্বিতীয় প্যারামিটার গ্রহণ করে, যা আপনাকে প্রম্পট চালানো বন্ধ করতে দেয়।

const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const result = await session.prompt('Write me a poem!', {
  signal: controller.signal,
});

একটি অধিবেশন বন্ধ করুন

আপনার যদি আর কোনো সেশনের প্রয়োজন না হয় তাহলে রিসোর্সকে ফ্রিতে destroy() কল করুন। একটি অধিবেশন ধ্বংস হয়ে গেলে, এটি আর ব্যবহার করা যাবে না, এবং যে কোনো চলমান মৃত্যুদন্ড বাতিল করা হয়। আপনি সেশনটি কাছাকাছি রাখতে চাইতে পারেন যদি আপনি প্রায়শই মডেলটি প্রম্পট করতে চান যেহেতু একটি সেশন তৈরি করতে কিছু সময় লাগতে পারে।

await session.prompt(
  "You are a friendly, helpful assistant specialized in clothing choices."
);

session.destroy();

// The promise is rejected with an error explaining that
// the session is destroyed.
await session.prompt(
  "What should I wear today? It is sunny, and I am choosing between a t-shirt
  and a polo."
);

মাল্টিমোডাল ক্ষমতা

প্রম্পট API অরিজিন ট্রায়াল অডিও এবং ইমেজ ইনপুট সমর্থন করে। API একটি পাঠ্য আউটপুট প্রদান করে।

এই ক্ষমতাগুলির সাথে, আপনি করতে পারেন:

• ব্যবহারকারীদের একটি চ্যাট অ্যাপ্লিকেশনে পাঠানো অডিও বার্তা প্রতিলিপি করার অনুমতি দিন।
• একটি ক্যাপশন বা বিকল্প পাঠ্যে ব্যবহারের জন্য আপনার ওয়েবসাইটে আপলোড করা একটি চিত্র বর্ণনা করুন৷

const session = await LanguageModel.create({
  // { type: 'text' } only required when including expected input languages.
  expectedInputs: [{ type: 'audio' }, { type: 'image' }],
});

const referenceImage = await (await fetch('/reference-image.jpeg')).blob();
const userDrawnImage = document.querySelector('canvas');

const response1 = await session.prompt([
  {
    role: 'user',
    content: [
      {
        type: 'text',
        value:
          'Give an artistic critique of how well the second image matches the first:',
      },
      { type: 'image', value: referenceImage },
      { type: 'image', value: userDrawnImage },
    ],
  },
]);

console.log(response1);

const audioBlob = await captureMicrophoneInput({ seconds: 10 });

const response2 = await session.prompt([
  {
    role: 'user',
    content: [
      { type: 'text', value: 'My response to your critique:' },
      { type: 'audio', value: audioBlob },
    ],
  },
]);

অডিও ইনপুট সহ প্রম্পট API ব্যবহার করার জন্য Mediarecorder অডিও প্রম্পট ডেমো এবং চিত্র ইনপুট সহ প্রম্পট API ব্যবহার করার জন্য ক্যানভাস চিত্র প্রম্পট ডেমো দেখুন।

কর্মক্ষমতা কৌশল

ওয়েবের জন্য প্রম্পট API এখনও তৈরি করা হচ্ছে। আমরা এই API তৈরি করার সময়, সর্বোত্তম কর্মক্ষমতার জন্য সেশন পরিচালনার উপর আমাদের সেরা অনুশীলনগুলি দেখুন।

অনুমতি নীতি, iframes, এবং ওয়েব কর্মী

ডিফল্টরূপে, প্রম্পট API শুধুমাত্র শীর্ষ-স্তরের উইন্ডোতে এবং তাদের একই-অরিজিন আইফ্রেমে উপলব্ধ। পারমিশন পলিসি allow="" অ্যাট্রিবিউট ব্যবহার করে এপিআই-এর অ্যাক্সেস ক্রস-অরিজিন আইফ্রেমগুলিতে অর্পণ করা যেতে পারে:

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Prompt API by
  setting the `allow="language-model"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-model"></iframe>

অনুমতি নীতির স্থিতি পরীক্ষা করার জন্য প্রতিটি কর্মীর জন্য একটি দায়িত্বশীল নথি প্রতিষ্ঠার জটিলতার কারণে প্রম্পট API এখন ওয়েব ওয়ার্কার-এ উপলব্ধ নেই৷

অংশগ্রহণ করুন এবং মতামত শেয়ার করুন

আপনার ইনপুট সরাসরি প্রভাবিত করতে পারে কিভাবে আমরা এই API এবং সমস্ত অন্তর্নির্মিত AI API এর ভবিষ্যত সংস্করণগুলি তৈরি এবং প্রয়োগ করি৷

• Chrome এর বাস্তবায়ন সম্পর্কে প্রতিক্রিয়ার জন্য, একটি বাগ রিপোর্ট বা একটি বৈশিষ্ট্য অনুরোধ ফাইল করুন৷
• একটি বিদ্যমান ইস্যুতে মন্তব্য করে বা প্রম্পট API GitHub সংগ্রহস্থলে একটি নতুন খোলার মাধ্যমে API আকারে আপনার প্রতিক্রিয়া শেয়ার করুন।
• প্রারম্ভিক প্রিভিউ প্রোগ্রামে যোগ দিন ।