সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করা শুরু করা


মডেলের কাছে পাঠানো প্রতিটি অনুরোধে, আপনি একটি প্রম্পট এবং ঐচ্ছিকভাবে স্কিমা ও কনফিগারেশন পাঠান যাতে মডেলের উত্তর নিয়ন্ত্রণ করা যায়। Firebase AI Logic ব্যবহার করার সময়, আপনি এই সব তথ্য সরাসরি আপনার ক্লায়েন্ট কোড থেকে পাঠাতে পারেন অথবা সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করে সার্ভার-সাইডে এই তথ্য উল্লেখ করতে পারেন।

সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করার সময়, আপনি সার্ভার-সাইডে আপনার প্রম্পট, স্কিমা ও কনফিগারেশন স্টোর করেন এবং আপনার অ্যাপের কোডবেস ক্লায়েন্ট থেকে সার্ভারে শুধুমাত্র একটি 'কী' (টেমপ্লেট আইডি) পাস করে যা নির্দিষ্ট টেমপ্লেট এবং সেই টেমপ্লেটের জন্য প্রয়োজনীয় ইনপুট রেফার করে। এই পদ্ধতির কিছু সুবিধা এখানে দেওয়া হল:

  • ক্লায়েন্ট-সাইডে আপনার প্রম্পট প্রকাশ করা থেকে সুরক্ষিত রাখুন

  • নতুন অ্যাপ ভার্সন রিলিজ না করেই আপনার প্রম্পট ও কনফিগারেশন আপডেট করুন

সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করা কীভাবে শুরু করবেন তা এই নির্দেশিকায় বর্ণনা করা হয়েছে।

হাই-লেভেল ওভারভিউতে যান বিস্তারিত নির্দেশাবলীতে যান

কাজ করে এমন মডেল ও ক্ষমতা



হাই-লেভেল ওভারভিউ

সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করার জন্য এখানে প্রাথমিক ওয়ার্কফ্লো দেওয়া হল:

  1. Firebase কনসোলে গাইডেড UI ব্যবহার করে টেমপ্লেট তৈরি করুন।

  2. Firebase কনসোলে টেস্টিং অভিজ্ঞতা ব্যবহার করে আসল অনুরোধে টেমপ্লেটটি পরীক্ষা করুন।

  3. templateGenerativeModel ব্যবহার করে আপনার অ্যাপের কোড থেকে টেমপ্লেট অ্যাক্সেস করুন।

সার্ভার প্রম্পট টেমপ্লেটের প্রাথমিক ফর্ম্যাট

Firebase AI Logic-এর জন্য, Firebase কনসোল আপনাকে টেমপ্লেটের ফ্রন্টম্যাটার এবং কন্টেন্ট নির্দিষ্ট করার জন্য একটি গাইডেড UI প্রদান করে।

সার্ভার প্রম্পট টেমপ্লেট Dotprompt-ভিত্তিক সিনট্যাক্স ও ফর্ম্যাট ব্যবহার করে। আরও বিবরণের জন্য, টেমপ্লেট ফর্ম্যাট, সিনট্যাক্স ও উদাহরণ দেখুন।

নিচের উদাহরণ টেমপ্লেটটি Gemini মডেলের কাছে একটি উদাহরণ অনুরোধের জন্য একটি টেমপ্লেটের সবচেয়ে গুরুত্বপূর্ণ উপাদানগুলি দেখায়:

---
model: 'gemini-4-hydrogen'
---

{{role "system"}}
All output must be a clearly structured invoice document.
Use a tabular or clearly delineated list format for line items.

{{role "user"}}
Create an example customer invoice for a customer named {{customerName}}.
  • ট্রিপল-ড্যাশের মধ্যে সবচেয়ে উপরের বিভাগে মডেলের নাম এবং ঐচ্ছিকভাবে, আপনি অনুরোধে পাঠাতে চান এমন কোনও মডেল কনফিগারেশন, ইনপুট যাচাইকরণ বা স্কিমা থাকে। এটি কী-ভ্যালু পেয়ার হিসেবে লেখা হয় এবং সাধারণত YAML ফ্রন্টম্যাটার বলা হয়।

  • টেমপ্লেটের বডিতে প্রম্পট রয়েছে। এছাড়াও, এটি ঐচ্ছিকভাবে সিস্টেম নির্দেশাবলী এবং ইনপুট ভ্যালু অন্তর্ভুক্ত করতে পারে (Handlebars সিনট্যাক্স ব্যবহার করে)।

