Написание
Составление, перевод и отправка.
Инструменты написания
| Инструмент | Что делает |
|---|---|
| composeEmail | Составить письмо с помощью ИИ. Возвращает текст; черновик не сохраняет. |
| sendEmail | Отправить новое письмо. translateTo пишет его на языке получателя; includeOriginal (по умолчанию true) сохраняет написанное вами под переводом. |
| previewTranslation | Что дал бы translateTo (переведённая тема и ровно то тело, которое sendEmail отправил бы в сеть), при этом ничего не отправляется и ничего не сохраняется. |
| listTranslationLanguages | Все языки, которые принимает translateTo, при желании отфильтрованные по фрагменту кода, английского названия или собственного названия языка. |
sendEmail принимает получателей, тему, тело и, при желании, id переписки или черновика. Сейчас он не принимает вложения, произвольные заголовки и адрес From. Он отправляет от имени активного подключения.
Работы с черновиками через MCP нет. Создание и правка черновиков сегодня доступны только через REST.
sendEmail с translateTo отправляет немедленно, и перевод никто предварительно не читает. Вызовите previewTranslation, покажите человеку, на которого вы работаете, что там написано, а затем передайте одобренные им тему и тело обратно в sendEmail, ОПУСТИВ translateTo. Если передать его снова, текст переведётся второй раз и формулировки сдвинутся.
translateTo принимает код (de), английское название ("German") или собственное название языка ("Deutsch"). То, что не удаётся сопоставить, отклоняет вызов, а не отправляет письмо без перевода. Письмо, уходящее на языке, который его отправитель не выбирал, — та поломка, ради предотвращения которой этот отказ и существует.
Перевод стоит трёх вызовов модели (тело, тема и один, чтобы определить, на каком языке вы написали) и при предпросмотре, и при отправке, поэтому просматривайте один раз, а не на каждую правку. listTranslationLanguages не стоит ничего: это таблица, а не вызов модели.
Ни один из этих инструментов не вычитывает текст и не отвечает на письмо. Перевод — всё, что они делают.