Referência do Work IQ Word (versão preliminar)

Importante

Esta é uma versão preliminar do recurso.

  • Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
  • Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
  • A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
  • Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Overview

ID de servidor URL no nível do locatário Nome de exibição Description
mcp_WordServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/
servers/mcp_WordServer
Work IQ Word Servidor MCP que contém ferramentas para trabalhar com documentos Microsoft Word

Ferramentas disponíveis

WordCreateNewDocument

Cria um novo documento Word na raiz do OneDrive do usuário. Forneça o nome desejado do arquivo (pode estar vazio) e conteúdo HTML ou texto simples para preencher o corpo do documento. Se fileName for vazio, gera-se um nome como Document_yyyyMMdd_HHmms.docx . Retorna o JSON DriveItem criado de Microsoft Graph.

Parâmetros requeridos:

  • Nome do arquivo: Nome de arquivo desejado (pode estar vazio para nome gerado automaticamente)
  • contentInHtml: Conteúdo HTML ou texto simples para corpo de documento

WordGetDocumentContent

Obtém o conteúdo bruto do documento do Word (DOCX) do OneDrive ou do SharePoint com base na URL de compartilhamento do SharePoint. Retorna um payload JSON com nome do arquivo, tamanho, driveId, documentIdconteúdo de texto simples e todos os comentários naquele documento. A entrada deve ser o link de compartilhamento (URL SharePoint ou OneDrive).

Parâmetros requeridos:

  • url: SharePoint ou OneDrive URL de compartilhamento do documento

WordCriarNovo Comentário

Adiciona um novo comentário no documento Word. Inclua driveId, documentId, e o texto do comentário.

Parâmetros requeridos:

  • driveId: ID do disco do documento
  • documentId: ID do documento
  • newComment: Texto do comentário para adicionar

WordReplyToComment

Responde a um comentário no documento Word. Forneça commentId, driveId, documentId, e o texto de resposta.

Parâmetros requeridos:

  • commentId: ID do comentário a responder
  • driveId: ID do disco do documento
  • documentId: ID do documento
  • novoComentário: Texto de resposta

Principais características

Criação de documento

  • Crie documentos do Word diretamente no OneDrive.
  • Suporte para conteúdo html e texto sem formatação.
  • Nomes de arquivo gerados automaticamente com timestamp.
  • Retorna metadados Microsoft Graph DriveItem.

Recuperação de documentos

  • Busque o conteúdo do documento usando urls de SharePoint ou OneDrive.
  • Extraia conteúdo de texto sem formatação de arquivos DOCX.
  • Recupere todos os comentários do documento.
  • Obtenha metadados de documento, como nome do arquivo, tamanho e IDs.

Gerenciamento de comentários

  • Adicione novos comentários a documentos.
  • Responda aos comentários existentes.
  • Suporte completo ao thread de comentário.

Notes

  • Crie documentos na raiz do OneDrive do usuário.
  • Recupere documentos usando urls de compartilhamento de SharePoint ou OneDrive.
  • Execute operações de comentário usando o driveId e a id do documento a documentId partir da recuperação de documentos.
  • Suporte para conteúdo HTML para formatação rica de documentos.
  • Use nomes de arquivos gerados automaticamente que sigam este formato: Document_yyyyMMdd_HHmms.docx.