কোডে আপনার টেমপ্লেট ব্যবহার করুন

এই পৃষ্ঠায় পরিষেবা প্রদানকারী-নির্দিষ্ট কন্টেন্ট ও কোড দেখতে আপনার Gemini API পরিষেবা প্রদানকারীর উপর ক্লিক করুন।

আপনার কোডে কীভাবে টেমপ্লেট ব্যবহার করবেন তা নিচে দেওয়া ক্লায়েন্ট কোডের উদাহরণ থেকে জানতে পারবেন:

Swift


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .agentPlatform()).templateGenerativeModel()

let customerName = "Jane"

do {
    let response = try await model.generateContent(
        // Specify your template ID
        templateID: "my-first-template-v1-0-0",
        // Provide the values for any input variables required by your template.
        inputs: [
            "customerName": customerName
        ]
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

Kotlin


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform()).templateGenerativeModel()

val customerName = "Jane"

val response = model.generateContent(
    // Specify your template ID.
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf(
        "customerName" to customerName
    )
)

val text = response.text
println(text)

Java


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance(GenerativeBackend.agentPlatform()).templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

String customerName = "Jane";

Future response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)
);
addCallback(response,
       new FutureCallback() {
           public void onSuccess(GenerateContentResponse result) {
             System.out.println(result.getText());
           }
           public void onFailure(Throwable t) {
             reportError(t);
           }
    }
executor);

Web


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(app, { backend: new AgentPlatformBackend() });

// Create a `TemplateGenerativeModel` instance.
const model = getTemplateGenerativeModel(ai);

const customerName = 'Jane';

const result = await model.generateContent({
  // Specify your template ID.
  templateId: 'my-first-template-v1-0-0',
  // Provide the values for any input variables required by your template.
  templateVariables: {
    customerName: customerName,
  },
});

const response = result.response;
const text = response.text();

Dart


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
var _model = FirebaseAI.agentPlatform().templateGenerativeModel();

var customerName = 'Jane';

var response = await _model.generateContent(
        // Specify your template ID
        'my-first-template-v1-0-0',
        // Provide the values for any input variables required by your template.
        inputs: {
           'customerName': customerName,
        },
      );

var text = response?.text;
print(text);

Unity


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform());

// Create a `TemplateGenerativeModel` instance
var model = firebaseAI.GetTemplateGenerativeModel();

var customerName = "Jane";

try
{
   var response = await model.GenerateContentAsync(
      // Specify your template ID.
      "my-first-template-v1-0-0",
      // Provide the values for any input variables required by your template.
      new Dictionary<string, object> {
         { "customerName", customerName },
      }
   );
   Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}



বিস্তারিত নির্দেশাবলী

এই বিভাগে সার্ভার প্রম্পট টেমপ্লেট তৈরি, পরীক্ষা ও ব্যবহার করার জন্য বিস্তারিত নির্দেশাবলী দেওয়া হয়েছে।

শুরু করার আগে

  • আপনি যদি এখনও না করে থাকেন, তাহলে শুরু করার নির্দেশিকা সম্পূর্ণ করুন, যা আপনার Firebase প্রোজেক্ট কীভাবে সেট-আপ করবেন, Firebase-এর সাথে আপনার অ্যাপ কীভাবে কানেক্ট করবেন, SDK যোগ করবেন, আপনার বেছে নেওয়া Gemini API প্রোভাইডারের জন্য ব্যাকএন্ড পরিষেবা শুরু করবেন এবং একটি GenerativeModel ইনস্ট্যান্স তৈরি করবেন তা বর্ণনা করে।

  • সার্ভার প্রম্পট টেমপ্লেট তৈরি ও ম্যানেজ করার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি আছে কিনা তা ভালো করে দেখে নিন। ডিফল্ট হিসেবে, এই সব অনুমতি মালিকের ভূমিকায় অন্তর্ভুক্ত থাকে।

  • আপনি Agent Platform Gemini API (formerly Vertex AI) ব্যবহার করলে এবং আপনার ব্যবহারের ক্ষেত্রে লোকেশন-ভিত্তিক বিধিনিষেধের প্রয়োজন হলে, আমরা টেমপ্লেটের জন্য উন্নত ওয়ার্কফ্লো সাপোর্ট করি।

