Integração Microsoft Word

Visão Geral

Permita que seus agentes criem, leiam e gerenciem documentos do Word e arquivos de texto no OneDrive ou SharePoint. Automatize a criação de documentos, recupere conteúdo, gerencie propriedades de documentos e simplifique seus fluxos de trabalho de documentos com automação alimentada por IA.

Pré-requisitos

Antes de usar a integração Microsoft Word, certifique-se de ter:

• Uma conta CrewAI AMP com assinatura ativa
• Uma conta Microsoft com acesso ao Word e OneDrive/SharePoint
• Conectado sua conta Microsoft através da página de Integrações

Configurando a Integração Microsoft Word

1. Conecte sua Conta Microsoft

1. Navegue para Integrações CrewAI AMP
2. Encontre Microsoft Word na seção de Integrações de Autenticação
3. Clique em Conectar e complete o fluxo OAuth
4. Conceda as permissões necessárias para acesso a arquivos
5. Copie seu Token Enterprise das Configurações de Integração

2. Instale o Pacote Necessário

uv add crewai-tools

3. Configuração de variável de ambiente

Note

Para usar integrações com Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"

Ou adicione ao seu arquivo .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token

Ações Disponíveis

microsoft_word/get_documents

Descrição: Obter todos os documentos do Word do OneDrive ou SharePoint.

Parâmetros:

• select (string, opcional): Selecionar propriedades específicas para retornar.
• filter (string, opcional): Filtrar resultados usando sintaxe OData.
• expand (string, opcional): Expandir recursos relacionados inline.
• top (integer, opcional): Número de itens a retornar (mín 1, máx 999).
• orderby (string, opcional): Ordenar resultados por propriedades especificadas.

microsoft_word/create_text_document

Descrição: Criar um documento de texto (.txt) com conteúdo. RECOMENDADO para criação de conteúdo programático que precisa ser legível e editável.

Parâmetros:

• file_name (string, obrigatório): Nome do documento de texto (deve terminar com .txt).
• content (string, opcional): Conteúdo de texto para o documento. Padrão: “Este é um novo documento de texto criado via API.”

microsoft_word/get_document_content

Descrição: Obter o conteúdo de um documento (funciona melhor com arquivos de texto).

Parâmetros:

• file_id (string, obrigatório): O ID do documento.

microsoft_word/get_document_properties

Descrição: Obter propriedades e metadados de um documento.

Parâmetros:

• file_id (string, obrigatório): O ID do documento.

microsoft_word/delete_document

Descrição: Excluir um documento.

Parâmetros:

• file_id (string, obrigatório): O ID do documento a excluir.

microsoft_word/copy_document

Descrição: Copiar um documento para um novo local no OneDrive.

Parâmetros:

• file_id (string, obrigatório): O ID do documento a copiar.
• name (string, opcional): Novo nome para o documento copiado.
• parent_id (string, opcional): O ID da pasta de destino (padrão: raiz).

microsoft_word/move_document

Descrição: Mover um documento para um novo local no OneDrive.

Parâmetros:

• file_id (string, obrigatório): O ID do documento a mover.
• parent_id (string, obrigatório): O ID da pasta de destino.
• name (string, opcional): Novo nome para o documento movido.

Exemplos de Uso

Configuração Básica do Agente Microsoft Word

from crewai import Agent, Task, Crew

# Crie um agente com capacidades do Microsoft Word
word_agent = Agent(
    role="Gerenciador de Documentos",
    goal="Gerenciar documentos do Word e arquivos de texto de forma eficiente",
    backstory="Um assistente IA especializado em operações de documentos do Microsoft Word e gerenciamento de conteúdo.",
    apps=['microsoft_word']  # Todas as ações do Word estarão disponíveis
)

# Tarefa para criar um novo documento de texto
create_doc_task = Task(
    description="Criar um novo documento de texto chamado 'notas_reuniao.txt' com conteúdo 'Notas da Reunião de Janeiro de 2024: Pontos-chave de discussão e itens de ação.'",
    agent=word_agent,
    expected_output="Novo documento de texto 'notas_reuniao.txt' criado com sucesso."
)

# Execute a tarefa
crew = Crew(
    agents=[word_agent],
    tasks=[create_doc_task]
)

crew.kickoff()

Solução de Problemas

Problemas Comuns

Erros de Autenticação

• Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a arquivos (ex: Files.Read.All, Files.ReadWrite.All).
• Verifique se a conexão OAuth inclui todos os escopos necessários.

Problemas de Criação de Arquivos

• Ao criar documentos de texto, certifique-se de que o file_name termine com extensão .txt.
• Verifique se você tem permissões de escrita no local de destino (OneDrive/SharePoint).

Obtendo Ajuda

Precisa de Ajuda?

Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft Word.