phongent টিউটোরিয়াল: iPhone বা Android দিয়ে একাধিক ফোন Agent সমন্বিতভাবে নিয়ন্ত্রণ

phongent কী

phongent হলো একাধিক ডিভাইসের Agent সমন্বিত নিয়ন্ত্রণের একটি প্রকল্প। এটি ব্যবহার করে আপনি প্রাকৃতিক ভাষায় সব ডিভাইস, কোনো ডিভাইস গ্রুপ বা নির্দিষ্ট ডিভাইসকে কাজ দিতে পারবেন এবং একটি ইন্টারফেসে কাজের অগ্রগতি, ফলাফল, বিজ্ঞপ্তি ও Android ডিভাইসের রিয়েল-টাইম স্ক্রিন দেখতে পারবেন।

iOS এবং Android উভয়ই মাস্টার ডিভাইস হিসেবে কাজ করতে পারে এবং Android এক্সিকিউশন ডিভাইসের সঙ্গে সংযোগ ও ব্যবস্থাপনা করতে পারে। উভয় প্ল্যাটফর্মেই কাজ বিতরণ, ফলাফল দেখা, বার্তা ব্যবস্থাপনা, রিয়েল-টাইম ছোট উইন্ডো ও নিয়ন্ত্রণ গ্রহণের সুবিধা রয়েছে; তবে শুধু Android-ই স্থানীয় App পরিচালনার কাজ সরাসরি সম্পাদন করতে পারে।

সতর্কতা: iOS বর্তমানে শুধু মাস্টার ডিভাইস হিসেবে Android এক্সিকিউশন ডিভাইসের সঙ্গে সংযোগ করতে পারে; iPhone-এর নিজস্ব App পরিচালনার কাজ সম্পাদন করতে পারে না।

মূল সুবিধা

• একাধিক ডিভাইসে কাজ বিতরণ: কোনো ডিভাইসে দীর্ঘক্ষণ চাপ দিয়ে কাজের বিবরণ দিন, অথবা মাস্টারের টাস্ক Agent-কে ডিভাইসগুলোতে কীভাবে কাজ পাঠানো হবে তা নির্ধারণ করতে দিন।
• ডিভাইস গ্রুপে সমন্বয়: একটি সম্পূর্ণ ডিভাইস গ্রুপ নির্বাচন করে ব্যাচে কাজ চালানো যায়; আবার বিভিন্ন গ্রুপ বা গ্রুপের নির্দিষ্ট ডিভাইসের জন্য আলাদা কাজও নির্ধারণ করা যায়।
• কনটেন্ট তৈরি ও বিতরণ: মাস্টার মডেল একাধিক লেখা ও টেক্সট কার্ড তৈরি করে বিভিন্ন ডিভাইসে সংশ্লিষ্ট কনটেন্ট পাঠাতে পারে এবং ছবিও সংযুক্ত করা যায়।
• Android রিয়েল-টাইম ছোট উইন্ডো: Android ভার্চুয়াল স্ক্রিন দেখা এবং ক্লিক, সোয়াইপ ও ইনপুটের মাধ্যমে ডিভাইসের নিয়ন্ত্রণ নেওয়া যায়। এই সুবিধা ডিফল্টভাবে চালু থাকে এবং সেটিংস থেকে বন্ধ করা যায়।
• কেন্দ্রীয় বার্তা ব্যবস্থাপনা: ডিভাইস, App ও বার্তার উৎস অনুযায়ী বিজ্ঞপ্তি সাজিয়ে সংশ্লিষ্ট Android ডিভাইসের Agent-কে উত্তর দিতে বলা যায়।
• কেন্দ্রীয় কনফিগারেশন: মেমোরি, দক্ষতা, নির্ধারিত কাজ ও অপারেশন রুট পরিচালনা করা যায়; একক ডিভাইস বা ব্যাচ অপারেশন বেছে নেওয়া যায়।
• সংযোগ ব্যবস্থাপনা: লোকাল নেটওয়ার্কে আবিষ্কার, প্রথম অনুমোদন, এক-ক্লিক সংযোগ, সংযোগ বিচ্ছিন্ন হলে পুনঃসংযোগ, ডিভাইসের নাম পরিবর্তন ও ডিভাইস গ্রিড সমর্থিত।

