জেনারেটিভ UI (GenUI) অ্যাপ বিল্ড করা

১. ভূমিকা

এই কোডল্যাবে, আপনি Flutter, Firebase AI Logic এবং নতুন genui প্যাকেজ ব্যবহার করে একটি টাস্ক লিস্ট অ্যাপ তৈরি করবেন। আপনি টেক্সট-ভিত্তিক চ্যাট অ্যাপ দিয়ে শুরু করবেন, GenUI-এর মাধ্যমে এটিকে আপগ্রেড করে এজেন্টকে নিজস্ব UI তৈরি করার ক্ষমতা দেবেন এবং শেষে আপনার নিজস্ব কাস্টম, ইন্টার‍্যাক্টিভ UI কম্পোনেন্ট তৈরি করবেন যা আপনি এবং এজেন্ট সরাসরি ম্যানিপুলেট করতে পারবেন।

Chrome-এ চলা টাস্ক লিস্ট অ্যাপ

আপনি কী করবেন

  • Flutter এবং Firebase AI Logic ব্যবহার করে একটি সাধারণ চ্যাট ইন্টারফেস তৈরি করা
  • AI-পরিচালিত সারফেস তৈরি করতে genui প্যাকেজ ইন্টিগ্রেট করুন
  • অ্যাপটি কখন এজেন্টের কাছ থেকে উত্তরের জন্য অপেক্ষা করছে তা নির্দেশ করতে একটি প্রোগ্রেস বার যোগ করুন
  • একটি নামযুক্ত সারফেস তৈরি করুন এবং UI-তে একটি নির্দিষ্ট জায়গায় এটি দেখান।
  • একটি কাস্টম GenUI ক্যাটালগ কম্পোনেন্ট তৈরি করুন যা আপনাকে টাস্ক কীভাবে উপস্থাপন করা হবে তার উপর নিয়ন্ত্রণ দেয়

আপনার কী প্রয়োজন হবে

  • Chrome-এর মতো ওয়েব ব্রাউজার
  • লোকাল মেশিনে ইনস্টল করা Flutter SDK
  • Firebase CLI ইনস্টল ও কনফিগার করা আছে

এই কোডল্যাব মধ্যবর্তী স্তরের Flutter ডেভেলপারদের জন্য।

২. শুরু করার আগে

Flutter প্রোজেক্ট সেট-আপ করা

  1. আপনি আগে থেকে ইনস্টল না করে থাকলে, লোকালি Flutter SDK ইনস্টল করুন।
  2. নতুন প্রোজেক্ট তৈরি করতে আপনার টার্মিনাল খুলুন এবং flutter create রান করুন:
    flutter create intro_to_genui
    cd intro_to_genui
    
  3. আপনার Flutter প্রোজেক্টে প্রয়োজনীয় ডিপেন্ডেন্সি যোগ করুন:
    flutter pub add firebase_core firebase_ai genui json_schema_builder
    
    আপনার চূড়ান্ত dependencies বিভাগটি এইরকম দেখতে হওয়া উচিত (ভার্সন নম্বর সামান্য আলাদা হতে পারে):
    dependencies:
      flutter:
        sdk: flutter
    
      cupertino_icons: ^1.0.9
      firebase_core: ^4.15.0
      firebase_ai: ^4.0.0
      genui: ^0.10.3
      json_schema_builder: ^0.1.7
    
  4. সব প্যাকেজ ডাউনলোড করতে flutter pub get রান করান। নতুন প্যাকেজ ভার্সন উপলভ্য আছে বলে প্রম্পট করা হলে, ভার্সন চেক করতে flutter pub outdated এবং আপনার ডিপেন্ডেন্সি আপডেট করতে flutter pub upgrade রান করাতে পারেন।

Firebase প্রোজেক্ট সেট-আপ করা

  1. আপনি আগে না করে থাকলে, Firebase CLI ইনস্টল করুন।
  2. আপনার Google অ্যাকাউন্ট ব্যবহার করে Firebase-এ লগ-ইন করুন:
    firebase login
    
  3. FlutterFire CLI ইনস্টল করুন:
    dart pub global activate flutterfire_cli
    
  4. আপনার Flutter প্রোজেক্ট ডিরেক্টরি থেকে, Firebase ব্যবহার করার জন্য আপনার Flutter প্রোজেক্ট কনফিগার করতে নিম্নলিখিত কমান্ডটি রান করুন:
    flutterfire configure
    
    এই কমান্ড নিম্নলিখিত কাজগুলি করবে:
    1. আপনি আগে থেকে থাকা Firebase প্রোজেক্ট ব্যবহার করতে চান নাকি নতুন Firebase প্রোজেক্ট তৈরি করতে চান তা জিজ্ঞাসা করবে। নতুন Firebase প্রোজেক্ট তৈরি করুন বিকল্প বেছে নিন।
    2. আপনার Flutter অ্যাপের জন্য কোন প্ল্যাটফর্ম (iOS, Android, Web) টার্গেট করতে চান তা জিজ্ঞাসা করবে। এখন, ওয়েব বেছে নিন।

flutterfire configure কমান্ড অটোমেটিক একটি Firebase প্রোজেক্ট এবং সেই Firebase প্রোজেক্টে একটি নতুন Firebase ওয়েব অ্যাপ তৈরি করে। কমান্ডটি তারপর একটি Firebase কনফিগারেশন ফাইল (firebase_options.dart) তৈরি করে এবং অটোমেটিক আপনার Flutter প্রোজেক্টের lib/ ডিরেক্টরিতে এটি যোগ করে।

মনে রাখবেন যে এই কোডল্যাবের জন্য অ্যাপটি আপনার মেশিনে ইনস্টল করা Flutter SDK এবং Chrome-এর সাথে কাজ করে (অর্থাৎ, এটি একটি ওয়েব অ্যাপ হিসেবে তৈরি করা হয়েছে)। তবে, এই অ্যাপটি Flutter-এর সাহায্যে তৈরি করা হয়েছে বলে এটি অন্যান্য প্ল্যাটফর্মেও কাজ করবে! তাই কোডল্যাবের শেষে, iOS, Android বা অন্য প্ল্যাটফর্মের জন্য সহায়তা যোগ করতে flutterfire configure আবার রান করার চেষ্টা করুন এবং তারপর সেই প্ল্যাটফর্মে অ্যাপটি আবার তৈরি করুন।

আরও তথ্যের জন্য, Flutter অ্যাপে Firebase যোগ করার নির্দেশাবলী দেখুন।

