> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração Microsoft Word

> Criação e gerenciamento de documentos com integração Microsoft Word para CrewAI.

## 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](https://app.crewai.com) 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](https://app.crewai.com/crewai_plus/connectors)

## Configurando a Integração Microsoft Word

### 1. Conecte sua Conta Microsoft

1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
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](https://app.crewai.com/crewai_plus/settings/integrations)

### 2. Instale o Pacote Necessário

```bash theme={null}
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.
</Note>

```bash theme={null}
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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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."
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="microsoft_word/delete_document">
    **Descrição:** Excluir um documento.

    **Parâmetros:**

    * `file_id` (string, obrigatório): O ID do documento a excluir.
  </Accordion>

  <Accordion title="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).
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Exemplos de Uso

### Configuração Básica do Agente Microsoft Word

```python theme={null}
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

<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
  Entre em contato com nossa equipe de suporte para assistência com configuração
  ou solução de problemas da integração Microsoft Word.
</Card>