ইনস্টলের আগে প্রস্তুতি

ডিভাইস ও সিস্টেমের প্রয়োজনীয়তা

• এক্সিকিউশন ডিভাইস হিসেবে অন্তত একটি Android ডিভাইস প্রস্তুত রাখুন।
• মাস্টার ডিভাইস iPhone অথবা Android ডিভাইস হতে পারে।
• মাস্টার ও এক্সিকিউশন ডিভাইস একই লোকাল নেটওয়ার্কে সংযুক্ত থাকতে হবে।
• Android-এর ন্যূনতম ইনস্টল সংস্করণ Android 11; নির্দিষ্ট কাজের সক্ষমতা সিস্টেম সংস্করণ ও অনুমতি সেটিংসের ওপরও নির্ভর করবে।
• iOS-এর ন্যূনতম ডিপ্লয়মেন্ট সংস্করণ iOS 17; বর্তমানে Xcode দিয়ে বিল্ড, সাইন ও ইনস্টল করতে হবে।

সঠিক ইনস্টল প্যাকেজ নির্বাচন

Android ব্যবহারকারীরা প্রকল্পের রিলিজ পেজ থেকে phongent.apk ডাউনলোড করতে পারেন। phongent প্রকল্পের দেওয়া বিল্ড ব্যবহার করুন; আপস্ট্রিম প্রকল্পের APK ব্যবহার করবেন না, কারণ আপস্ট্রিম সংস্করণে একাধিক ডিভাইসের গ্রুপ নিয়ন্ত্রণের জন্য প্রয়োজনীয় ইন্টারফেস নাও থাকতে পারে।

দ্রুত কনফিগারেশন ও সংযোগ

1. App ইনস্টল করুন। Android ডিভাইসে phongent APK ইনস্টল করুন। iOS মাস্টার ডিভাইসের জন্য macOS-এ Xcode ব্যবহার করে বিল্ড, সাইন ও ইনস্টল করতে হবে।
2. Android এক্সিকিউশন ডিভাইস সেট করুন। App-এর মধ্যে প্রয়োজনীয় মডেল ও ফোন পরিচালনার সক্ষমতা কনফিগার করুন এবং প্রয়োজন অনুযায়ী Accessibility, বিজ্ঞপ্তি পড়া ইত্যাদির অনুমতি দিন। নিম্নস্তরের ফোন পরিচালনার সেটিংসের জন্য প্রকল্পের সেটআপ গাইড দেখুন।
3. এক্সিকিউশন ডিভাইসের সার্ভিস চালু রাখুন। নিশ্চিত করুন Android সার্ভিস চালু আছে এবং মাস্টার ডিভাইস ও Android এক্সিকিউশন ডিভাইস একই লোকাল নেটওয়ার্কে যুক্ত।
4. ডিভাইস সংযুক্ত করুন। মাস্টারের “ডিভাইস” পেজে আবিষ্কৃত Android ডিভাইস নির্বাচন করুন অথবা “এক-ক্লিক সংযোগ” ব্যবহার করুন। প্রথম সংযোগের সময় Android ডিভাইসে অনুমোদন নিশ্চিত করতে হবে।
5. মাস্টার মডেল কনফিগার করুন। মাস্টার সেটিংসে গিয়ে কাজ বোঝা ও বিতরণের জন্য দায়ী মডেল কনফিগার করুন। সংশ্লিষ্ট App-এর অ্যাকাউন্টগুলো সংশ্লিষ্ট এক্সিকিউশন ডিভাইসে লগইন করা থাকতে হবে।
6. সমন্বয় শুরু করুন। “agent” পেজে গিয়ে সব ডিভাইস, একটি ডিভাইস গ্রুপ বা একক ডিভাইস নির্বাচন করুন, তারপর প্রাকৃতিক ভাষায় কাজ লিখুন।