Firebase AI Logic সেট-আপ করা

  1. Firebase কনসোল-এ সাইন-ইন করুন। Firebase CLI-তে লগ-ইন করার জন্য যে Google অ্যাকাউন্ট ব্যবহার করেছিলেন সেটিই ব্যবহার করুন।
  2. FlutterFire CLI ব্যবহার করে আপনি যে Firebase প্রোজেক্ট তৈরি করেছেন সেটি বেছে নিন।
  3. বাঁদিকের নেভিগেশন মেনু থেকে, AI পরিষেবা > AI লজিক বিকল্প বেছে নিন।
  4. গাইডেড ওয়ার্কফ্লো চালু করতে শুরু করুন বিকল্পে ক্লিক করুন।
  5. Gemini Developer API দিয়ে শুরু করতে বেছে নিন এবং Firebase AI Logic সেট-আপ করতে অন-স্ক্রিন প্রম্পট অনুসরণ করুন।

"Flutter প্রোজেক্ট সেট-আপ করুন" বিভাগ থেকে Firebase AI Logic ব্যবহার করার জন্য আপনার কাছে ইতিমধ্যেই প্রয়োজনীয় FlutterFire প্লাগ-ইন আছে। পরবর্তী ধাপে আপনার অ্যাপ কোডিং করার জন্য আপনি প্রস্তুত!

৩. একটি বেসিক চ্যাট ইন্টারফেস স্ক্যাফোল্ড করা

Generative UI চালু করার আগে, আপনার অ্যাপের একটি ফাউন্ডেশন প্রয়োজন: Firebase AI Logic দ্বারা পরিচালিত একটি বেসিক টেক্সট-ভিত্তিক চ্যাট অ্যাপ্লিকেশন। দ্রুত শুরু করতে, আপনি চ্যাট ইন্টারফেসের জন্য সম্পূর্ণ সেট-আপ কপি-পেস্ট করবেন।

অ্যাপের টেক্সট-ভিত্তিক ভার্সন

মেসেজ বাবল উইজেট তৈরি করুন

ব্যবহারকারী এবং এজেন্টের টেক্সট মেসেজ দেখানোর জন্য আপনার অ্যাপে একটি উইজেট থাকতে হবে। lib/message_bubble.dart নামে একটি নতুন ফাইল তৈরি করুন এবং নিম্নলিখিত ক্লাস যোগ করুন:

import 'package:flutter/material.dart';

class MessageBubble extends StatelessWidget {
  final String text;
  final bool isUser;

  const MessageBubble({super.key, required this.text, required this.isUser});

  @override
  Widget build(BuildContext context) {
    final theme = Theme.of(context);
    final colorScheme = theme.colorScheme;

    final bubbleColor = isUser
        ? colorScheme.primary
        : colorScheme.surfaceContainerHighest;

    final textColor = isUser
        ? colorScheme.onPrimary
        : colorScheme.onSurfaceVariant;

    return Padding(
      padding: const EdgeInsets.symmetric(vertical: 6.0, horizontal: 8.0),
      child: Column(
        crossAxisAlignment: isUser
            ? CrossAxisAlignment.end
            : CrossAxisAlignment.start,
        children: [
          Row(
            mainAxisAlignment: isUser
                ? MainAxisAlignment.end
                : MainAxisAlignment.start,
            children: [
              Flexible(
                child: Container(
                  padding: const EdgeInsets.symmetric(
                    horizontal: 16.0,
                    vertical: 12.0,
                  ),
                  decoration: BoxDecoration(
                    color: bubbleColor,
                    borderRadius: BorderRadius.only(
                      topLeft: const Radius.circular(20),
                      topRight: const Radius.circular(20),
                      bottomLeft: Radius.circular(isUser ? 20 : 0),
                      bottomRight: Radius.circular(isUser ? 0 : 20),
                    ),
                    boxShadow: [
                      BoxShadow(
                        color: Colors.black.withAlpha(20),
                        blurRadius: 4,
                        offset: const Offset(0, 2),
                      ),
                    ],
                    gradient: isUser
                        ? LinearGradient(
                            colors: [
                              colorScheme.primary,
                              colorScheme.primary.withAlpha(200),
                            ],
                            begin: Alignment.topLeft,
                            end: Alignment.bottomRight,
                          )
                        : null,
                  ),
                  child: Text(
                    text,
                    style: theme.textTheme.bodyLarge?.copyWith(
                      color: textColor,
                      height: 1.3,
                    ),
                  ),
                ),
              ),
            ],
          ),
          const SizedBox(height: 2),
        ],
      ),
    );
  }
}

MessageBubble হল একটি StatelessWidget যা একটি চ্যাট মেসেজ দেখায়। এই কোডল্যাবে পরে আপনার এবং এজেন্ট, উভয়ের মেসেজ দেখানোর জন্য এটি ব্যবহার করা হবে, তবে এটি মূলত একটি আকর্ষণীয় Text উইজেট।

main.dart-এ Chat UI প্রয়োগ করা

এই সম্পূর্ণ টেক্সট চ্যাটবট ইমপ্লিমেন্টেশন দিয়ে lib/main.dart-এর সম্পূর্ণ কন্টেন্ট পরিবর্তন করুন:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_ai/firebase_ai.dart';
import 'package:intro_to_genui/message_bubble.dart';
import 'firebase_options.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Just Today',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

sealed class ConversationItem {}

class TextItem extends ConversationItem {
  final String text;
  final bool isUser;
  TextItem({required this.text, this.isUser = false});
}

class _MyHomePageState extends State<MyHomePage> {
  final List<ConversationItem> _items = [];
  final _textController = TextEditingController();
  final _scrollController = ScrollController();
  late final ChatSession _chatSession;

  @override
  void initState() {
    super.initState();
    final model = FirebaseAI.googleAI().generativeModel(
      model: 'gemini-3.5-flash',
    );
    _chatSession = model.startChat();
    _chatSession.sendMessage(Content.text(systemInstruction));
  }

  void _scrollToBottom() {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if (_scrollController.hasClients) {
        _scrollController.animateTo(
          _scrollController.position.maxScrollExtent,
          duration: const Duration(milliseconds: 300),
          curve: Curves.easeOut,
        );
      }
    });
  }

  @override
  void dispose() {
    _textController.dispose();
    _scrollController.dispose();
    super.dispose();
  }

  Future<void> _addMessage() async {
    final text = _textController.text;

    if (text.trim().isEmpty) {
      return;
    }
    _textController.clear();

    setState(() {
      _items.add(TextItem(text: text, isUser: true));
    });

    _scrollToBottom();

    final response = await _chatSession.sendMessage(Content.text(text));

    if (response.text?.isNotEmpty ?? false) {
      setState(() {
        _items.add(TextItem(text: response.text!, isUser: false));
      });
      _scrollToBottom();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Just Today'),
      ),
      body: Column(
        children: [
          Expanded(
            child: ListView(
              controller: _scrollController,
              padding: const EdgeInsets.all(16),
              children: [
                for (final item in _items)
                  switch (item) {
                    TextItem() => MessageBubble(
                          text: item.text,
                          isUser: item.isUser,
                        ),
                  },
              ],
            ),
          ),
          SafeArea(
            child: Padding(
              padding: const EdgeInsets.symmetric(horizontal: 16.0),
              child: Row(
                children: [
                  Expanded(
                    child: TextField(
                      controller: _textController,
                      onSubmitted: (_) => _addMessage(),
                      decoration: const InputDecoration(
                        hintText: 'Enter a message',
                      ),
                    ),
                  ),
                  const SizedBox(width: 8),
                  ElevatedButton(
                    onPressed: _addMessage,
                    child: const Text('Send'),
                  ),
                ],
              ),
            ),
          ),
        ],
      ),
    );
  }
}

