Table of Contents

ব্যবহারিক AI কর্মপ্রবাহ কোর্সে ফিরে যান

একটি লক্ষ্য লুপ কাজ পুনরাবৃত্তি করে, যতক্ষণ না নির্ধারিত ফল যাচাইয়ে উত্তীর্ণ হয় বা থামার নিয়ম কার্যকর হয়। কার্যকর লুপ বর্তমান অবস্থা পড়ে, একটি সীমিত পদক্ষেপ নেয়, ফল যাচাই করে এবং কী ঘটেছে তা লিখে রাখে। “চেষ্টা চালিয়ে যাও” ধরনের খোলা নির্দেশের নির্ভরযোগ্য সমাপ্তির নিয়ম নেই।

শেখার লক্ষ্য: আপনি একটি পরিচিত ব্যর্থ যাচাইসহ সীমাবদ্ধ ল্যাব লুপ চালাবেন এবং থামার সিদ্ধান্ত নথিভুক্ত করবেন।

মূল বিষয়গুলো

  • লক্ষ্য: পর্যবেক্ষণযোগ্য ভাষায় বর্ণিত ফল।
  • অবস্থা: বর্তমান ফাইল, আউটপুট, ত্রুটি এবং সোর্স রিভিশন।
  • যাচাই: লক্ষ্যের সঙ্গে যুক্ত পরীক্ষা বা পর্যালোচনা।
  • পুনঃচেষ্টার বাজেট: একটি ব্যর্থতার জন্য সর্বোচ্চ চেষ্টার সংখ্যা।
  • থামার নিয়ম: কাজ শেষ করা বা মানুষের সিদ্ধান্ত নেওয়া দরকার এমন শর্ত।

শুরু করার আগে

আগে যা লাগবে: কাজের প্যাকেট , যাচাই রেকর্ড এবং দায়িত্ব বণ্টনের পাঠ . ৪৫ মিনিট সময় রাখুন। কঠিনতার মাত্রা মধ্যম। কৃত্রিম ল্যাবের নতুন কপি ব্যবহার করুন, যাতে প্রথম ব্যর্থ যাচাইটি আগে থেকেই জানা থাকে।

লুপের চুক্তি লিখুন

স্ট্যাটাস ফিল্টারের অনুরোধের জন্য যেকোনো পুনঃচেষ্টার আগে চুক্তিটি নির্ধারণ করুন:

লক্ষ্য: ডিফল্ট আউটপুট না বদলে --status open|done সমর্থন করা।
উৎস: docs/requirements.md, রিভিশন 1।
অনুমোদিত ফাইল: task_report.py এবং নির্দিষ্ট পরীক্ষা।
যাচাই: ইউনিট পরীক্ষা, গণনা 4/2/2, অবৈধ মানে শূন্যের চেয়ে বড় এক্সিট কোড।
পুনঃচেষ্টার সীমা: প্রথম চেষ্টার পর সর্বোচ্চ দুটি সম্পাদনা।
সঙ্গে সঙ্গে থামুন: উৎসের দ্বন্দ্ব, অপ্রত্যাশিত ফাইল পরিবর্তন, গোপন তথ্য প্রকাশ,
অথবা এই অনুরোধের সঙ্গে সম্পর্কহীন প্রাথমিক পরীক্ষার ব্যর্থতা।
হস্তান্তর: চূড়ান্ত পার্থক্য, কমান্ড, আউটপুট, চেষ্টা এবং অমীমাংসিত সমস্যা জানান।

বাজেটটি কাজের নীতি, পণ্যের ডিফল্ট সেটিং নয়। ছোট ল্যাব কাজের পুনরাবৃত্ত ব্যর্থতা আড়াল না করে তা নির্ণয়ের জন্য দুটি পুনঃচেষ্টা যথেষ্ট। উৎপাদন কাজের জন্য ঝুঁকি ও পর্যালোচনা নিয়ে আলাদা সিদ্ধান্ত দরকার।

অবস্থার ছক ব্যবহার করুন

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

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

একটি ব্যর্থতা বিশ্লেষণ করুন

প্রথম চেষ্টার উদাহরণ: এজেন্ট ফিল্টার ও পরীক্ষা যোগ করে। open 2 দেখায়, কিন্তু --status invalid 0 দেখিয়ে সফলভাবে শেষ হয়। প্রয়োজন অনুযায়ী অবৈধ মানের জন্য শূন্য নয় এমন এক্সিট কোড দরকার। যাচাইটিকে ব্যর্থ হিসেবে চিহ্নিত করুন।

নির্ণয়: আর্গুমেন্ট যাচাই পরীক্ষা করুন। এজেন্ট অজানা মানকে ত্রুটি না ধরে ফাঁকা মিল হিসেবে নিয়েছে। গণনার আগে অনুমোদিত মান যাচাই করে এমন সীমিত সংশোধন চাইুন। অবৈধ ক্ষেত্র এবং আগের সব যাচাই আবার চালান।