ধাপ ১: সার্ভার প্রম্পট টেমপ্লেট তৈরি করুন

বেশিরভাগ ব্যবহারের ক্ষেত্রে, আপনি Firebase কনসোলে সার্ভার প্রম্পট টেমপ্লেট তৈরি এবং ম্যানেজ করেন।

  1. Firebase কনসোলে, AI পরিষেবা > AI লজিক > প্রম্পট টেমপ্লেট ট্যাবে যান।

  2. নতুন টেমপ্লেট তৈরি করুন বিকল্পে ক্লিক করুন এবং স্টার্টার টেমপ্লেট বিকল্প বেছে নিন।

    • এই স্টার্টার টেমপ্লেটগুলি কিছু সাধারণ ব্যবহারের ক্ষেত্রে ফর্ম্যাট এবং সিনট্যাক্স প্রদান করে। আপনি যে বিকল্পই বেছে নিন না কেন, আপনার প্রয়োজন মেটাতে টেমপ্লেটটি সম্পূর্ণভাবে পরিবর্তন করতে পারবেন।

    • এই শুরু করার নির্দেশিকা ধরে নেয় যে আপনি Input + System Instructions বিকল্প বেছে নিয়েছেন।

  3. টেমপ্লেটের শনাক্তকারী লিখুন:

    • টেমপ্লেটের নাম: এটি টেমপ্লেটের ডিসপ্লে নাম (যেমন, My First Template)। এটি শুধুমাত্র Firebase ইন্টারফেসে দেখা যায়, যেমন Firebase কনসোল।

    • টেমপ্লেট আইডি: এটি আপনার Firebase প্রোজেক্টের মধ্যে টেমপ্লেটের জন্য একটি অনন্য আইডি হতে হবে (যেমন, my-first-template-v1-0-0)। আপনি আপনার অ্যাপ থেকে অনুরোধে এই আইডিটি উল্লেখ করবেন।

      • আপনার টেমপ্লেট আইডির জন্য ভার্সনিং সিস্টেম ব্যবহার করলে ভালো হয়।

      • টেমপ্লেট আইডিতে সর্বাধিক ৬৩টি অক্ষর থাকতে পারে এবং এতে ছোট হাতের অক্ষর, সংখ্যা ও হাইফেন থাকতে পারে।

  4. প্রয়োজন অনুযায়ী, টেমপ্লেটের কনফিগারেশন (ফ্রন্টম্যাটার) বিভাগটি পরিবর্তন করুন।

    • এই বিভাগে কমপক্ষে একটি মডেলের নাম থাকতে হবে, যেমন:

      ---
      model: 'gemini-4-hydrogen'
      ---
      
    • এছাড়াও, আপনি চাইলে মডেলের কনফিগারেশন এবং যেকোনও ইনপুট ও আউটপুট কন্ট্রোল ইত্যাদি নির্দিষ্ট করতে পারেন। আরও বিবরণ ও বিকল্পের জন্য, টেমপ্লেট ফর্ম্যাট, সিনট্যাক্স ও উদাহরণ দেখুন।

  5. প্রয়োজন অনুযায়ী, টেমপ্লেটের প্রম্পট এবং (প্রযোজ্য হলে) সিস্টেম নির্দেশাবলী বিভাগ পরিবর্তন করুন।

    • এই বিভাগে মডেলে পাঠানোর জন্য অন্তত টেক্সট প্রম্পট অন্তর্ভুক্ত করতে হবে।

      Write a story about a magic backpack.
      
    • এছাড়াও, আপনি নিম্নলিখিত বিকল্পের মতো আরও জটিল প্রম্পট তৈরি করতে পারেন। আরও বিবরণ ও বিকল্পের জন্য, টেমপ্লেট ফর্ম্যাট, সিনট্যাক্স ও উদাহরণ দেখুন।

      • (ঐচ্ছিক এবং প্রযোজ্য হলে) {{role "system"}} সিনট্যাক্স ব্যবহার করে সিস্টেম নির্দেশাবলী এবং {{role "user"}} সিনট্যাক্স ব্যবহার করে টেক্সট প্রম্পট উল্লেখ করুন।

      • (ঐচ্ছিক) Handlebars সিনট্যাক্স (যেমন {{customerName}}) ব্যবহার করে ইনপুট ভেরিয়েবল উল্লেখ করুন। আপনি টেমপ্লেটে ডিফল্ট ভ্যালু দিতে পারেন, তবে এই ইনপুট ভেরিয়েবলের ভ্যালু সাধারণত অনুরোধে পাস করা হয়।

      {{role "system"}}
      All output must be a clearly structured invoice document.
      Use a tabular or clearly delineated list format for line items.
      
      {{role "user"}}
      Create an example customer invoice for a customer named {{customerName}}.
      