const systemInstruction = '''
  ## PERSONA
  You are an expert task planner.

  ## GOAL
  Work with me to produce a list of tasks that I should do today, and then track
  the completion status of each one.

  ## RULES
  Talk with me only about tasks that I should do today.
  Do not engage in conversation about any other topic.
  Do not offer suggestions unless I ask for them.
  Do not offer encouragement unless I ask for it.
  Do not offer advice unless I ask for it.
  Do not offer opinions unless I ask for them.

  ## PROCESS
  ### Planning
  *   Ask me for information about tasks that I should do today.
  *   Synthesize a list of tasks from that information.
  *   Ask clarifying questions if you need to.
  *   When you have a list of tasks that you think I should do today, present it
    to me for review.
  *   Respond to my suggestions for changes, if I have any, until I accept the
    list.

  ### Tracking
  *   Once the list is accepted, ask me to let you know when individual tasks are
    complete.
  *   If I tell you a task is complete, mark it as complete.
  *   Once all tasks are complete, send a message acknowledging that, and then
    end the conversation.
''';

আপনি যে main.dart ফাইলটি কপি-পেস্ট করেছেন সেটি Firebase AI Logic এবং systemInstruction-এ প্রম্পট ব্যবহার করে একটি প্রাথমিক ChatSession সেট-আপ করে। এটি TextItemটি এলিমেন্টের তালিকা বজায় রেখে কথোপকথনের টার্ন ম্যানেজ করে এবং আপনার আগে তৈরি করা MessageBubble উইজেট ব্যবহার করে ব্যবহারকারীর কোয়েরির পাশাপাশি সেগুলি দেখায়।

এগিয়ে যাওয়ার আগে এগুলি চেক করে দেখুন:

  • initState পদ্ধতিতে Firebase AI Logic-এর সাথে কানেকশন সেট-আপ করা হয়।
  • অ্যাপটি এজেন্টকে মেসেজ পাঠানোর জন্য একটি TextField ও বোতাম অফার করে।
  • _addMessage পদ্ধতিতে ব্যবহারকারীর মেসেজ এজেন্টের কাছে পাঠানো হয়।
  • _items তালিকায় কথোপকথনের ইতিহাস স্টোর করা হয়।
  • MessageBubble উইজেট ব্যবহার করে ListView-এ মেসেজ দেখানো হয়।

অ্যাপটি পরীক্ষা করা

এটি সেট-আপ করা হয়ে গেলে, আপনি অ্যাপটি রান করে পরীক্ষা করতে পারবেন।

flutter run -d chrome

আজকে আপনি যেসব কাজ করতে চান সেই সম্পর্কে এজেন্টের সাথে চ্যাট করে দেখুন। সম্পূর্ণ টেক্সট-ভিত্তিক UI-এর মাধ্যমে কাজ করা গেলেও, GenUI অভিজ্ঞতাকে আরও সহজ ও দ্রুত করে তুলতে পারে।

পরীক্ষা সম্পূর্ণ করার পরে, পরবর্তী ধাপে যাওয়ার আগে টার্মিনালে q (বা Ctrl+C) প্রেস করে চালু থাকা অ্যাপ বন্ধ করুন।

৪. GenUI প্যাকেজ ইন্টিগ্রেট করা

এখন সাধারণ টেক্সট থেকে জেনারেটিভ UI-তে আপগ্রেড করার সময়। আপনি GenUI Conversation, Catalog এবং SurfaceController অবজেক্টের জন্য বেসিক Firebase মেসেজিং লুপ অদলবদল করবেন। এটি AI মডেলকে চ্যাট স্ট্রিমের মধ্যে আসল Flutter উইজেট ইনস্ট্যান্টিয়েট করার অনুমতি দেয়।

GenUI ইন্টিগ্রেট করা অ্যাপের একটি ভার্সন

genui প্যাকেজ পাঁচটি ক্লাস প্রদান করে যা আপনি এই কোডল্যাব জুড়ে ব্যবহার করবেন:

  • SurfaceController স্ক্রিনে মডেলের মাধ্যমে তৈরি করা UI ম্যাপ করে।
  • A2uiTransportAdapter কোনও এক্সটার্নাল ল্যাঙ্গুয়েজ মডেলের সাথে ইন্টার্নাল GenUI অনুরোধের মধ্যে ব্রিজ তৈরি করে।
  • Conversation আপনার Flutter অ্যাপের জন্য একটি একক, ইউনিফায়েড API-এর মাধ্যমে কন্ট্রোলার এবং ট্রান্সপোর্ট অ্যাডাপ্টারকে র‍্যাপ করে।
  • Catalog ল্যাঙ্গুয়েজ মডেলে উপলভ্য উইজেট ও প্রপার্টি বর্ণনা করে।
  • Surface হল একটি উইজেট যা মডেলের মাধ্যমে তৈরি করা UI দেখায়।

জেনারেট করা Surface দেখানোর জন্য রেডি হন

lib/main.dart-এ, আগে থেকে থাকা কোডে একটি TextItem ক্লাস অন্তর্ভুক্ত থাকে যা কথোপকথনের মধ্যে একটি টেক্সট মেসেজকে উপস্থাপন করে। TextItem ক্লাসের ঠিক পরে, এজেন্টের তৈরি করা Surface দেখানোর জন্য একটি SurfaceItem ক্লাস যোগ করুন:

class TextItem extends ConversationItem {
  // ... existing code ...
}

// New!
class SurfaceItem extends ConversationItem {
  final String surfaceId;
  SurfaceItem({required this.surfaceId});
}

GenUI বিল্ডিং ব্লক ইনিশিয়ালাইজ করা

lib/main.dart-এর উপরে, genui লাইব্রেরি ইমপোর্ট করুন:

import 'package:genui/genui.dart' hide TextPart;
import 'package:genui/genui.dart' as genui;

