Escrita
Compor, traduzir e enviar.
Ferramentas de escrita
| Ferramenta | O que faz |
|---|---|
| composeEmail | Redige um email com ajuda de IA. Devolve o texto; não guarda nenhum rascunho. |
| sendEmail | Envia um email novo. O translateTo escreve-o na língua do destinatário; o includeOriginal (true por omissão) mantém o que escreveu por baixo da tradução. |
| previewTranslation | O que o translateTo produziria (o assunto traduzido e o corpo exato que o sendEmail colocaria na rede), sem nada enviado e nada guardado. |
| listTranslationLanguages | Todas as línguas que o translateTo aceita, opcionalmente filtradas por um fragmento de um código, de um nome em inglês ou do nome próprio da língua. |
O sendEmail recebe destinatários, assunto, corpo e, opcionalmente, um id de conversa ou de rascunho. De momento não aceita anexos, cabeçalhos personalizados nem um endereço From. Envia como a ligação ativa.
Não há gestão de rascunhos por MCP. Criar e editar rascunhos é hoje exclusivo do REST.
O sendEmail com translateTo envia de imediato e ninguém lê a tradução primeiro. Chame o previewTranslation, mostre à pessoa para quem trabalha o que diz, e depois passe o assunto e o corpo que ela aprovou de volta ao sendEmail com o translateTo DE FORA. Passá-lo outra vez traduz uma segunda vez e a redação muda.
O translateTo aceita um código (de), um nome em inglês (“German”) ou o nome próprio da língua (“Deutsch”). Um que não possa ser identificado recusa a chamada em vez de enviar a mensagem por traduzir. Uma mensagem que sai numa língua que o seu remetente não escolheu é a falha que esta recusa existe para evitar.
Traduzir custa três chamadas ao modelo (o corpo, o assunto, e uma para apurar em que língua escreveu), quer pré-visualize quer envie, por isso pré-visualize uma vez e não a cada revisão. O listTranslationLanguages não custa nada; é uma tabela, não uma chamada ao modelo.
Nenhuma das ferramentas revê o texto nem responde à mensagem. Traduzir é tudo o que fazem.