تخطَّ إلى المستندات
خادم MCP

دردشات المساعد

المحادثات مع المساعد في التطبيق.

أدوات دردشات المساعد

الأداةما تفعله
listChatsالدردشات مع المساعد في التطبيق، الأحدث أولًا، مع عناوينها وعدد رسائل كل منها. يبحث query في العناوين. تُعاد صفحة في كل مرة.
getChatدردشة واحدة بمعرّفها.
renameChatأعطِ دردشة عنوانًا جديدًا.
deleteChatاحذف دردشة وكل رسالة فيها نهائيًا. لا يُتراجع عن أي شيء فعله المساعد في صندوق البريد.

لا يصل إلى الدردشات إلا مالك مساحة العمل، عبر عميل مرتبط بكل العناوين. القراءة تحتاج إلى threads:read والتغيير إلى threads:write.

ليس لدى المساعد في التطبيق هذه الأدوات، لذا لا تعيد الدردشة تسمية نفسها ولا تحذف نفسها أبدًا.

المرجع

listChats

الصلاحياتthreads:readعبر MCP فقط، وليس في مساعد التطبيقمجموعة الأدواتcore

The conversations held with the assistant in the OpenEmail app, as its Chats page lists them, newest first, each with its title, id and how many messages it holds. query searches the titles. Only the workspace owner reaches them. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.

المدخلات

querystring
حتى 200 من الأحرف
sortstring
أحد"newest""oldest""title"
limitinteger
على الأقل 1على الأكثر 100
cursorstring
من 1 إلى 2048 من الأحرف

متاح أيضًا في

API
GET /chats
SDK
chats.list()chats.listAll()chats.iterate()

getChat

الصلاحياتthreads:readعبر MCP فقط، وليس في مساعد التطبيقمجموعة الأدواتcore

One chat with the assistant by its id: its title, how many messages it holds and when it last changed.

المدخلات

idstringمطلوب
غير فارغ

متاح أيضًا في

API
GET /chats/{id}
SDK
chats.get()

renameChat

الصلاحياتthreads:writeعبر MCP فقط، وليس في مساعد التطبيقمجموعة الأدواتcore

Give a chat with the assistant a new title.

المدخلات

idstringمطلوب
غير فارغ
titlestringمطلوب
من 1 إلى 120 من الأحرف

متاح أيضًا في

API
PATCH /chats/{id}
SDK
chats.rename()

deleteChat

الصلاحياتthreads:writeعبر MCP فقط، وليس في مساعد التطبيقمجموعة الأدواتcore

Delete a chat with the assistant and every message in it, for good. Nothing it did in the mailbox is undone. Ask the person first.

المدخلات

idstringمطلوب
غير فارغ

متاح أيضًا في

API
DELETE /chats/{id}
SDK
chats.delete()