ধাপ ২: Firebase কনসোলে আপনার টেমপ্লেট পরীক্ষা করুন

Firebase কনসোল আপনার টেমপ্লেটের জন্য একটি টেস্টিং অভিজ্ঞতা প্রদান করে। এই অভিজ্ঞতা আপনাকে দেখতে দেয় যে আপনার টেমপ্লেট ব্যবহার করা হলে কী ঘটবে – অনুরোধের ফর্ম্যাট এবং আসল অনুরোধের আউটপুট, দুটিই।

  1. টেমপ্লেট সেভ করুন বিকল্পে ক্লিক করুন যাতে আপনি টেমপ্লেট পরীক্ষা করতে পারেন।

    আপনি পরে যেকোনও সময় টেমপ্লেট এডিট করতে বা মুছে দিতে পারবেন। আপনি পরে শুধুমাত্র টেমপ্লেট আইডির ভ্যালু পরিবর্তন করতে পারবেন না।

  2. আপনার প্রম্পট ইনপুট ভেরিয়েবল ব্যবহার করলে, টেস্ট ইনপুট ফিল্ডে টেস্ট ভ্যালু যোগ করুন। এই উদাহরণের জন্য:

      {
        "customerName": "Jane"
      }
    
  3. আপনার Firebase প্রোজেক্টে একাধিক Gemini API পরিষেবা প্রদানকারী চালু করা থাকলে, আপনি বেছে নিতে পারবেন যে টেস্ট অনুরোধের জন্য কোনটি ব্যবহার করবেন। কনসোলে এই বিকল্পটি দেখানো হলে, Gemini Developer API অথবা Agent Platform Gemini API (আগে Vertex AI) বেছে নিন।

    মনে রাখবেন যে এই বিকল্পটি শুধুমাত্র Firebase কনসোল টেস্টিং অভিজ্ঞতার মাধ্যমে জমা দেওয়া অনুরোধের ক্ষেত্রে প্রযোজ্য। আপনার অ্যাপ থেকে করা আসল অনুরোধে, আপনি যেভাবে যেকোনও অনুরোধের জন্য আপনার বেছে নেওয়া Gemini API পরিষেবা প্রদানকারীকে নির্দিষ্ট করেন, ঠিক সেভাবেই এটি নির্দিষ্ট করুন।

  4. ফর্ম্যাট করা টেস্ট অনুরোধ তৈরি করুন বোতামে ক্লিক করুন।

    স্ক্রিনের ডানদিকে ফর্ম্যাট করা টেস্ট অনুরোধ পর্যালোচনা করুন এবং আপনার টেমপ্লেটের যেকোনও ফিল্ডে ইটারেট করুন।

  5. ফর্ম্যাট করা টেস্ট অনুরোধ নিয়ে সন্তুষ্ট হলে, প্রম্পট টেস্ট রান করুন বোতামে ক্লিক করুন।

    স্ক্রিনের ডানদিকে টেস্ট রেসপন্স পর্যালোচনা করুন এবং আপনার টেমপ্লেটের যেকোনও ফিল্ডে ইটারেট করুন।

  6. আপনার অ্যাপের কোড থেকে টেমপ্লেট অ্যাক্সেস করার জন্য প্রস্তুত হলে, টেমপ্লেটের উপরে ডানদিকের কোণে লক আইকনে ক্লিক করে টেমপ্লেট লক করুন।

  7. এডিটিং অভিজ্ঞতা থেকে বেরিয়ে আসতে বন্ধ করুন বিকল্পে ক্লিক করুন।