genui প্যাকেজ এবং firebase_ai প্যাকেজ, দুটিতেই TextPart ক্লাস অন্তর্ভুক্ত আছে। genui এইভাবে ইমপোর্ট করার মাধ্যমে, আপনি TextPart-এর ভার্সনকে genui.TextPart হিসেবে নেমস্পেস করছেন, এর ফলে নামের সংঘর্ষ এড়ানো যাচ্ছে।

_chatSession-এর পরে _MyHomePageState-এ মূল কার্যকরী কন্ট্রোলার ঘোষণা করুন:

class _MyHomePageState extends State<MyHomePage> {
  // ... existing members
  late final ChatSession _chatSession;

  // Add GenUI controllers
  late final SurfaceController _controller;
  late final A2uiTransportAdapter _transport;
  late final Conversation _conversation;
  late final Catalog catalog;

এরপর, GenUI লাইব্রেরির কন্ট্রোলার প্রস্তুত করতে initState আপডেট করুন।

initState থেকে এই লাইনটি সরিয়ে দিন:

_chatSession.sendMessage(Content.text(systemInstruction));

তারপর, নিম্নলিখিত কোড যোগ করুন:

@override
void initState() {
  // ... existing code ...

  // Initialize the GenUI Catalog.
  // The genui package provides a default set of primitive widgets (like text
  // and basic buttons) out of the box using this class.
  catalog = BasicCatalogItems.asCatalog();

  // Create a SurfaceController to manage the state of generated surfaces.
  _controller = SurfaceController(catalogs: [catalog]);

  // Create a transport adapter that will process messages to and from the
  // agent, looking for A2UI messages.
  _transport = A2uiTransportAdapter(onSend: _sendAndReceive);

  // Link the transport and SurfaceController together in a Conversation,
  // which provides your app a unified API for interacting with the agent.
  _conversation = Conversation(
    controller: _controller,
    transport: _transport,
  );
}

এই কোডটি একটি Conversation ফ্যাকাড তৈরি করে যা কন্ট্রোলার এবং অ্যাডাপ্টার ম্যানেজ করে। সেই কথোপকথন আপনার অ্যাপকে ইভেন্টের একটি স্ট্রিম অফার করে যা এটি এজেন্ট কী তৈরি করছে তার সাথে তাল মিলিয়ে চলতে ব্যবহার করতে পারে, সেইসাথে এজেন্টকে মেসেজ পাঠানোর একটি পদ্ধতিও।

এরপর, কথোপকথন ইভেন্টের জন্য লিসেনার তৈরি করুন। এর মধ্যে সারফেস-সম্পর্কিত ইভেন্ট এবং টেক্সট মেসেজ ও সমস্যার জন্য ইভেন্ট অন্তর্ভুক্ত:

@override
void initState() {
  // ... existing code ...

  // Listen to GenUI stream events to update the UI
  _conversation.events.listen((event) {
    setState(() {
      switch (event) {
        case ConversationSurfaceAdded added:
          _items.add(SurfaceItem(surfaceId: added.surfaceId));
          _scrollToBottom();
        case ConversationSurfaceRemoved removed:
          _items.removeWhere(
            (item) =>
                item is SurfaceItem && item.surfaceId == removed.surfaceId,
          );
        case ConversationContentReceived content:
          _items.add(TextItem(text: content.text, isUser: false));
          _scrollToBottom();
        case ConversationError error:
          debugPrint('GenUI Error: ${error.error}');
        default:
      }
    });
  });
}

অবশেষে, সিস্টেম প্রম্পট তৈরি করে এজেন্টের কাছে পাঠান:

  @override
  void initState() {
    // ... existing code ...

    // Create the system prompt for the agent, which will include this app's
    // system instruction as well as the schema for the catalog.
    final promptBuilder = PromptBuilder.chat(
      catalog: catalog,
      systemPromptFragments: [systemInstruction],
    );

    // Send the prompt into the Conversation, which will subsequently route it
    // to Firebase using the transport mechanism.
    _conversation.sendRequest(
      ChatMessage.system(promptBuilder.systemPromptJoined()),
    );
  }

এছাড়াও, _MyHomePageState-এ dispose() পদ্ধতি আপডেট করুন যাতে উইজেট ডিসপোজ করার সময় নতুন যোগ করা GenUI কন্ট্রোলারগুলি সঠিকভাবে ক্লিন-আপ করা হয়:

  @override
  void dispose() {
    _conversation.dispose();
    _transport.dispose();
    _controller.dispose();
    _textController.dispose();
    _scrollController.dispose();
    super.dispose();
  }

ডিসপ্লে সারফেস

এরপর, _items তালিকায় SurfaceItems দেখাতে, ListView-এর build পদ্ধতি আপডেট করুন:

Expanded(
  child: ListView(
    controller: _scrollController,
    padding: const EdgeInsets.all(16),
    children: [
      for (final item in _items)
        switch (item) {
          TextItem() => MessageBubble(
            text: item.text,
            isUser: item.isUser,
          ),
          // New!
          SurfaceItem() => Surface(
            surfaceContext: _controller.contextFor(
              item.surfaceId,
            ),
          ),
        },
    ],
  ),
),

Surface উইজেটের কনস্ট্রাক্টর একটি surfaceContext নেয় যা এটিকে বলে যে কোন সারফেসের কন্টেন্ট দেখানোর দায়িত্ব এর। SurfaceController আগে তৈরি করা _controller, প্রতিটি সারফেসের সংজ্ঞা ও স্টেট প্রদান করে এবং কোনও আপডেট হলে এটি আবার তৈরি করা হয়।

Firebase AI Logic-এর সাথে GenUI কানেক্ট করা

genui প্যাকেজ "নিজের মডেল ব্যবহার করুন" পদ্ধতি ব্যবহার করে, এর অর্থ হল আপনার অভিজ্ঞতা কোন LLM দ্বারা পরিচালিত হবে তা আপনি নিয়ন্ত্রণ করেন। এই ক্ষেত্রে, আপনি Firebase AI Logic ব্যবহার করছেন, কিন্তু প্যাকেজটি বিভিন্ন ধরনের এজেন্ট ও পরিষেবা প্রদানকারীর সাথে কাজ করার জন্য তৈরি করা হয়েছে।

এই স্বাধীনতার ফলে কিছুটা অতিরিক্ত দায়িত্বও এসে পড়ে: আপনাকে genui প্যাকেজের মাধ্যমে তৈরি করা মেসেজ নিয়ে আপনার বেছে নেওয়া এজেন্টের কাছে পাঠাতে হবে এবং এজেন্টের উত্তর নিয়ে আবার genui-এ পাঠাতে হবে।

এটি করতে, আপনি আগের ধাপের কোডে উল্লেখ করা _sendAndReceive পদ্ধতিটি সংজ্ঞায়িত করবেন। lib/main.dart-এ, _MyHomePageState ক্লাসের মধ্যে _sendAndReceive যোগ করুন (যেমন, late final Catalog catalog; লাইনের ঠিক পরে):

class _MyHomePageState extends State<MyHomePage> {
  // ... existing code ...
  late final Catalog catalog;

