MCP Tools Reference: chatmcp.googleapis.com

টুল: search_conversations

Google Chat কথোপকথন সার্চ করে কথোপকথন আইডি খুঁজে বের করে। নাম দেওয়া স্পেস ডিসপ্লে নাম (space_name_query) দিয়ে খুঁজে পাওয়া যায়। সরাসরি মেসেজ (DM) এবং গ্রুপ চ্যাট শুধুমাত্র অংশগ্রহণকারীর ইমেল আইডি (participants) দিয়ে খুঁজে পাওয়া যায়।

এই টুল কথোপকথনের মেটাডেটা সার্চ করে, মেসেজের কন্টেন্ট নয়। মেসেজ ইতিহাসের মধ্যে সার্চ করতে অথবা কীওয়ার্ড/প্রেরক/টাইমস্ট্যাম্প অনুযায়ী মেসেজ খুঁজতে, search_messages ব্যবহার করুন।

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

শুধুমাত্র space_name_query প্রদান করা হলে, এই টুল শুধুমাত্র সেইসব নামযুক্ত স্পেস সার্চ করে যেখানে কোয়েরি হল স্পেসের ডিসপ্লে নামের কেস-ইনসেনসিটিভ সাবস্ট্রিং। ডিএম এবং গ্রুপ চ্যাট কখনও ফেরত দেওয়া হয় না, তাই কারও সাথে ডিএম খুঁজতে space_name_query হিসেবে তার নাম পাস করবেন না; তার পরিবর্তে তার ইমেল আইডি খুঁজে নিয়ে participants-এ পাস করুন।

participants এবং space_name_query দুটিই প্রদান করা হলে, এই টুল অংশগ্রহণকারীদের মাধ্যমে DM বা গ্রুপ চ্যাট খুঁজে বের করে এবং তারপর ডিসপ্লে নাম অনুযায়ী সেগুলি ফিল্টার করে।

participants বা space_name_query-এর কোনওটিই প্রদান করা না হলে, এই টুলটি কলিং ব্যবহারকারী যে নামযুক্ত স্পেসের সদস্য তার তালিকা তৈরি করে (DM এবং গ্রুপ চ্যাট অন্তর্ভুক্ত নয়)।

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

কথোপকথন আইডি (ফর্ম্যাট: spaces/{space}), ডিসপ্লে নাম ও কথোপকথনের ধরন সহ কথোপকথন অবজেক্টের তালিকা দেখায়।

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

search_conversations MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয় তা নিম্নলিখিত কোড স্যাম্পেল থেকে জানতে পারবেন।

Curl অনুরোধ
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

SearchConversationsRequest

JSON উপস্থাপনা
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
ফিল্ড
spaceNameQuery

string

ঐচ্ছিক। কথোপকথনের ডিসপ্লে নামের মধ্যে সার্চ করার জন্য টেক্সট (কেস-ইনসেনসিটিভ সাবস্ট্রিং ম্যাচ)।

participants খালি থাকলে, শুধু নামযুক্ত স্পেস সার্চ করা হয় এবং সরাসরি মেসেজ (DM) ও গ্রুপ চ্যাট কখনও দেখানো হয় না, তাই এখানে কোনও ব্যক্তির নাম সার্চ করলে তার সাথে করা DM খুঁজে পাওয়া যাবে না। DM বা গ্রুপ চ্যাট খুঁজতে, পরিবর্তে participants-এ মেম্বারদের ইমেল আইডি দিন। participants সেট করা থাকলে, এই কোয়েরি ম্যাচ করা DM বা গ্রুপ চ্যাটকে ডিসপ্লে নাম অনুযায়ী আরও ফিল্টার করে।

pageSize

integer

ঐচ্ছিক। ফেরত পাঠানোর জন্য স্পেসের সর্বাধিক সংখ্যা। পরিষেবাটি এই মানের চেয়ে কম রিটার্ন করতে পারে। অনির্দিষ্ট থাকলে, সর্বাধিক ২০টি স্পেস দেখানো হবে। সর্বাধিক ভ্যালু হল ১০০০; ১০০০-এর বেশি ভ্যালু থাকলে তা ১০০০ হিসেবেই গণ্য করা হবে।

pageToken

string

ঐচ্ছিক। আগের search_conversations কল থেকে পাওয়া একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি ফিরিয়ে আনতে এটি প্রদান করুন।

participants[]

string

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

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

ম্যাচ করা কথোপকথনের তালিকা সহ উত্তর।

SearchConversationsResponse

JSON উপস্থাপনা
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
conversations[]

object (Conversation)

সার্চের মাপকাঠির সাথে ম্যাচ করা কথোপকথন অবজেক্টের তালিকা। প্রতিটি কথোপকথনে conversation_id (ফর্ম্যাট: spaces/{space}), display_name, conversation_type এবং last_active_timestamp অন্তর্ভুক্ত থাকে।

nextPageToken

string

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

অনুরোধটি participants দ্বারা ফিল্টার করা হলে তবেই এটি পপুলেট করা হয়।

কথোপকথন

JSON উপস্থাপনা
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
ফিল্ড
conversationId

string

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

displayName

string

কথোপকথনের ডিসপ্লে নাম। নামযুক্ত স্পেসের ক্ষেত্রে, এটি হল স্পেসের নাম। ১:১ সরাসরি মেসেজের ক্ষেত্রে, এটি হল অন্য অংশগ্রহণকারীর নাম। নামহীন গ্রুপ চ্যাটের ক্ষেত্রে, এটি মেম্বারদের নামের উপর ভিত্তি করে তৈরি করা নাম।

conversationType

enum (ConversationType)

কথোপকথনের ধরন (DIRECT_MESSAGE, GROUP_CHAT, বা NAMED_SPACE)।

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)

Unix epoch 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড দেখায়। অবশ্যই -৬২১৩৫৫৯৬৮০০ এবং ২৫৩৪০২৩০০৭৯৯-এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z-এর সাথে সম্পর্কিত)।

nanos

integer

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

ConversationType

কথোপকথনের ধরন নির্ধারণ করে।

Enums
CONVERSATION_TYPE_UNSPECIFIED অনির্দিষ্ট।
NAMED_SPACE নাম দেওয়া স্পেস।
GROUP_CHAT ৩ বা তার বেশি সংখ্যক ব্যক্তির মধ্যে গ্রুপ চ্যাট।
DIRECT_MESSAGE দুজন মানুষের মধ্যে অথবা একজন মানুষ ও Chat অ্যাপের মধ্যে সরাসরি মেসেজ।

টুল অ্যানোটেশন

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

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান হিন্ট এইভাবে সংজ্ঞায়িত করা হয়:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার কাজ করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি এক্সটার্নাল এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly