MCP Tools Reference: chatmcp.googleapis.com

টুল: send_message

মার্কডাউন ফরম্যাটিং সহ একটি কথোপকথনে গুগল চ্যাট বার্তা পাঠায়।

এই টুলটি ইনপুট হিসেবে একটি কনভারসেশন আইডি, একটি ঐচ্ছিক থ্রেড আইডি এবং একটি মেসেজ টেক্সট ব্যবহার করে। `search_conversations` টুলটি ব্যবহার করে কনভারসেশন আইডি খুঁজে পাওয়া যায়। এটি তৈরি করা মেসেজটি ফেরত দেয়।

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

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

ইনপুট স্কিমা

গুগল চ্যাট কথোপকথনে বার্তা পাঠানোর অনুরোধ।

বার্তা অনুরোধ পাঠান

JSON উপস্থাপনা
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
ক্ষেত্র
conversationId

string

আবশ্যক। যে কথোপকথনে বার্তাটি পাঠাতে হবে তার আইডি (যেমন, 'spaces/AAAA...')।

threadId

string

ঐচ্ছিক। যে থ্রেডে বার্তাটি পাঠাতে হবে তার আইডি (যেমন, 'spaces/AAAA.../threads/BBBB...')। সেট না করা হলে, বার্তাটি একটি নতুন থ্রেডে পাঠানো হবে।

messageText

string

আবশ্যক। বার্তার মূল বিষয়বস্তু। স্ট্যান্ডার্ড মার্কডাউন ব্যবহার করে ফরম্যাটিং যোগ করা যেতে পারে (উল্লেখ্য যে, টেবিল সমর্থিত নয়)। নিম্নলিখিত ফরম্যাটিং সমর্থিত:

  • বোল্ড: **text**
  • ইটালিক: *text* বা _text_
  • কেটে দেওয়া: ~~text~~
  • মনোস্পেস: text
  • মনোস্পেস ব্লক:
```
line 1
line 2
```
  • বুলেট তালিকা:
* item 1
* item 2
  • ক্রমিক তালিকা:
1. item 1
2. item 2
  • উদ্ধৃতি চিহ্ন: > quoted text
  • হাইপারলিঙ্ক: [label](url)
  • ব্যবহারকারীকে মেনশন করতে, chat-user নামের একটি সেলফ-ক্লোজিং HTML ট্যাগ ব্যবহার করুন এবং এর সাথে data-email="user@example.com" অথবা data-name="USER_ID" অ্যাট্রিবিউট যুক্ত করুন। যদি USER_ID জানা থাকে, তবে `data-name` অ্যাট্রিবিউটের সাথে USER_ID ব্যবহার করা শ্রেয় এবং অন্যথায় ব্যবহারকারীর ইমেইলসহ `data-email` অ্যাট্রিবিউট ব্যবহার করুন। আপনি যদি `data-name` অ্যাট্রিবিউট ব্যবহার করেন, তবে নিশ্চিত করুন যে আপনি সরাসরি সংখ্যাসূচক USER_ID ব্যবহার করছেন এবং অন্যান্য টুলের রিটার্ন ভ্যালুতে দেখা `users/` প্রিফিক্সটি অন্তর্ভুক্ত করছেন না। দ্রষ্টব্য: প্রতি মেসেজে সর্বোচ্চ ১০টি মেনশন অনুমোদিত। সকল ব্যবহারকারীকে মেনশন করা (যেমন, @all অথবা users/all সহ একটি HTML ট্যাগ ব্যবহার করে) কঠোরভাবে নিষিদ্ধ।
  • নিজস্ব ইমোজি ব্যবহার করতে, chat-custom-emoji একটি সেলফ-ক্লোজিং HTML ট্যাগ ব্যবহার করুন এবং এর সাথে data-uid="abc"data-emoji-name=":xyz:" অ্যাট্রিবিউটগুলো যুক্ত করুন।

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

গুগল চ্যাট কথোপকথনে বার্তা পাঠানোর প্রতিক্রিয়া।

বার্তা প্রতিক্রিয়া পাঠান

JSON উপস্থাপনা
{
  "message": {
    object (ChatMessage)
  }
}
ক্ষেত্র
message

object ( ChatMessage )

যে বার্তাটি পাঠানো হয়েছিল।

চ্যাট বার্তা

JSON উপস্থাপনা
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
ক্ষেত্র
messageId

string

বার্তার রিসোর্স নাম। ফরম্যাট: স্পেস/{স্পেস}/বার্তা/{বার্তা}

threadId

string

এই বার্তাটি যে থ্রেডের অন্তর্গত। বার্তাটি আনথ্রেডেড হলে এটি খালি থাকবে। ফরম্যাট: স্পেস/{স্পেস}/থ্রেড/{থ্রেড}

plaintextBody

string

মার্কডাউন ফরম্যাটিং ব্যবহার করে বার্তার মূল অংশ।

sender

object ( User )

বার্তার প্রেরক।

createTime

string

শুধুমাত্র আউটপুট। বার্তাটি তৈরি হওয়ার সময়কার টাইমস্ট্যাম্প।

threadedReply

boolean

বার্তাটি একটি থ্রেড রিপ্লাই কিনা।

attachments[]

object ( ChatAttachmentMetadata )

বার্তার সাথে সংযুক্ত ফাইলগুলো রয়েছে।

reactionSummaries[]

object ( ReactionSummary )

বার্তাটিতে ইমোজি প্রতিক্রিয়াগুলোর সারাংশ অন্তর্ভুক্ত করা হয়েছে।

ব্যবহারকারী

JSON উপস্থাপনা
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
ক্ষেত্র
userId

string

চ্যাট ব্যবহারকারীর রিসোর্স নাম। ফরম্যাট: users/{user}।

displayName

string

একজন চ্যাট ব্যবহারকারীর প্রদর্শিত নাম।

email

string

ব্যবহারকারীর ইমেল ঠিকানা। এই ক্ষেত্রটি শুধুমাত্র তখনই পূরণ করা হয় যখন ব্যবহারকারীর ধরন মানুষ (HUMAN) হয়।

userType

enum ( UserType )

ব্যবহারকারীর ধরণ।

চ্যাট সংযুক্তি মেটাডেটা

JSON উপস্থাপনা
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
ক্ষেত্র
attachmentId

string

সংযুক্তিটির রিসোর্স নাম। ফরম্যাট: spaces/{space}/messages/{message}/attachments/{attachment}.

filename

string

সংযুক্তিটির নাম।

mimeType

string

বিষয়বস্তুর ধরণ (MIME টাইপ)।

source

enum ( Source )

সংযুক্তিটির উৎস।

প্রতিক্রিয়া সারাংশ

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

string

ইমোজি ইউনিকোড স্ট্রিং অথবা নিজস্ব ইমোজির নাম।

count

integer

সংশ্লিষ্ট ইমোজি ব্যবহার করে করা মোট প্রতিক্রিয়ার সংখ্যা।

ব্যবহারকারীর ধরণ

গুগল চ্যাট ব্যবহারকারীর প্রকারভেদ।

এনাম
USER_TYPE_UNSPECIFIED অনির্দিষ্ট।
HUMAN মানব ব্যবহারকারী।
APP অ্যাপ ব্যবহারকারী।

উৎস

সংযুক্তিটির উৎস।

এনাম
SOURCE_UNSPECIFIED সংরক্ষিত।
DRIVE_FILE ফাইলটি একটি গুগল ড্রাইভ ফাইল।
UPLOADED_CONTENT ফাইলটি চ্যাটে আপলোড করা হয়েছে।

টুল টীকা

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