  // New!
  Future<void> _sendAndReceive(ChatMessage msg) async {
    final buffer = StringBuffer();

    // Reconstruct the message part fragments
    for (final part in msg.parts) {
      if (part.isUiInteractionPart) {
        buffer.write(part.asUiInteractionPart!.interaction);
      } else if (part is genui.TextPart) {
        buffer.write(part.text);
      }
    }

    if (buffer.isEmpty) {
      return;
    }

    final text = buffer.toString();

    // Send the string to Firebase AI Logic.
    final response = await _chatSession.sendMessage(Content.text(text));

    if (response.text?.isNotEmpty ?? false) {
      // Feed the response back into GenUI's transportation layer
      _transport.addChunk(response.text!);
    }
  }

এজেন্টকে মেসেজ পাঠানোর প্রয়োজন হলেই genui প্যাকেজ এই পদ্ধতি ব্যবহার করবে। পদ্ধতির শেষে addChunk-এ কল করার মাধ্যমে এজেন্টের উত্তর genui প্যাকেজে ফিরে আসে, যা এটিকে উত্তর প্রসেস করতে এবং UI তৈরি করতে দেয়।

সবশেষে, আপনার আগে থেকে থাকা _addMessage পদ্ধতিটি সম্পূর্ণভাবে এই নতুন ভার্সন দিয়ে পাল্টে দিন, যাতে এটি সরাসরি Firebase-এর পরিবর্তে Conversation-এ মেসেজ রাউট করে:

