mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-30 02:28:13 +00:00
feat: update docs with new approach to consume Platform Actions (#3675)
This commit is contained in:
Lucas Gomide
127
docs/pt-BR/enterprise/integrations/microsoft_word.mdx
Normal file
127
docs/pt-BR/enterprise/integrations/microsoft_word.mdx
Normal file
@@ -0,0 +1,127 @@
|
||||
---
|
||||
title: Integração Microsoft Word
|
||||
description: "Criação e gerenciamento de documentos com integração Microsoft Word para CrewAI."
|
||||
icon: "file-word"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## 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
|
||||
uv add crewai-tools
|
||||
```
|
||||
|
||||
## 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>
|
||||
</AccordionGroup>
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### Configuração Básica do Agente Microsoft Word
|
||||
|
||||
```python
|
||||
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>
|
||||
Reference in New Issue
Block a user