AgentsView একাধিক টুলের কোডিং এজেন্টের সেশন লগ একত্র করে অনুসন্ধানযোগ্য একটি স্থানীয় আর্কাইভে রাখতে পারে। এই নির্দেশিকা এমন প্রকৌশলপ্রধানের জন্য, যাঁকে একটি পরিচিত কাজ খুঁজতে হবে, এজেন্ট আসলে যে ব্যবহারের ক্ষেত্রগুলো লিখেছে সেগুলো দেখতে হবে এবং খরচের প্রতিটি সংখ্যার উৎস শনাক্ত করতে হবে।

এই ধাপভিত্তিক নির্দেশনা AgentsView-এর 9 অক্টোবর 2026-এর v0.45.0 সংস্করণ এবং বর্তমান দ্রুত-শুরু ও টোকেন-ব্যবহারের নির্দেশিকার নথির ওপর ভিত্তি করে তৈরি; সেগুলো 17 অক্টোবর পরীক্ষা করা হয়েছে। BIG CHANGE AgentsView ইনস্টল করেনি, ট্রান্সক্রিপ্ট আমদানি করেনি বা এসব ধাপ পরীক্ষা করেনি। যে সংস্করণ ইনস্টল করছেন তা যাচাই করুন, কারণ নথি ও প্রকাশিত সংস্করণের তালিকা বদলাতে পারে।

শুরুর আগে

আপনার পড়ার অনুমতি রয়েছে এমন একটি সম্পন্ন কোডিং এজেন্ট সেশন, ওই কাজের স্বতন্ত্র বাক্যাংশ বা সেশন ID এবং তার স্থানীয় লগ ডিরেক্টরি পড়ার অনুমতি লাগবে। Quick Start-এ macOS, Windows ও Linux-এর ডেস্কটপ ডাউনলোডের তালিকা আছে; CLI wheel রয়েছে Linux x86_64 ও aarch64, macOS x86_64 ও arm64 এবং Windows x86_64 ও arm64-এর জন্য। ডেস্কটপ অ্যাপ বান্ডল করা; সোর্স থেকে বিল্ড করতে Go, Node ও CGO-এর আলাদা শর্ত আছে। দ্রুত-শুরু নির্দেশিকা অনুযায়ী সাধারণ স্থানীয় আর্কাইভের জন্য হোস্টেড অ্যাকাউন্ট বা API কী লাগে না।

সেশন লগে প্রম্পট, সোর্স কোড, টুলের ইনপুট ও গোপন তথ্য থাকতে পারে। দল আপনাকে পরীক্ষা করার অনুমতি দেয় শুধু এমন ডিরেক্টরি বেছে নিন। আর্কাইভ কোন প্রদানকারী ও মূল ডিরেক্টরি থেকে তথ্য নেবে তা ঠিক করুন প্রথমবার চালুর আগে: কোনো অতিরিক্ত বিকল্প ছাড়া agentsview serve চালালেই সমর্থিত ডিফল্ট উৎস খুঁজে নিয়ে সঙ্গে সঙ্গে সিঙ্ক করা হয়। এই অনুশীলনে ওয়েব UI-কে নথিভুক্ত লুপব্যাক ঠিকানায় রাখুন। শুধু এই প্রশ্নের উত্তর পেতে হোস্টেড কাঁচা ডেটা সিঙ্ক, PostgreSQL বা ClickHouse-এ পাঠানো, Gist প্রকাশনা, তৈরি করা ইনসাইট বা হোস্টেড এমবেডিং এন্ডপয়েন্ট চালু করবেন না। অর্থভিত্তিক অনুসন্ধান ঐচ্ছিক; সাধারণ পূর্ণ-পাঠ অনুসন্ধান স্থানীয় সূচি দিয়ে কাজ করে।

1. ইনস্টল করুন ও নির্বাহযোগ্য ফাইল শনাক্ত করুন

এই ইনস্টলেশন নির্দেশিকা থেকে একটি পদ্ধতি বেছে নিন। স্বতন্ত্র CLI-এর জন্য নথিভুক্ত স্থায়ী Python ইনস্টলেশন হলো:

Terminal
pip install agentsview
agentsview --version