  Future<void> _addMessage() async {
    final text = _textController.text;

    if (text.trim().isEmpty) {
      return;
    }

    _textController.clear();

    setState(() {
      _items.add(TextItem(text: text, isUser: true));
    });

    _scrollToBottom();

    // Send the user's input through GenUI instead of directly to Firebase.
    await _conversation.sendRequest(ChatMessage.user(text));
  }

ব্যস, এটুকুই যথেষ্ট! অ্যাপটি আবার রান করার চেষ্টা করুন। টেক্সট মেসেজ ছাড়াও, আপনি এজেন্টকে বোতাম, টেক্সট উইজেট এবং আরও অনেক কিছুর মতো UI সারফেস তৈরি করতে দেখবেন।

এমনকি, আপনি এজেন্টকে কোনও নির্দিষ্ট উপায়ে UI দেখানোর জন্য বলতে পারেন। যেমন, "আমার টাস্কগুলি একটি কলামে দেখাও, যেখানে প্রতিটি টাস্ক সম্পূর্ণ হিসেবে চিহ্নিত করার জন্য একটি বোতাম থাকবে" মেসেজটি লিখে দেখুন।

৫. অপেক্ষারত অবস্থা যোগ করুন

LLM জেনারেশন অ্যাসিঙ্ক্রোনাস। উত্তরের জন্য অপেক্ষা করার সময়, চ্যাট ইন্টারফেসকে ইনপুট বোতাম বন্ধ করতে হবে এবং প্রোগ্রেস ইন্ডিকেটর দেখাতে হবে যাতে ব্যবহারকারী জানতে পারেন যে GenUI কন্টেন্ট তৈরি করছে। সৌভাগ্যবশত, genui প্যাকেজে একটি Listenable আছে যা আপনি কথোপকথনের অবস্থা ট্র্যাক করতে ব্যবহার করতে পারেন। ConversationState ভ্যালুতে isWaiting প্রপার্টি থাকে যা নির্ধারণ করে যে মডেলটি কন্টেন্ট তৈরি করছে কিনা।

ValueListenableBuilder দিয়ে ইনপুট কন্ট্রোল র‍্যাপ করুন

lib/main.dart-এ _MyHomePageState-এর build পদ্ধতিতে, Column-এর নিচে SafeArea উইজেটটি খুঁজে নিন এবং এর চাইল্ড Row (যার মধ্যে আপনার TextField এবং ElevatedButton আছে) ValueListenableBuilder-এর সাথে র‍্যাপ করুন যা _conversation.state শোনে। state.isWaiting পরিদর্শন করে, মডেল কন্টেন্ট তৈরি করার সময় আপনি ইনপুট বন্ধ করে দিতে পারবেন:

SafeArea(
  child: Padding(
    padding: const EdgeInsets.symmetric(horizontal: 16.0),
    // Wrap the Row in a ValueListenableBuilder:
    child: ValueListenableBuilder<ConversationState>(
      valueListenable: _conversation.state,
      builder: (context, state, child) {
        return Row(
          children: [
            Expanded(
              child: TextField(
                controller: _textController,
                // Also disable the Enter key submission when waiting!
                onSubmitted: state.isWaiting ? null : (_) => _addMessage(),
                decoration: const InputDecoration(
                  hintText: 'Enter a message',
                ),
              ),
            ),
            const SizedBox(width: 8),
            ElevatedButton(
              // Disable the send button when the model is generating
              onPressed: state.isWaiting ? null : _addMessage,
              child: const Text('Send'),
            ),
          ],
        );
      },
    ),
  ),
),

প্রগ্রেস বার যোগ করা

_MyHomePageState-এর build পদ্ধতিতে, মূল Column উইজেটকে Stack-এর মধ্যে র‍্যাপ করুন এবং ValueListenableBuilder যোগ করুন যা LinearProgressIndicator-কে ওই Stack-এর দ্বিতীয় চাইল্ড হিসেবে রেন্ডার করে। সম্পূর্ণ হয়ে গেলে, আপনার Scaffold-এর body এমন দেখতে লাগবে:

body: Stack( // New!
  children: [
    Column(
      children: [
        // ... existing Expanded and SafeArea widgets ...
      ],
    ),
    // Listen to the state again, this time to render a progress indicator
    ValueListenableBuilder<ConversationState>(
      valueListenable: _conversation.state,
      builder: (context, state, child) {
        if (state.isWaiting) {
          return const LinearProgressIndicator();
        }
        return const SizedBox.shrink();
      },
    ),
  ],
),

৬. GenUI সারফেস সেভ করা

এতক্ষণ পর্যন্ত, স্ক্রল করা চ্যাট স্ট্রিমে টাস্ক তালিকা রেন্ডার করা হয়েছে, প্রতিটি নতুন মেসেজ বা সারফেস আসার সাথে সাথে তা তালিকায় যোগ করা হয়েছে। পরবর্তী ধাপে, আপনি দেখতে পাবেন কীভাবে সারফেসের নাম দিতে হয় এবং UI-এর মধ্যে নির্দিষ্ট লোকেশনে এটি দেখাতে হয়।

প্রথমে, lib/main.dart-এর উপরে, void main()-এর আগে, সারফেস আইডি হিসেবে ব্যবহার করার জন্য একটি কনস্ট্যান্ট ঘোষণা করুন:

const taskDisplaySurfaceId = 'task_display';

দ্বিতীয়ত, initState()-এ, Conversation লিসেনারে switch স্টেটমেন্ট আপডেট করুন যাতে নিশ্চিত করা যায় যে সেই আইডি সহ কোনও সারফেস _items-এ যোগ করা হয়নি। এটি করতে, if স্টেটমেন্টের মধ্যে _items.add(...) ও _scrollToBottom() লাইনগুলি র‍্যাপ করে _conversation.events.listen-এর মধ্যে case ConversationSurfaceAdded added: ব্রাঞ্চ আপডেট করুন:

_conversation.events.listen((event) {
  setState(() {
    switch (event) {
      case ConversationSurfaceAdded added:
        // Wrap these two lines in an if check:
        if (added.surfaceId != taskDisplaySurfaceId) {
          _items.add(SurfaceItem(surfaceId: added.surfaceId));
          _scrollToBottom();
        }
      case ConversationSurfaceRemoved removed:
        // ... existing code ...

এরপর, আপনার চ্যাট লগের ঠিক আগে পিন করা সারফেসের জন্য একটি স্পেস তৈরি করতে _MyHomePageState.build-এ আপনার উইজেট ট্রির লেআউট স্ট্রাকচার খুলুন। Column-এর প্রথম দুটি চাইল্ড হিসেবে AnimatedSize ও const Divider() যোগ করুন, ঠিক Expanded(child: ListView(...)) কোডের আগে:

body: Stack(
  children: [
    Column(
      children: [
        // Insert these two new widgets at the top of the Column:
        AnimatedSize(
          duration: const Duration(milliseconds: 300),
          child: Container(
            padding: const EdgeInsets.all(16),
            alignment: Alignment.topLeft,
            child: Surface(
              surfaceContext: _controller.contextFor(
                taskDisplaySurfaceId,
              ),
            ),
          ),
        ),
        const Divider(),
        Expanded(
          child: ListView(
            // ... existing code ...

এতদিন, আপনার এজেন্ট নিজের প্রয়োজন মতো সারফেস তৈরি ও ব্যবহার করতে পেরেছে। এটিকে আরও নির্দিষ্ট নির্দেশাবলী দিতে, আপনাকে সিস্টেম প্রম্পট আবার দেখতে হবে। systemInstruction ধ্রুবকে স্টোর করা প্রম্পটের শেষে নিম্নলিখিত ## USER INTERFACE বিভাগ যোগ করুন:

const systemInstruction = '''
  // ... existing prompt content ...

  ## USER INTERFACE
  *   To display the list of tasks create one and only one instance of the
    TaskDisplay catalog item. Use "$taskDisplaySurfaceId" as its surface ID.
  *   Update $taskDisplaySurfaceId as necessary when the list changes.
  *   $taskDisplaySurfaceId must include a button for each task that I can use
    to mark it complete. When I use that button to mark a task complete, it
    should send you a message indicating what I've done.
  *   Avoid repeating the same information in a single message.
  *   When responding with text, rather than A2UI messages, be brief.
''';

UI সারফেস কখন এবং কীভাবে ব্যবহার করতে হবে সেই সম্পর্কে আপনার এজেন্টকে স্পষ্ট নির্দেশাবলী দেওয়া গুরুত্বপূর্ণ। এজেন্টকে নির্দিষ্ট ক্যাটালগ আইটেম ও সারফেস আইডি ব্যবহার করতে (এবং একটি ইনস্ট্যান্স আবার ব্যবহার করতে) বলে, আপনি নিশ্চিত করতে সাহায্য করতে পারেন যে এটি আপনার পছন্দমতো ইন্টারফেস তৈরি করছে।

আরও কাজ করতে হবে, তবে UI-এর সবচেয়ে উপরে এজেন্ট যাতে টাস্ক ডিসপ্লে সারফেস তৈরি করে তা দেখতে আপনি আবার অ্যাপ রান করার চেষ্টা করতে পারেন।

৭. আপনার কাস্টম ক্যাটালগ উইজেট তৈরি করুন

এই মুহূর্তে, TaskDisplay ক্যাটালগ আইটেমটি নেই। পরবর্তী কয়েক ধাপে, আপনি ডেটা স্কিমা, সেই স্কিমা পার্স করার ক্লাস, উইজেট এবং ক্যাটালগ আইটেম তৈরি করে সেই সমস্যা সমাধান করবেন।

প্রথমে, আপনার প্রোজেক্টের lib/ ডিরেক্টরির অধীনে task_display.dart নামে একটি নতুন ফাইল তৈরি করুন এবং নিম্নলিখিত ইমপোর্ট যোগ করুন:

import 'package:flutter/material.dart';
import 'package:genui/genui.dart';
import 'package:json_schema_builder/json_schema_builder.dart';

ডেটা স্কিমা তৈরি করুন

এরপর, ডেটা স্কিমা নির্ধারণ করুন যা এজেন্ট কোনও টাস্ক ডিসপ্লে তৈরি করতে চাইলে প্রদান করবে। এই প্রসেসটি json_schema_builder প্যাকেজ থেকে কিছু উন্নত কনস্ট্রাক্টর ব্যবহার করে, কিন্তু মূলত আপনি শুধু এজেন্টকে পাঠানো ও এজেন্ট থেকে পাওয়া মেসেজে ব্যবহৃত JSON স্কিমা নির্ধারণ করছেন।

কম্পোনেন্টের নাম উল্লেখ করে একটি সাধারণ S.object দিয়ে শুরু করুন:

final taskDisplaySchema = S.object(
  properties: {
    'component': S.string(enumValues: ['TaskDisplay']),
  },
);

এরপর, স্কিমা প্রপার্টিতে title, tasks, name, isCompleted এবং completeAction যোগ করুন।

final taskDisplaySchema = S.object(
  properties: {
    'component': S.string(enumValues: ['TaskDisplay']),
    'title': S.string(description: 'The title of the task list'),
    'tasks': S.list(
      description: 'A list of tasks to be completed today',
      items: S.object(
        properties: {
          'name': S.string(description: 'The name of the task to be completed'),
          'isCompleted': S.boolean(
            description: 'Whether the task is completed',
          ),
          'completeAction': A2uiSchemas.action(
            description:
                'The action performed when the user has completed the task.',
          ),
        },
      ),
    ),
  },
);

completeAction প্রপার্টি দেখুন। এটি A2uiSchemas.action-এর মাধ্যমে তৈরি করা হয়েছে, যা একটি স্কিমা প্রপার্টির কনস্ট্রাক্টর এবং এটি A2UI অ্যাকশনকে দেখায়। স্কিমায় অ্যাকশন যোগ করার মাধ্যমে, অ্যাপটি মূলত এজেন্টকে বলছে, "শোনো, তুমি আমাকে কোনও টাস্ক দিলে, সেই সাথে এমন অ্যাকশনের নাম ও মেটাডেটাও দিও যা ব্যবহার করে আমি তোমাকে জানাতে পারব যে টাস্কটি সম্পূর্ণ হয়েছে।" পরে, ব্যবহারকারী যখন কোনও চেকবক্সে ট্যাপ করবেন, তখন অ্যাপ সেই অ্যাকশনটি ইনভোক করবে।

এরপর, স্কিমায় required ফিল্ড যোগ করুন। এগুলি এজেন্টকে প্রতিবার নির্দিষ্ট প্রপার্টি পপুলেট করার নির্দেশ দেয়। এই ক্ষেত্রে, প্রতিটি প্রপার্টি প্রয়োজন!

final taskDisplaySchema = S.object(
  properties: {
    'component': S.string(enumValues: ['TaskDisplay']),
    'title': S.string(description: 'The title of the task list'),
    'tasks': S.list(
      description: 'A list of tasks to be completed today',
      items: S.object(
        properties: {
          'name': S.string(description: 'The name of the task to be completed'),
          'isCompleted': S.boolean(
            description: 'Whether the task is completed',
          ),
          'completeAction': A2uiSchemas.action(
            description:
                'The action performed when the user has completed the task.',
          ),
        },
        // New!
        required: ['name', 'isCompleted', 'completeAction'],
      ),
    ),
  },
  // New!
  required: ['title', 'tasks'],
);

ডেটা পার্সিং ক্লাস তৈরি করুন

এই কম্পোনেন্টের ইনস্ট্যান্স তৈরি করার সময়, এজেন্ট স্কিমার সাথে ম্যাচ করা ডেটা পাঠাবে। ইনকামিং JSON-কে স্ট্রংলি-টাইপড ডার্ট অবজেক্টে পার্স করার জন্য দুটি ক্লাস যোগ করুন। লক্ষ্য করুন কীভাবে _TaskDisplayData রুট স্ট্রাকচার ম্যানেজ করে, যেখানে ইনার অ্যারে পার্সিংয়ের দায়িত্ব _TaskData-কে দেওয়া হয়।

class _TaskData {
  final String name;
  final bool isCompleted;
  final String actionName;
  final JsonMap? actionContext;

  _TaskData({
    required this.name,
    required this.isCompleted,
    required this.actionName,
    this.actionContext,
  });

  factory _TaskData.fromJson(Map<String, Object?> json) {
    try {
      final action = json['completeAction']! as JsonMap;
      final event = action['event']! as JsonMap;

      return _TaskData(
        name: json['name'] as String,
        isCompleted: json['isCompleted'] as bool,
        actionName: event['name'] as String,
        actionContext: event['context'] as JsonMap?,
      );
    } catch (e) {
      throw Exception('Invalid JSON for _TaskData: $e');
    }
  }
}

class _TaskDisplayData {
  final String title;
  final List<_TaskData> tasks;

  _TaskDisplayData({required this.title, required this.tasks});

  factory _TaskDisplayData.fromJson(Map<String, Object?> json) {
    try {
      return _TaskDisplayData(
        title: (json['title'] as String?) ?? 'Tasks',
        tasks: (json['tasks'] as List<Object?>)
            .map((e) => _TaskData.fromJson(e as Map<String, Object?>))
            .toList(),
      );
    } catch (e) {
      throw Exception('Invalid JSON for _TaskDisplayData: $e');
    }
  }
}

আপনি আগে Flutter ব্যবহার করে থাকলে, এই ক্লাসগুলি সম্ভবত আপনার তৈরি করা ক্লাসের মতোই। এগুলি একটি JsonMap গ্রহণ করে এবং JSON থেকে পার্স করা ডেটা সহ একটি স্ট্রংলি-টাইপ করা অবজেক্ট রিটার্ন করে।

_TaskData-এ actionName এবং actionContext ফিল্ড দেখুন। এগুলি JSON-এর completeAction প্রপার্টি থেকে এক্সট্র্যাক্ট করা হয় এবং এতে অ্যাকশনের নাম ও ডেটা কনটেক্সট (GenUI-এর ডেটা মডেলে অ্যাকশনের লোকেশনের রেফারেন্স) থাকে। এগুলি পরে UserActionEvent তৈরি করতে ব্যবহার করা হবে।

genui লাইব্রেরি দ্বারা পরিচালিত, সমস্ত ডায়নামিক UI স্টেটের জন্য ডেটা মডেল হল একটি কেন্দ্রীভূত, পর্যবেক্ষণযোগ্য স্টোর। এজেন্ট ক্যাটালগ থেকে কোনও UI কম্পোনেন্ট তৈরি করলে, এটি কম্পোনেন্টের স্কিমার সাথে মেলে এমন একটি ডেটা অবজেক্টও তৈরি করে। এই ডেটা অবজেক্ট ক্লায়েন্টের ডেটা মডেলে স্টোর করা হয়, যাতে এটি উইজেট তৈরি করতে এবং এজেন্টের কাছে পরবর্তী মেসেজে রেফারেন্স হিসেবে ব্যবহার করা যায় (যেমন completeAction আপনি একটি উইজেটের সাথে কানেক্ট করতে চলেছেন)।

উইজেট যোগ করুন

এখন, তালিকাটি দেখানোর জন্য একটি উইজেট তৈরি করুন। এটি _TaskDisplayData ক্লাসের একটি ইনস্ট্যান্স এবং কোনও টাস্ক সম্পূর্ণ হলে ইনভোক করার জন্য একটি কলব্যাক গ্রহণ করবে।

class _TaskDisplay extends StatelessWidget {
  final _TaskDisplayData data;
  final void Function(_TaskData) onCompleteTask;

  const _TaskDisplay({required this.data, required this.onCompleteTask});

  @override
  Widget build(BuildContext context) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      mainAxisSize: MainAxisSize.min,
      children: [
        Padding(
          padding: const EdgeInsets.all(16.0),
          child: Text(
            data.title,
            style: Theme.of(context).textTheme.titleLarge,
          ),
        ),
        ...data.tasks.map(
          (task) => CheckboxListTile(
            title: Text(
              task.name,
              style: TextStyle(
                decoration: task.isCompleted
                    ? TextDecoration.lineThrough
                    : TextDecoration.none,
              ),
            ),
            value: task.isCompleted,
            onChanged: task.isCompleted
                ? null
                : (val) {
                    if (val == true) {
                      onCompleteTask(task);
                    }
                  },
          ),
        ),
      ],
    );
  }
}

CatalogItem তৈরি করা

স্কিমা, পার্সার ও উইজেট তৈরি হয়ে গেলে, আপনি এখন CatalogItem তৈরি করতে পারবেন যাতে এগুলি সব একসাথে যুক্ত করা যায়।

task_display.dart-এর নিচে, টপ-লেভেল ভেরিয়েবেল হিসেবে taskDisplay তৈরি করুন, ইনকামিং JSON পার্স করতে _TaskDisplayData ব্যবহার করুন এবং _TaskDisplay উইজেটের একটি ইনস্ট্যান্স তৈরি করুন।

final taskDisplay = CatalogItem(
  name: 'TaskDisplay',
  dataSchema: taskDisplaySchema,
  widgetBuilder: (itemContext) {
    final json = itemContext.data as Map<String, Object?>;
    final data = _TaskDisplayData.fromJson(json);

    return _TaskDisplay(
      data: data,
      onCompleteTask: (task) async {
        // We will implement this next!
      },
    );
  },
);

onCompleteTask প্রয়োগ করুন

উইজেট কাজ করার জন্য, কোনও টাস্ক সম্পূর্ণ হলে এজেন্টকে তা জানাতে হবে। টাস্ক ডেটা থেকে completeAction ব্যবহার করে ইভেন্ট তৈরি ও ডিসপ্যাচ করতে, খালি onCompleteTask প্লেসহোল্ডারটি নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন।

onCompleteTask: (task) async {
  // A data context is a reference to a location in the data model. This line
  // turns that reference into a concrete data object that the agent can use.
  // It's kind of like taking a pointer and replacing it with the value it
  // points to.
  final JsonMap resolvedContext = await resolveContext(
    itemContext.dataContext,
    task.actionContext,
  );

  // Dispatch an event back to the agent, letting it know a task was completed.
  // This will be sent to the agent in an A2UI message that includes the name
  // of the action, the surface ID, and the resolved data context.
  itemContext.dispatchEvent(
    UserActionEvent(
      name: task.actionName,
      sourceComponentId: itemContext.id,
      context: resolvedContext,
    ),
  );
}

ক্যাটালগ আইটেম রেজিস্টার করুন

সবশেষে, main.dart খুলুন, নতুন ফাইল ইমপোর্ট করুন এবং অন্যান্য ক্যাটালগ আইটেমের সাথে এটি রেজিস্টার করুন।

lib/main.dart-এর সবচেয়ে উপরে এই ইমপোর্ট যোগ করুন:

import 'task_display.dart';

আপনার initState() ফাংশনে catalog = BasicCatalogItems.asCatalog();-এর পরিবর্তে এটি ব্যবহার করুন:

// The Catalog is immutable, so use copyWith to create a new version
// that includes our custom catalog item along with the basics.
catalog = BasicCatalogItems.asCatalog().copyWith(newItems: [taskDisplay]);

আপনি সম্পন্ন করেছেন! পরিবর্তন দেখতে অ্যাপ হট রিস্টার্ট করুন।

৮. এজেন্টের সাথে ইন্টার‍্যাক্ট করার বিভিন্ন উপায় নিয়ে পরীক্ষা-নিরীক্ষা করুন

Chrome-এ টাস্ক লিস্ট অ্যাপ চলছে

আপনি যেহেতু ক্যাটালগে নতুন উইজেট যোগ করেছেন এবং অ্যাপের UI-তে এর জন্য জায়গা তৈরি করেছেন, তাই এখন এজেন্টের সাথে কাজ করে কিছু মজা করার সময়। GenUI-এর অন্যতম প্রধান সুবিধা হল, এটি আপনার ডেটার সাথে ইন্টার‍্যাক্ট করার দুটি উপায় অফার করে: বোতাম ও চেকবক্সের মতো অ্যাপ্লিকেশন UI-এর মাধ্যমে এবং এমন এজেন্টের মাধ্যমে যা ন্যাচারাল ল্যাঙ্গুয়েজ বুঝতে পারে এবং ডেটা সম্পর্কে যুক্তি দিতে পারে। দুটি মোডই ব্যবহার করে দেখুন!

  • তিন বা চারটি টাস্কের বিবরণ দিতে টেক্সট ফিল্ড ব্যবহার করুন এবং সেগুলি তালিকায় দেখতে পাবেন।
  • কোনও টাস্ক সম্পূর্ণ বা অসম্পূর্ণ হিসেবে টগল করতে চেকবক্স ব্যবহার করুন।
  • ৫-৬টি টাস্কের একটি তালিকা তৈরি করুন, তারপর এজেন্টকে বলুন যেগুলির জন্য আপনাকে কোথাও ড্রাইভ করতে হবে সেগুলি সরিয়ে দিতে।
  • এজেন্টকে বলুন যে স্বতন্ত্র আইটেম হিসেবে পুনরাবৃত্তিমূলক টাস্কের একটি তালিকা তৈরি করতে ("আমাকে মা, বাবা ও দিদিমার জন্য হলিডে কার্ড কিনতে হবে। সেগুলির জন্য আলাদা আলাদা টাস্ক তৈরি করো।")।
  • এজেন্টকে সব টাস্ক সম্পূর্ণ বা অসম্পূর্ণ হিসেবে চিহ্নিত করতে অথবা প্রথম দুটি বা তিনটি টাস্ক চেক করতে বলুন।

৯. অভিনন্দন

অভিনন্দন! আপনি Generative UI এবং Flutter ব্যবহার করে একটি AI-পরিচালিত টাস্ক ট্র্যাকিং অ্যাপ তৈরি করেছেন।

আপনি যা শিখেছেন

  • Flutter Firebase SDK ব্যবহার করে Google-এর ফাউন্ডেশন মডেলের সাথে ইন্টার‍্যাক্ট করা
  • GenUI ব্যবহার করে Gemini-র তৈরি করা ইন্টার‍্যাক্টিভ সারফেস রেন্ডার করা
  • আগে থেকে নির্ধারিত স্ট্যাটিক রেন্ডারিং আইডি ব্যবহার করে লেআউটে সারফেস পিন করা
  • শক্তিশালী ইন্টার‍্যাকশন লুপের জন্য কাস্টম স্কিমা এবং উইজেট ক্যাটালগ ডিজাইন করা

রেফারেন্স ডকুমেন্ট