প্রথমবার অনুমোদনের পর ডিভাইস সংযোগ বিচ্ছিন্ন হলেও পুনরায় সংযুক্ত হতে পারে। কোনো ডিভাইস আবিষ্কৃত না হলে সঙ্গে সঙ্গে App পুনরায় ইনস্টল না করে আগে লোকাল নেটওয়ার্ক সংযোগ ও Android সার্ভিসের অবস্থা পরীক্ষা করুন।

চারটি প্রধান প্রবেশপথ

• ডিভাইস: Android ডিভাইস আবিষ্কার, সংযোগ, নাম পরিবর্তন ও গ্রুপে সাজানো।
• agent: কাজ বিতরণ এবং কাজের অগ্রগতি, ফলাফল ও রিয়েল-টাইম ছোট উইন্ডো দেখা।
• বার্তা: ডিভাইস, App ও উৎস অনুযায়ী বিজ্ঞপ্তি দেখা এবং উত্তর দেওয়ার কাজ শুরু করা।
• সেটিংস: মাস্টার মডেল, এক্সিকিউশন ডিভাইসের সক্ষমতা ও সংশ্লিষ্ট সিঙ্ক অপশন কনফিগার করা।

মৌলিক ব্যবহার: ডিভাইসে কাজ পাঠানো

বিভিন্ন ডিভাইসে আলাদা কাজ দিন

ধরা যাক ডিভাইসগুলোর নাম A ও B। প্রতিটি ডিভাইসকে কী করতে হবে তা সরাসরি কাজে উল্লেখ করতে পারেন:

A Xiaohongshu-এর হোমপেজ খুলে স্ক্রিনশট নাও, B ব্রাউজার খুলে আজকের আবহাওয়া দেখো।

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

ডিভাইস গ্রুপ অনুযায়ী ব্যাচ সমন্বয়

কনটেন্ট তৈরি, পরীক্ষা বা অপারেশনের মতো পুনরাবৃত্ত কাজের জন্য আগে একটি ডিভাইস গ্রুপ তৈরি করুন, তারপর গ্রুপের নাম ব্যবহার করে কাজ দিন:

কনটেন্ট গ্রুপের প্রতিটি ডিভাইস আলাদা একটি পণ্য পরিচিতির খসড়া তৈরি করুক, পরীক্ষা গ্রুপের ডিভাইসগুলোর কাজের অবস্থা দেখো।
কনটেন্ট গ্রুপের A-কে বিদ্যমান উপকরণ整理 করতে দাও, বাকি ডিভাইসগুলো খসড়া তৈরি করতে থাকুক।

এ ধরনের বিবরণে পুরো গ্রুপের জন্য একই লক্ষ্য নির্ধারণ করা যায়, আবার গ্রুপের নির্দিষ্ট কোনো ডিভাইসের কাজও পরিবর্তন করা যায়।

বিভিন্ন কনটেন্ট তৈরি ও বিতরণ

প্রতিটি ডিভাইসকে আলাদা উপকরণ দিয়ে কাজ করাতে হলে মাস্টার মডেলকে আলাদা কনটেন্ট তৈরি করতে বলে একেকটি ডিভাইসে পাঠাতে পারেন:

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

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

ডিভাইস গ্রুপ তৈরি ও পরিচালনা

1. “ডিভাইস” পেজ খুলুন। নিচের গ্রিডে বর্তমানে সংযুক্ত ডিভাইস, প্রতিটি ডিভাইসের নাম ও所属 গ্রুপ দেখা যাবে।
2. “গ্রুপ” এ ক্লিক করে পরিচালনা করতে চান এমন ডিভাইসগুলো নির্বাচন করুন।
3. বিদ্যমান গ্রুপ নির্বাচন করুন অথবা নতুন গ্রুপ তৈরি করুন।
4. “Nটি ডিভাইস সরান” এ ক্লিক করে ব্যাচে সরানো সম্পন্ন করুন।