নির্দেশিকায় uvx agentsview দিয়ে স্থায়ী ইনস্টলেশন ছাড়া চালানো, প্ল্যাটফর্মের ইনস্টলার এবং ডেস্কটপ প্যাকেজও আছে। macOS-এ Homebrew cask অ্যাপের বান্ডল করা CLI-এর লিংক দেয়; DMG থেকে ইনস্টল করা অ্যাপের CLI ডিরেক্টরি যোগ করতে হতে পারে PATH-এ। সংস্করণ বিশ্বাস করার আগে শেল কোন নির্বাহযোগ্য ফাইল খুঁজে পাচ্ছে তা নিশ্চিত করুন। GitHub v0.45.0-কে 9 অক্টোবরের প্রকাশনা বলে চিহ্নিত করে, কিন্তু পর্দা ও রিপোর্টের স্কিমা বোঝার সময় নিজের --version ফল ব্যবহার করুন।

2. প্রথম সিঙ্কের আগে উৎস সীমিত করুন

হোস্ট CLI বা ডেস্কটপ ইনস্টলেশনের জন্য নতুন ডেটা ডিরেক্টরি ও তার config.toml আগে প্রস্তুত করুন, তারপর AgentsView চালু করুন। কনফিগারেশন নির্দেশিকা জানায় কীভাবে disabled_agents দিয়ে স্থানীয় ফাইলসিস্টেমের প্রদানকারী বাদ দেওয়া এবং [agents.<id>].dirs দিয়ে একটি প্রদানকারীর ডিফল্ট মূল ডিরেক্টরি বদলানো যায়। ওই নির্দেশিকার অন্য সব প্রদানকারীর ID সংগ্রহ করুন তার Session Discovery সারণি থেকে এবং disabled_agents এ তালিকাভুক্ত করুন; একমাত্র অনুমোদিত প্রদানকারীর dirs মানটি অনুমোদিত মূল ডিরেক্টরিতে নির্ধারণ করুন। যেমন, [agents.codex]-এর সঙ্গে dirs = ["/approved/codex/sessions"] দিলে Codex-এর ডিফল্ট ডিরেক্টরি বদলে যায়; নিজের সিস্টেম অনুযায়ী পথ ঠিক করুন। সম্পূর্ণ বাদ দেওয়ার তালিকা না থাকলে এখনো হোস্ট ডেমন চালু করবেন না। শুধু CODEX_SESSIONS_DIR বা CLAUDE_PROJECTS_DIR বদলালে ওই প্রদানকারীর মূল পথ বদলায়, কিন্তু অন্য প্রদানকারীরা নিজেদের ডিফল্ট অনুসন্ধানের জন্য সক্রিয় থাকতে পারে।

বিদ্যমান আর্কাইভে ইতিমধ্যে সম্পর্কহীন সেশন থাকতে পারে মনে হলে এই নিরীক্ষায় নতুন AGENTSVIEW_DATA_DIR ব্যবহার করুন। কনফিগারেশন নির্দেশিকা বলে, নিষ্ক্রিয় প্রদানকারীর আগে আর্কাইভ করা সেশন পাওয়া যায়; তাই সেটিং বদলালে পুরোনো আর্কাইভ পরিষ্কার হয় না। আরও বলা হয়েছে, disabled_agents স্থানীয় উৎস খোঁজা ও নজরদারি নিয়ন্ত্রণ করে, দূরবর্তী আমদানি বা রপ্তানি নয়; এই স্থানীয় কাজে দূরবর্তী হোস্ট ও রপ্তানির গন্তব্য কনফিগার করবেন না।

অন্য সব প্রদানকারী বাদ দেওয়ার তালিকা রাখা অবাস্তব হলে বিচ্ছিন্ন কনটেইনার বিকল্প। Quick Start-এর Docker উদাহরণ UI প্রকাশ করে শুধু 127.0.0.1-এ, একটি এজেন্টের উৎস শুধু-পাঠযোগ্য অবস্থায় মাউন্ট করে এবং আলাদা ডেটা ভলিউম ব্যবহার করে। মাউন্ট করুন শুধু অনুমোদিত উৎসের মূল ডিরেক্টরি এবং নতুন কনটেইনারে তার সঙ্গে মেলা ডিরেক্টরি ভেরিয়েবল নির্ধারণ করুন; অন্য মাউন্টগুলো বাদ দিন প্রকল্পের Compose উদাহরণ থেকে। কনটেইনার কেবল স্পষ্টভাবে মাউন্ট করা হোস্টের সেশন ডিরেক্টরি দেখতে পায়। প্রকাশিত Docker ইমেজ Linux amd64 ও arm64 সমর্থন করে; এই পথের জন্য কার্যকর Docker ইনস্টলেশন লাগবে।

3. স্থানীয় আর্কাইভ তৈরি করুন

সীমিত উৎসের হোস্ট CLI-এর জন্য নথিভুক্ত সম্মুখভাগের সার্ভার চালু করুন:

Terminal
agentsview serve

2 নম্বর ধাপে উৎসের সীমা প্রয়োগ ও পরীক্ষা করার পর এটি প্রস্তুত করে ~/.agentsview/sessions.db বা বেছে নেওয়া ডেটা ডিরেক্টরি, সক্রিয় এজেন্ট লগ খুঁজে সিঙ্ক করে, পরিবর্তন নজরদারি করে এবং খোলে http://127.0.0.1:8080। ওই টার্মিনাল খোলা রাখুন। পেছনে চলা প্রক্রিয়া চাইলে ব্যবহার করুন agentsview daemon start এবং agentsview daemon status; ডেস্কটপ অ্যাপ নিজের ব্যাকএন্ড পরিচালনা করে। সামঞ্জস্যপূর্ণ সার্ভার আগে থেকেই চললে শুধু নিজের URL জানাতে পারে; তাই নতুন কনফিগারেশন তথ্য সংগ্রহ নিয়ন্ত্রণ করেছে ধরে নেওয়ার আগে চলমান ডেমন আছে কি না দেখুন।

বিচ্ছিন্ন কনটেইনার বেছে নিলে তার একটিমাত্র শুধু-পাঠযোগ্য উৎস মাউন্ট ও নতুন ডেটা ভলিউম পরীক্ষা করে নথিভুক্ত Docker কমান্ডে চালু করুন। এর লুপব্যাক UI ব্যবহার করুন এবং পরের agentsview CLI রিপোর্ট কনটেইনারের ভেতরে চালান, যাতে একই আর্কাইভ পড়া হয়। পাশাপাশি উৎসের সীমা ছাড়া হোস্টে serve চালাবেন না।

পরিচিত কাজের উৎস দেখা যাচ্ছে এবং অনাকাঙ্ক্ষিত প্রদানকারীরা দেখা যাচ্ছে না নিশ্চিত করুন। সেশন না পেলে সেশন নেই বলার আগে অনুমোদিত পথ, প্রদানকারীর সেটিং ও সিঙ্কের অবস্থা দেখুন। রিপোর্টের আগে সদ্য বদলানো ফাইলগুলো যুক্ত করা দরকার হলে চালান agentsview sync; সার্ভারও পরিবর্তন নজরদারি করে। সম্পূর্ণ পুনঃসিঙ্কের আগে কনফিগার করা সীমা আবার যাচাই করুন।

4. কাজ খুঁজুন ও ট্রান্সক্রিপ্ট যাচাই করুন

ওয়েব UI-তে Ctrl/Cmd+K দিয়ে পরিচিত কাজের একটি স্বতন্ত্র বাক্যাংশ হুবহু খুঁজুন। প্রকল্প, এজেন্ট বা তারিখ দিয়ে তালিকা সংকুচিত করুন; তারপর সম্ভাব্য সেশন খুলে বার্তা ও টুল কল দেখুন। পুরো সেশন ID বা UUID জানা থাকলে Ctrl/Cmd+G সরাসরি তা খোলে। এই নিয়ন্ত্রণগুলো বর্ণিত আছে Quick Start-এ। ব্যবহারের ফল সঠিক কথোপকথনের সঙ্গে মেলাতে এজেন্ট, সেশন ID ও তারিখ লিখে রাখুন।

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

5. সেশনের ব্যবহারের ক্ষেত্রগুলো দেখুন