চেষ্টা 1: অবৈধ স্ট্যাটাস সফলভাবে শেষ হয়েছে, তাই গ্রহণযোগ্যতা ব্যর্থ হয়েছে।
কারণ পাওয়া গেছে: গ্রহণযোগ্য মান যাচাই করা হয়নি।
চেষ্টা 2-এর অনুরোধ: অসমর্থিত মান প্রত্যাখ্যান করুন এবং 4/2/2 গণনা বজায় রাখুন।
প্রয়োজনীয় প্রমাণ: সম্পূর্ণ পরীক্ষা চালানো এবং অবৈধ কমান্ডের এক্সিট স্ট্যাটাস।

দ্বিতীয় চেষ্টার প্রত্যাশিত ফল: invalid-এর জন্য স্পষ্ট ত্রুটি এবং শূন্য নয় এমন এক্সিট কোড, বৈধ সংখ্যাগুলো অপরিবর্তিত থাকবে। দ্বিতীয় চেষ্টাও ব্যর্থ হলে নতুন কারণ শনাক্ত করার পরেই শেষ চেষ্টাটি ব্যবহার করুন। একই অনুরোধ পুনরাবৃত্তি করা নির্ণয় নয়।

অস্পষ্ট ফল সামলান

ফল ছাড়া কোনো প্রক্রিয়া থেমে যাওয়া সাফল্য নয়। সম্ভাব্য ফাইল লেখার পর কোনো টুলের সময়সীমা শেষ হলে সেটি আবার চালানোর আগে ফাইল ও Git-এর অবস্থা পরীক্ষা করুন। সংযুক্ত কোনো পরিষেবা অজানা ফল জানালে বাহ্যিক কাজটি আবার করার আগে বর্তমান অবস্থা পড়ুন। ল্যাবের বাইরে একাধিকবার পাঠানো, প্রকাশ করা বা লেখা বাস্তব ঝুঁকি তৈরি করে।

মানব পর্যালোচনার জন্য থামুন যদি শর্ত অন্য অনুমোদিত উৎসের সঙ্গে বিরোধ করে, অনুমতি কাজটি আটকে দেয়, পুনঃচেষ্টার বাজেট শেষ হয় বা অনুরোধ করা কাজ প্রকাশনার সীমা অতিক্রম করে। হস্তান্তরে সঠিক অবস্থা ও অমীমাংসিত সিদ্ধান্তটি উল্লেখ করুন।

লুপ ও মনিটর আলাদা রাখুন

সম্পাদনা লুপ সীমাবদ্ধ কাজের মধ্যে চলে এবং প্রতিটি পদক্ষেপের পরে ফল যাচাই করে। নির্ধারিত মনিটর পরে জেগে কোনো শর্ত পরীক্ষা করে। মনিটরের জন্য আলাদা সময়সূচি, পরিবর্তনের সীমা, বিজ্ঞপ্তির নিয়ম এবং থামার শর্ত দরকার। ল্যাবের সম্পাদনা লুপকে পুনরাবৃত্ত কাজ বানাবেন না। পরের পাঠে স্থায়ী সিস্টেম চালুর আগে মূল্যায়ন করা হবে।

নিয়ন্ত্রিত লুপ চালান

অপরিবর্তিত ল্যাব দিয়ে শুরু করুন। এর দুটি প্রাথমিক পরীক্ষা পাস করে। নতুন করে তৈরি কপিতে নিচের যাচাইসহ tests/test_loop_contract.py তৈরি করুন। এই ফাইলটি এমন একটি কাঙ্ক্ষিত সুবিধা নির্ধারণ করে যা প্রাথমিক প্রকল্পে নেই। এটি রক্ষণাবেক্ষণ করা প্রাথমিক ZIP ফাইলের অংশ নয়।

"""One controlled failing check for the status-filter exercise."""

import subprocess
import sys
import unittest
from pathlib import Path

ROOT = Path(__file__).resolve().parents[1]


class LoopContractTests(unittest.TestCase):
    def test_open_status_count(self):
        result = subprocess.run(
            [sys.executable, str(ROOT / "task_report.py"),
             str(ROOT / "tasks.json"), "--status", "open"],
            capture_output=True, text=True, check=False,
        )
        self.assertEqual(result.returncode, 0, result.stderr)
        self.assertEqual(result.stdout.strip(), "Total tasks: 2")


if __name__ == "__main__":
    unittest.main()