প্রতিটি ডিভাইস কেবল একটি গ্রুপের সদস্য হতে পারে। সরানোর পর সেটি আগের গ্রুপ থেকে বেরিয়ে যাবে। হাতে গ্রুপে না সাজানো ডিভাইসগুলো “ডিফল্ট গ্রুপ”-এ যুক্ত হবে।

ডিভাইসের অবতার বা কার্ডে দীর্ঘক্ষণ চাপ দিলে ডিভাইসের নাম পরিবর্তন বা গ্রুপ বদলানো যায়। ডিভাইসের নাম পরিবর্তন সংশ্লিষ্ট Android App-এ সিঙ্ক করার চেষ্টা করবে, তবে এর জন্য এক্সিকিউশন ডিভাইসে সংশ্লিষ্ট ইন্টারফেস সমর্থিত হতে হবে।

গ্রুপের তথ্য বর্তমান মাস্টার ডিভাইসে সংরক্ষিত হয় এবং অন্য মাস্টার ডিভাইসে স্বয়ংক্রিয়ভাবে সিঙ্ক হয় না। একাধিক মাস্টার ডিভাইসের পরিবেশে প্রতিটি মাস্টার ডিভাইসের গ্রুপ আলাদাভাবে পরিচালনা করতে হবে।

বিজ্ঞপ্তি কেন্দ্রীয়ভাবে দেখা ও উত্তর দেওয়া

phongent অনুমোদিত Android বিজ্ঞপ্তি পড়তে পারে এবং ডিভাইস, App ও বার্তার উৎস অনুযায়ী সেগুলো সাজাতে পারে। “বার্তা” পেজে গিয়ে বিজ্ঞপ্তির বিস্তারিত দেখা যায় এবং সংশ্লিষ্ট Android ডিভাইসের Agent-কে উত্তর দেওয়ার কাজ দেওয়া যায়।

1. নিশ্চিত করুন লক্ষ্য Android ডিভাইসে বিজ্ঞপ্তি পড়ার অনুমতি দেওয়া হয়েছে।
2. মাস্টার ডিভাইসে “বার্তা” প্রবেশপথ খুলুন।
3. ডিভাইস, App বা উৎস অনুযায়ী লক্ষ্য বিজ্ঞপ্তি খুঁজুন।
4. বিজ্ঞপ্তির বিস্তারিত খুলে উত্তর দেওয়ার কাজ শুরু করুন।
5. লক্ষ্য Android ডিভাইসের Agent বাস্তব উত্তর দেওয়ার কাজ সম্পন্ন করবে।

মাস্টার ডিভাইসে বিজ্ঞপ্তি দেখা না গেলে আগে লক্ষ্য Android ডিভাইসের বিজ্ঞপ্তি পড়ার অনুমতি, এক্সিকিউশন সার্ভিস ও সংযোগের অবস্থা পরীক্ষা করুন।

উন্নত ব্যবহারের কৌশল

কাজের বিবরণ সহজে সম্পাদনযোগ্য করুন

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

রিয়েল-টাইম ছোট উইন্ডো যথাযথভাবে ব্যবহার করুন

Agent-এর কাজ পর্যবেক্ষণ বা স্বয়ংক্রিয় কাজের সময় পেজ পরিবর্তিত হলে হাতে নিয়ন্ত্রণ নেওয়ার জন্য রিয়েল-টাইম ছোট উইন্ডো উপযোগী। এটি ডিফল্টভাবে চালু থাকে; রিয়েল-টাইম স্ক্রিনের প্রয়োজন না হলে সেটিংস থেকে বন্ধ করতে পারেন।

একাধিক এক্সিকিউশন ডিভাইস রক্ষণাবেক্ষণ

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

সংযোগের সমস্যা সমাধান