মিলে যাওয়া সেশনের ব্যবহার-দৃশ্য খুলে নথিভুক্ত মডেল, ইনপুট, আউটপুট, ক্যাশ তৈরি ও ক্যাশ পড়ার যে ক্ষেত্রগুলো আছে সেগুলো শনাক্ত করুন। টোকেন-ব্যবহারের নির্দেশিকা খরচের রিপোর্টকে বলেছে পরীক্ষামূলক এবং এখনো পরিণত হচ্ছে। AgentsView উৎস লগ থেকে মডেল ও টোকেনের মেটাডেটা নেয় এবং বার্তার সারিতে কাঁচা টোকেন-ব্যবহার রাখে। উৎসের দেওয়া স্পষ্ট খরচ থাকলে সেটি ব্যবহার করে; না থাকলে ব্যবহারযোগ্য টোকেন ও মডেলের দর থেকে খরচ হিসাব করে। JSON-এ উৎসের পরিচয় হিসেবে এগুলোকে বলা হয় reported, computed অথবা mixed।

ওই একটি সেশনের মেশিন-পাঠযোগ্য রেকর্ড সংরক্ষণ করতে চাইলে প্রকল্পের CLI উদাহরণ অনুযায়ী চালান agentsview session usage SESSION_ID --format json। এখানে SESSION_ID-এর জায়গায় ট্রান্সক্রিপ্টে যাচাই করা ID বসিয়ে কাজের নোটের সঙ্গে JSON রাখুন। কোনো মোট অঙ্ক উদ্ধৃত করার আগে ওই আউটপুটে জানানো মডেল, টোকেনের বিভাগ ও খরচের উৎস দেখুন।

ফাঁকা ক্ষেত্র বা অনুপস্থিত মডেলকে অজানা ধরুন। এজেন্ট যা লেখেনি AgentsView সেই ব্যবহার পুনর্গঠন করতে পারে না। প্রকাশনার নোটে বলা হয়েছে, Junie CLI আমদানিতে শুধু IDE-তে থাকা কথোপকথন ও টুল কল বাদ পড়ে, আর Antigravity-এর সাধারণ পাঠ্য বিকল্পে টোকেন-ব্যবহার বা খরচ ছাড়াই ট্রান্সক্রিপ্টের বিষয়বস্তু থাকে। এগুলো নির্দিষ্ট উদাহরণ—অনুসন্ধানযোগ্য সেশনে সম্পূর্ণ খরচের সংখ্যা নাও থাকতে পারে। উৎসের জানানো অঙ্ক পুরো সেশনের মোটও বোঝাতে পারে, অথচ মডেলভিত্তিক ভাগগুলো অনুমানই থাকে।

6. দিনভিত্তিক রিপোর্টের সীমা নির্ধারণ করুন

Usage পাতার তারিখ, প্রকল্প ও এজেন্ট ফিল্টার দিয়ে সেশন থাকা দিনটি দেখুন। পাতায় Top Sessions by Cost সারণিও আছে, যা পৃথক ট্রান্সক্রিপ্টে নিয়ে যায়। নিরীক্ষাযোগ্য টার্মিনাল রিপোর্টের জন্য নিচের কমান্ডে সেশনের স্থানীয় তারিখ ও এজেন্টের নাম বসান:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

দিনভিত্তিক সারণি ক্যাশবিহীন ইনপুট, আউটপুট, ক্যাশ তৈরি ও ক্যাশ পড়া আলাদা করে; মডেলভিত্তিক সারি পাওয়া যায় --breakdown নির্ধারণ করলে। তারিখ সিস্টেমের টাইমজোন অনুযায়ী ভাগ হয়, যদি না --timezone দেওয়া হয়। দিনের মোটে ওই এজেন্টের অন্য সেশনও থাকতে পারে; এটি সীমা ও মাত্রা যাচাই, এক কাজের খরচ নয়। দৈনিক রিপোর্টের সঙ্গে সেশন ID রাখুন এবং কোন সারি আসলে ওই সেশনের তা যাচাই করুন।

দরের ক্যাটালগ আনা ছাড়া রিপোর্টের জন্য যোগ করুন --offline। AgentsView বলছে, এতে উৎস সিঙ্ক বা ডেমন চালু না করেই বিদ্যমান আর্কাইভ পড়া হয় এবং অন্তর্ভুক্ত বিকল্প দর ব্যবহার করা হয়। সেশনের সাম্প্রতিক পরিবর্তন গুরুত্বপূর্ণ হলে আগে আর্কাইভ হালনাগাদ করুন; অফলাইন রিপোর্ট নতুন লগ খুঁজে পায় না। সাধারণ ব্যবহার-কমান্ড LiteLLM ও OpenRouter-এর দর আনতে পারে, আর অন্তর্ভুক্ত ক্যাটালগ ইনস্টল করা সংস্করণের সঙ্গে পুরোনো হয়।

