MCP Tools Reference: chatmcp.googleapis.com

টুল: search_conversations

ডিসপ্লে নেম দিয়ে গুগল চ্যাট কথোপকথন অনুসন্ধান করে।

শুধুমাত্র অংশগ্রহণকারীদের তথ্য দেওয়া হলে, এই টুলটি সেইসব ১:১ সরাসরি বার্তা (যদি একজন অংশগ্রহণকারীর তথ্য দেওয়া হয়) অথবা গ্রুপ চ্যাট (যদি একাধিক অংশগ্রহণকারীর তথ্য দেওয়া হয়) খুঁজে বের করে, যেগুলিতে নির্দিষ্ট অংশগ্রহণকারী এবং কলকারী ব্যবহারকারী অন্তর্ভুক্ত থাকে।

শুধুমাত্র একটি কোয়েরি প্রদান করা হলে, এই টুলটি এমন কথোপকথনগুলি অনুসন্ধান করে যেখানে কোয়েরিটি হলো কথোপকথনটির প্রদর্শিত নামের একটি কেস-ইনসেনসিটিভ সাবস্ট্রিং।

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

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

এই টুলটি শুধুমাত্র সেইসব কথোপকথন তালিকাভুক্ত করে, যেগুলোর সদস্য হলেন কলকারী ব্যবহারকারী।

গুরুত্বপূর্ণ: 'conversations' তালিকাটি খালি থাকার অর্থ এই নয় যে সামগ্রিকভাবে আর কোনো ফলাফল নেই। যদি 'next_page_token' উপস্থিত থাকে, তাহলে আরও পৃষ্ঠা আনা যাবে। যদি আপনি একটি খালি তালিকা পান কিন্তু 'next_page_token' থাকে, তাহলে ব্যবহারকারীকে জিজ্ঞাসা করুন যে অনুসন্ধান চালিয়ে যাওয়া উচিত কিনা।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` search_conversations MCP টুলটি চালু করা যায়।

কার্ল অনুরোধ 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

FindConversations RPC-এর জন্য অনুরোধ বার্তা।

অনুসন্ধান কথোপকথন অনুরোধ

JSON উপস্থাপনা 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
ক্ষেত্র
spaceNameQuery

string

ঐচ্ছিক। প্রদর্শিত নামগুলোর মধ্যে অনুসন্ধানের জন্য টেক্সট।

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়ার জন্য স্পেসের সর্বোচ্চ সংখ্যা। পরিষেবাটি এই মানের চেয়ে কমও ফেরত দিতে পারে। যদি নির্দিষ্ট না করা হয়, তবে সর্বাধিক ১০০টি স্পেস ফেরত দেওয়া হবে। সর্বোচ্চ মান হলো ১০০০; ১০০০-এর উপরের মানগুলোকে ১০০০-এ রূপান্তরিত করা হবে।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী search_conversations কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পেজটি পুনরুদ্ধার করতে এটি প্রদান করুন।

participants[]

string

ঐচ্ছিক। কলারকে বাদ দিয়ে কথোপকথনগুলো ফিল্টার করার জন্য অংশগ্রহণকারীদের ইমেল ঠিকানার তালিকা।

আউটপুট স্কিমা

FindConversations RPC-এর প্রতিক্রিয়া বার্তা।

অনুসন্ধান কথোপকথন প্রতিক্রিয়া

JSON উপস্থাপনা 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
conversations[]

object ( Conversation )

অনুসন্ধানের শর্তের সাথে মেলে এমন কথোপকথনের বিষয়বস্তুর তালিকা।

nextPageToken

string

পরবর্তী পৃষ্ঠা আনার জন্য page_token হিসেবে পাঠানো যায় এমন একটি টোকেন। এই ক্ষেত্রটি বাদ দিলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

কথোপকথন

JSON উপস্থাপনা 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
ক্ষেত্র
conversationId

string

কথোপকথনের আইডি (যেমন, "spaces/AAAAAAAAA")।

displayName

string

কথোপকথনটির প্রদর্শিত নাম।

conversationType

enum ( ConversationType )

কথোপকথনের ধরণ (সরাসরি বার্তা, গ্রুপ চ্যাট, অথবা নামযুক্ত স্থান)।

lastActiveTimestamp

string ( Timestamp format)

ISO 8601 ফরম্যাটে কথোপকথনটির সর্বশেষ সক্রিয় সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

টাইমস্ট্যাম্প

JSON উপস্থাপনা 
{
  "seconds": string,
  "nanos": integer
}
ক্ষেত্র
seconds

string ( int64 format)

এটি ইউনিক্স ইপক 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড নির্দেশ করে। এর মান অবশ্যই -62135596800 থেকে 253402300799 (উভয় মানসহ) এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z পর্যন্ত সময়কালের সমতুল্য)।

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সেকেন্ডের অঋণাত্মক ভগ্নাংশ। এই ক্ষেত্রটি হলো সময়কালের ন্যানোসেকেন্ড অংশ, সেকেন্ডের বিকল্প নয়। ভগ্নাংশসহ ঋণাত্মক সেকেন্ডের মানগুলোর ক্ষেত্রেও ন্যানোর মান অবশ্যই অঋণাত্মক হতে হবে, যা সময়ের সাথে সাথে গণনা করে। এর মান অবশ্যই ০ থেকে ৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে (উভয় সংখ্যাসহ)।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