• নিশ্চিত করুন মাস্টার ও এক্সিকিউশন ডিভাইস একই লোকাল নেটওয়ার্কে আছে।
• নিশ্চিত করুন Android এক্সিকিউশন সার্ভিস এখনও চলছে।
• প্রথম সংযোগের সময় Android ডিভাইসে অনুমোদন সম্পন্ন করুন।
• অনুমোদিত ডিভাইস সংযোগ বিচ্ছিন্ন হলে পুনরায় সংযোগ বা “এক-ক্লিক সংযোগ” ব্যবহার করে দেখুন।
• ডিভাইস গ্রিডে কেবল সংযুক্ত ডিভাইস দেখা যায়; কোনো ডিভাইস না দেখা যাওয়া মানে এটি সফলভাবে সংযুক্ত হয়েছে এমন নয়।

সোর্স কোড থেকে Android সংস্করণ বিল্ড

প্রকল্পের Android App, মাস্টার ইন্টারফেস ও এক্সিকিউশন সার্ভিস app/-এ, আর Agent-এর মূল সক্ষমতা core/-এ রয়েছে। বিল্ডের জন্য JDK 17 ও Android SDK প্রয়োজন; বর্তমানে compileSdk 36 ব্যবহার করা হচ্ছে।

./gradlew :app:assembleDebug

ডিবাগ APK app/build/outputs/apk/debug/-এ তৈরি হবে। ইনস্টলের আগে নিশ্চিত করুন বিল্ড আউটপুটটি আপনার নিজস্ব ডেভেলপমেন্ট সিগনেচার দিয়ে সাইন করা হয়েছে।

সোর্স কোড থেকে iOS মাস্টার বিল্ড

iOS বিল্ডের জন্য macOS এবং প্রকল্পে ব্যবহৃত SDK সমর্থন করে এমন Xcode প্রয়োজন। ন্যূনতম ডিপ্লয়মেন্ট সংস্করণ iOS 17।

1. Xcode দিয়ে ios/MikaRemote.xcodeproj খুলুন।
2. MikaRemote scheme নির্বাচন করুন।
3. সাইনিং সেটিংসে নিজের ডেভেলপমেন্ট টিম নির্বাচন করুন।
4. লক্ষ্য iPhone সংযুক্ত করে বিল্ড ও ইনস্টল করুন।

রিপোজিটরির ios/ ডিরেক্টরিতে iOS মাস্টার, কম্পোনেন্ট ও লাইভ অ্যাক্টিভিটি রয়েছে; tools/android-emulators/ Android এমুলেটর ইন্টিগ্রেশন টেস্টের সরঞ্জাম দেয়; সেটআপ গাইড, প্রোটোকল ও যাচাইয়ের রেকর্ড docs/-এ রয়েছে।

নিরাপত্তা সতর্কতা: মডেল কী, অ্যাকাউন্টের শংসাপত্র ও স্থানীয় সাইনিং উপকরণ সোর্স কোডে লেখা বা ভার্সন রিপোজিটরিতে জমা দেওয়া উচিত নয়।

সারসংক্ষেপ

phongent একাধিক Android ডিভাইসকে কেন্দ্রীয়ভাবে পরিচালনাযোগ্য Agent এক্সিকিউশন পরিবেশে সংগঠিত করে এবং iPhone বা Android ডিভাইসকে মাস্টার হিসেবে ব্যবহার করার সুযোগ দেয়। এক্সিকিউশন ডিভাইসের অনুমতি, লোকাল নেটওয়ার্ক সংযোগ ও মাস্টার মডেল কনফিগারেশন সম্পন্ন হলে একক ডিভাইস, ডিভাইস গ্রুপ বা সব ডিভাইসে কাজ বিতরণ করা যায় এবং ফলাফল, রিয়েল-টাইম স্ক্রিন ও বিজ্ঞপ্তি দেখা যায়। প্রকল্পটি Mika-এর ওপর ভিত্তি করে তৈরি এবং Apache License 2.0 অনুসরণ করে।