python3 -m unittest discover -s tests -v চালান। মূল দুটি পরীক্ষা পাস করা উচিত, আর নতুন চুক্তি পরীক্ষাটি ব্যর্থ হওয়া উচিত, কারণ প্রাথমিক প্রকল্পে --status নেই। প্রকৃত ব্যর্থতা লিখে রাখুন। পাঠ 0-এ দেখানোভাবে Git চালু করলে git status --short-এর ফলও নথিভুক্ত করুন। তা না হলে পরিবর্তিত ফাইলগুলো অপরিবর্তিত কপির সঙ্গে তুলনা করুন। Windows-এ সেটআপে launcher থাকলে py -3 ব্যবহার করুন।

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

পড়ার পথ: ব্যর্থ পরীক্ষাটি নথিভুক্ত করার পরে এই নতুন কপিতে পাঠ 5-এর সম্পূর্ণ উত্তর প্রয়োগ করুন। একই যাচাইগুলো আবার চালান এবং লিখুন যে এজেন্টের সম্পাদনা চালানো হয়নি। নিয়ন্ত্রিত চুক্তি পরীক্ষাটি রেখে দিন। পাস করানোর জন্য সেটি দুর্বল বা মুছে ফেলবেন না।

চেষ্টাঅবস্থা ও পর্যবেক্ষণসিদ্ধান্ত
সম্পাদনার আগেদুটি প্রাথমিক পরীক্ষা পাস করে, নতুন open যাচাই ব্যর্থ হয়একটি সীমাবদ্ধ সম্পাদনা নিয়ে এগোন
প্রতিটি সম্পাদনার পরেনির্দিষ্ট পরীক্ষা, সংখ্যা, অবৈধ মানের ননজিরো কোড এবং পরিবর্তিত ফাইল লিখুনগ্রহণ, নির্ণয় বা থামুন
বাজেট শেষ হলেবাকি ব্যর্থতা ও বর্তমান পার্থক্য লিখুনআর চেষ্টা না করে হস্তান্তর করুন

অনুশীলন ও যাচাই

আপনার ফল: নিয়ন্ত্রিত ব্যর্থ পরীক্ষা, আগে ও পরে দেখা আউটপুট, চেষ্টার লগ এবং গ্রহণ বা থামার চূড়ান্ত সিদ্ধান্ত। প্রথম সম্পাদনা পাস করলে একটি চেষ্টাই লিখুন। লগ পূরণ করতে দ্বিতীয় ব্যর্থতা বানাবেন না।

সম্পন্নতার যাচাই: চুক্তিতে উৎস, ফাইলের সীমা, পর্যবেক্ষণযোগ্য যাচাই, পুনঃচেষ্টার সীমা, অন্তত একটি তাৎক্ষণিক থামার শর্ত এবং হস্তান্তর উল্লেখ থাকে। লগে প্রকৃত ব্যর্থ পরীক্ষা, পরবর্তী যাচাইয়ের ফল এবং পাস বা বাজেটের কারণে থামার তথ্য থাকে। দ্বিতীয় চেষ্টায় নতুন কারণ উল্লেখ করা হয় এবং সেটি প্রথম চেষ্টার থেকে আলাদা।

আপনার বোঝাপড়া যাচাই করুন

  1. প্রশ্ন: প্রথম লাল চুক্তি পরীক্ষা কী প্রমাণ করে? উত্তর: সম্পাদনার আগে লেখা পরীক্ষা দেখায় যে প্রাথমিক প্রকল্পে অনুরোধ করা স্ট্যাটাস ফিল্টার নেই।
  2. প্রশ্ন: চেষ্টা বাকি থাকলেও কখন লুপ থামাতে হবে? উত্তর: সীমার বাইরের পরিবর্তন, অস্পষ্ট অনুমতি বা পরস্পরবিরোধী শর্ত থাকলে।

সমস্যা সমাধান

  • লুপ একই ব্যর্থতা পুনরাবৃত্তি করে: থামুন এবং কারণের নতুন অনুমান করুন।
  • যাচাই দুর্বল হয়ে যায়: আগের গ্রহণযোগ্যতার শর্ত ফিরিয়ে আনুন।
  • বাহ্যিক ফল অনিশ্চিত: আরেকটি চেষ্টা করার আগে বর্তমান অবস্থা পরীক্ষা করুন।
  • বাজেট শেষ: ব্যর্থতার লগ লুকানোর বদলে হস্তান্তর করুন।

পরবর্তী ধাপ

ঐচ্ছিক বিশেষায়িত এজেন্ট মূল্যায়ন চালিয়ে যান, অথবা সরাসরি AI কর্মপ্রবাহ কোর্সের সমাপনী প্রকল্পে যান। রানটাইমের বিকল্প জানতে এজেন্ট হারনেস নির্দেশিকা পড়ুন।

কোর্স নেভিগেশন: আগের পাঠ: এজেন্ট দায়িত্ব বণ্টন , কোর্সের রূপরেখা .