7. অঙ্কের অর্থ বুঝুন ও সেবা বন্ধ করুন

প্রতিটি অঙ্কে তার উৎস অনুযায়ী লেবেল দিন। Computed মানে AgentsView নথিভুক্ত টোকেনকে নির্বাচিত দর দিয়ে গুণ করেছে। Reported মানে উৎস একটি স্পষ্ট খরচ দিয়েছে। Mixed মানে রিপোর্টে একাধিক ধরন মেশানো। এমনকি উৎসের জানানো অঙ্কও প্রমাণ নয় যে পুরো অ্যাকাউন্টের প্রদানকারীর চালান মিলিয়ে নেওয়া হয়েছে। সংশ্লিষ্ট প্রদানকারীর নিজস্ব বিলিং বা প্ল্যানের রেকর্ড স্বাধীনভাবে মেলান, বিশেষত সেবার স্তর, ছাড় বা সাবস্ক্রিপশনের বরাদ্দ গুরুত্বপূর্ণ হলে। AgentsView-এর নথি বলে, সংরক্ষিত ব্যবহারে স্তর না থাকলে Batch, Flex, Priority, অঞ্চলভিত্তিক বা এক ঘণ্টার ক্যাশের দর অনুমান করতে পারে না। টুলের দিকের কিছু টোকেন স্থানীয় ট্রান্সক্রিপ্টে অনুপস্থিত।

সফলতা যাচাই হলো এমন মিলে যাওয়া ট্রান্সক্রিপ্ট, যার এজেন্ট, ID ও তারিখ বেছে নেওয়া ব্যবহার-দৃশ্যের সঙ্গে মেলে; পাওয়া মডেল ও টোকেনের ক্ষেত্র লিখে রাখা হয়েছে, আর না-পাওয়া ক্ষেত্র অজানা চিহ্নিত। তৈরি ফলটি অনুসন্ধানযোগ্য স্থানীয় আর্কাইভ এবং সীমিত কাজ বা দিনের ব্যবহার-নোট, চালান নয়। সম্মুখভাগের agentsview serve বন্ধ করুন Ctrl+C দিয়ে, অথবা পেছনে চলা সার্ভার বন্ধ করুন agentsview daemon stop দিয়ে। Quick Start বলে, ডেমন বন্ধ করলে ওয়েব UI ও সেশন নজরদারি দুটোই বন্ধ হয়।

বড় পরিবর্তন

স্থানীয় ট্রান্সক্রিপ্ট খরচের আলোচনা অনুসরণ করার একটি নির্দিষ্ট সূচনা দেয়। প্রকৌশলপ্রধান কোনো অঙ্ককে নির্দিষ্ট নথিভুক্ত কাজ পর্যন্ত অনুসরণ করে দেখতে পারেন, তা এজেন্ট থেকে এসেছে নাকি দরের ক্যাটালগ থেকে। লগ অসম্পূর্ণ হলে রিপোর্টে সেই ঘাটতি রাখতে হবে।

উৎস ও আরও পড়ুন

  • AgentsView v0.45.0 প্রকাশনার নোট: তারিখসহ এজেন্ট সমর্থন, Usage কার্ড, সিঙ্ক ও দরের আচরণের পরিবর্তন। প্রকাশনার নোট বিক্রেতার রেকর্ড, BIG CHANGE-এর পরীক্ষা নয়।
  • AgentsView Quick Start: সমর্থিত ইনস্টলেশনের পথ, সার্ভার ও ডেমন কমান্ড, উৎসের কনফিগারেশন ও স্থানীয় অনুসন্ধানের নিয়ন্ত্রণ।
  • AgentsView কনফিগারেশন: উৎস খোঁজা, প্রদানকারী বাদ দেওয়া, আর্কাইভের অবস্থান ও ওই নিয়ন্ত্রণগুলোর সীমা।
  • AgentsView টোকেন-ব্যবহার ও খরচ: উৎসের সমর্থন, ব্যবহার-রিপোর্ট, দরের উৎস, অফলাইন মোড ও রিপোর্টের জানা সীমাবদ্ধতা।
  • AgentsView রিপোজিটরি: সোর্স কোড ও MIT লাইসেন্স; রিপোজিটরিতে ডিফল্ট আর্কাইভকে স্থানীয় বলা হয়েছে।