ধাপ ৩: আপনার কোড থেকে টেমপ্লেট অ্যাক্সেস করুন

এই পৃষ্ঠায় পরিষেবা প্রদানকারী-নির্দিষ্ট কন্টেন্ট ও কোড দেখতে আপনার Gemini API পরিষেবা প্রদানকারীর উপর ক্লিক করুন।

সার্ভার প্রম্পট টেমপ্লেট ব্যবহার করে করা অনুরোধ অন্যান্য অনুরোধের মতোই দেখায়, তবে এতে নিম্নলিখিত অ্যাডজাস্টমেন্ট থাকে:

  • templateGenerativeModel ব্যবহার করুন।
  • টেমপ্লেট আইডি দিন।
  • আপনার টেমপ্লেটের জন্য প্রয়োজনীয় যেকোনও ভেরিয়েবেল ইনপুটের ভ্যালু প্রদান করুন।

মনে রাখবেন যে আপনার টেমপ্লেট তৈরি বা আপডেট করার পরে, আপনার কোড থেকে এটি অ্যাক্সেস করার আগে Firebase সার্ভার জুড়ে টেমপ্লেটটি প্রচার করার জন্য আপনাকে কয়েক মিনিট অপেক্ষা করতে হতে পারে।

Swift

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .agentPlatform()).templateGenerativeModel()

let customerName = "Jane"

do {
    let response = try await model.generateContent(
        // Specify your template ID
        templateID: "my-first-template-v1-0-0",
        // Provide the values for any input variables required by your template.
        inputs: [
            "customerName": customerName
        ]
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

Kotlin

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform()).templateGenerativeModel()

val customerName = "Jane"

val response = model.generateContent(
    // Specify your template ID.
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf(
        "customerName" to customerName
    )
)

val text = response.text
println(text)

Java

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance(GenerativeBackend.agentPlatform()).templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

String customerName = "Jane";

Future response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)
);
addCallback(response,
       new FutureCallback() {
           public void onSuccess(GenerateContentResponse result) {
             System.out.println(result.getText());
           }
           public void onFailure(Throwable t) {
             reportError(t);
           }
    }
executor);

Web

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(app, { backend: new AgentPlatformBackend() });

// Create a `TemplateGenerativeModel` instance.
const model = getTemplateGenerativeModel(ai);

const customerName = 'Jane';

const result = await model.generateContent({
  // Specify your template ID.
  templateId: 'my-first-template-v1-0-0',
  // Provide the values for any input variables required by your template.
  templateVariables: {
    customerName: customerName,
  },
});

const response = result.response;
const text = response.text();

Dart

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
var _model = FirebaseAI.agentPlatform().templateGenerativeModel();

var customerName = 'Jane';

var response = await _model.generateContent(
        // Specify your template ID
        'my-first-template-v1-0-0',
        // Provide the values for any input variables required by your template.
        inputs: {
           'customerName': customerName,
        },
      );

var text = response?.text;
print(text);

Unity

আপনার অনুরোধে টেমপ্লেট ব্যবহার করতে templateGenerativeModel ইনস্ট্যান্স তৈরি করুন।


// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform());

// Create a `TemplateGenerativeModel` instance
var model = firebaseAI.GetTemplateGenerativeModel();

var customerName = "Jane";

try
{
   var response = await model.GenerateContentAsync(
      // Specify your template ID.
      "my-first-template-v1-0-0",
      // Provide the values for any input variables required by your template.
      new Dictionary<string, object> {
         { "customerName", customerName },
      }
   );
   Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}



এরপরে কী?