andre/crewAI
1
0
Fork 0
mirror of https://github.com/crewAIInc/crewAI.git synced 2026-05-01 07:13:00 +00:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity

adjust aop to amp docs lang (#4179)
Some checks failed
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
Details
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Details
Check Documentation Broken Links / Check broken links (push) Has been cancelled
Details
Notify Downstream / notify-downstream (push) Has been cancelled
Details
Mark stale issues and pull requests / stale (push) Has been cancelled
Details

Browse Source 
* adjust aop to amp docs lang

* whoop no print
This commit is contained in:
Lorenze Jay
2026-01-05 15:30:21 -08:00
committed by GitHub
parent f8deb0fd18
commit 25c0c030ce
203 changed files with 5176 additions and 2715 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/pt-BR/api-reference/introduction.mdx
View File

@@ -1,19 +1,19 @@
---
title: "Introdução"
description: "Referência completa para a API REST do CrewAI AOP"
description: "Referência completa para a API REST do CrewAI AMP"
icon: "code"
mode: "wide"
---
# CrewAI AOP API
# CrewAI AMP API
Bem-vindo à referência da API do CrewAI AOP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.
Bem-vindo à referência da API do CrewAI AMP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.
## Início Rápido
<Steps>
<Step title="Obtenha suas credenciais de API">
Navegue até a página de detalhes do seu crew no painel do CrewAI AOP e copie seu Bearer Token na aba Status.
Navegue até a página de detalhes do seu crew no painel do CrewAI AMP e copie seu Bearer Token na aba Status.
</Step>
<Step title="Descubra os Inputs Necessários">
@@ -48,7 +48,7 @@ curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \
<Tip>
Você pode encontrar ambos os tipos de token na aba Status da página de
detalhes do seu crew no painel do CrewAI AOP.
detalhes do seu crew no painel do CrewAI AMP.
</Tip>
## URL Base
@@ -84,7 +84,7 @@ A API utiliza códigos de status HTTP padrão:
## Testes Interativos
<Info>
**Por que não há botão "Enviar"?** Como cada usuário do CrewAI AOP possui sua
**Por que não há botão "Enviar"?** Como cada usuário do CrewAI AMP possui sua
própria URL de crew, utilizamos o **modo referência** em vez de um playground
interativo para evitar confusão. Isso mostra exatamente como as requisições
devem ser feitas, sem botões de envio não funcionais.

126
docs/pt-BR/concepts/agents.mdx
View File

@@ -8,6 +8,7 @@ mode: "wide"
## Visão Geral de um Agente
No framework CrewAI, um `Agent` é uma unidade autônoma que pode:
- Executar tarefas específicas
- Tomar decisões com base em seu papel e objetivo
- Utilizar ferramentas para alcançar objetivos
@@ -16,15 +17,19 @@ No framework CrewAI, um `Agent` é uma unidade autônoma que pode:
- Delegar tarefas, quando permitido
<Tip>
Pense em um agente como um membro especializado da equipe com habilidades, competências e responsabilidades específicas. Por exemplo, um agente `Researcher` pode ser excelente em coletar e analisar informações, enquanto um agente `Writer` pode ser melhor na criação de conteúdo.
Pense em um agente como um membro especializado da equipe com habilidades,
competências e responsabilidades específicas. Por exemplo, um agente
`Researcher` pode ser excelente em coletar e analisar informações, enquanto um
agente `Writer` pode ser melhor na criação de conteúdo.
</Tip>
<Note type="info" title="Aprimoramento Empresarial: Construtor Visual de Agentes">
O CrewAI AOP inclui um Construtor Visual de Agentes, que simplifica a criação e configuração de agentes sem escrever código. Projete seus agentes visualmente e teste-os em tempo real.
O CrewAI AMP inclui um Construtor Visual de Agentes, que simplifica a criação e configuração de agentes sem escrever código. Projete seus agentes visualmente e teste-os em tempo real.
![Visual Agent Builder Screenshot](/images/enterprise/crew-studio-interface.png)
O Construtor Visual de Agentes permite:
- Configuração intuitiva de agentes com interfaces baseadas em formulários
- Testes e validação em tempo real
- Biblioteca de modelos com tipos de agentes pré-configurados
@@ -33,36 +38,36 @@ O Construtor Visual de Agentes permite:
## Atributos do Agente
| Atributo | Parâmetro | Tipo | Descrição |
| :-------------------------------------- | :----------------------- | :---------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| **Role (Função)** | `role` | `str` | Define a função e a área de especialização do agente dentro da equipe. |
| **Goal (Objetivo)** | `goal` | `str` | O objetivo individual que guia a tomada de decisão do agente. |
| **Backstory (História de fundo)** | `backstory` | `str` | Fornece contexto e personalidade ao agente, enriquecendo as interações. |
| **LLM** _(opcional)_ | `llm` | `Union[str, LLM, Any]` | Modelo de linguagem que alimenta o agente. Padrão: modelo especificado em `OPENAI_MODEL_NAME` ou "gpt-4". |
| **Tools (Ferramentas)** _(opcional)_ | `tools` | `List[BaseTool]` | Capacidades ou funções disponíveis para o agente. Padrão: lista vazia. |
| **Function Calling LLM** _(opcional)_ | `function_calling_llm` | `Optional[Any]` | Modelo de linguagem usado para chamada de ferramentas, sobrescreve LLM principal se especificado. |
| **Max Iterations** _(opcional)_ | `max_iter` | `int` | Número máximo de iterações antes do agente fornecer sua melhor resposta. Padrão: 20. |
| **Max RPM** _(opcional)_ | `max_rpm` | `Optional[int]` | Quantidade máxima de requisições por minuto para evitar limites de taxa. |
| **Max Execution Time** _(opcional)_ | `max_execution_time` | `Optional[int]` | Tempo máximo (em segundos) de execução da tarefa. |
| **Verbose** _(opcional)_ | `verbose` | `bool` | Habilita logs detalhados de execução para depuração. Padrão: False. |
| **Allow Delegation** _(opcional)_ | `allow_delegation` | `bool` | Permite que o agente delegue tarefas para outros agentes. Padrão: False. |
| **Step Callback** _(opcional)_ | `step_callback` | `Optional[Any]` | Função chamada após cada passo do agente, sobrescreve callback da equipe. |
| **Cache** _(opcional)_ | `cache` | `bool` | Ativa cache para o uso de ferramentas. Padrão: True. |
| **System Template** _(opcional)_ | `system_template` | `Optional[str]` | Template personalizado de prompt de sistema para o agente. |
| **Prompt Template** _(opcional)_ | `prompt_template` | `Optional[str]` | Template de prompt personalizado para o agente. |
| **Response Template** _(opcional)_ | `response_template` | `Optional[str]` | Template de resposta personalizado para o agente. |
| **Allow Code Execution** _(opcional)_ | `allow_code_execution` | `Optional[bool]` | Ativa execução de código pelo agente. Padrão: False. |
| **Max Retry Limit** _(opcional)_ | `max_retry_limit` | `int` | Número máximo de tentativas (retries) em caso de erro. Padrão: 2. |
| **Respect Context Window** _(opcional)_ | `respect_context_window` | `bool` | Mantém as mensagens dentro do tamanho da janela de contexto, resumindo quando necessário. Padrão: True. |
| **Code Execution Mode** _(opcional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Modo de execução de código: 'safe' (usando Docker) ou 'unsafe' (direto). Padrão: 'safe'. |
| **Multimodal** _(opcional)_ | `multimodal` | `bool` | Se o agente suporta capacidades multimodais. Padrão: False. |
| **Inject Date** _(opcional)_ | `inject_date` | `bool` | Se deve injetar automaticamente a data atual nas tarefas. Padrão: False. |
| **Date Format** _(opcional)_ | `date_format` | `str` | Formato de data utilizado quando `inject_date` está ativo. Padrão: "%Y-%m-%d" (formato ISO). |
| **Reasoning** _(opcional)_ | `reasoning` | `bool` | Se o agente deve refletir e criar um plano antes de executar uma tarefa. Padrão: False. |
| **Max Reasoning Attempts** _(opcional)_ | `max_reasoning_attempts` | `Optional[int]` | Número máximo de tentativas de raciocínio antes de executar a tarefa. Se None, tentará até estar pronto. |
| **Embedder** _(opcional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuração do embedder utilizado pelo agente. |
| **Knowledge Sources** _(opcional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Fontes de conhecimento disponíveis para o agente. |
| **Use System Prompt** _(opcional)_ | `use_system_prompt` | `Optional[bool]` | Se deve usar o system prompt (suporte para modelo o1). Padrão: True. |
| Atributo | Parâmetro | Tipo | Descrição |
| :-------------------------------------- | :----------------------- | :------------------------------------ | :-------------------------------------------------------------------------------------------------------- |
| **Role (Função)** | `role` | `str` | Define a função e a área de especialização do agente dentro da equipe. |
| **Goal (Objetivo)** | `goal` | `str` | O objetivo individual que guia a tomada de decisão do agente. |
| **Backstory (História de fundo)** | `backstory` | `str` | Fornece contexto e personalidade ao agente, enriquecendo as interações. |
| **LLM** _(opcional)_ | `llm` | `Union[str, LLM, Any]` | Modelo de linguagem que alimenta o agente. Padrão: modelo especificado em `OPENAI_MODEL_NAME` ou "gpt-4". |
| **Tools (Ferramentas)** _(opcional)_ | `tools` | `List[BaseTool]` | Capacidades ou funções disponíveis para o agente. Padrão: lista vazia. |
| **Function Calling LLM** _(opcional)_ | `function_calling_llm` | `Optional[Any]` | Modelo de linguagem usado para chamada de ferramentas, sobrescreve LLM principal se especificado. |
| **Max Iterations** _(opcional)_ | `max_iter` | `int` | Número máximo de iterações antes do agente fornecer sua melhor resposta. Padrão: 20. |
| **Max RPM** _(opcional)_ | `max_rpm` | `Optional[int]` | Quantidade máxima de requisições por minuto para evitar limites de taxa. |
| **Max Execution Time** _(opcional)_ | `max_execution_time` | `Optional[int]` | Tempo máximo (em segundos) de execução da tarefa. |
| **Verbose** _(opcional)_ | `verbose` | `bool` | Habilita logs detalhados de execução para depuração. Padrão: False. |
| **Allow Delegation** _(opcional)_ | `allow_delegation` | `bool` | Permite que o agente delegue tarefas para outros agentes. Padrão: False. |
| **Step Callback** _(opcional)_ | `step_callback` | `Optional[Any]` | Função chamada após cada passo do agente, sobrescreve callback da equipe. |
| **Cache** _(opcional)_ | `cache` | `bool` | Ativa cache para o uso de ferramentas. Padrão: True. |
| **System Template** _(opcional)_ | `system_template` | `Optional[str]` | Template personalizado de prompt de sistema para o agente. |
| **Prompt Template** _(opcional)_ | `prompt_template` | `Optional[str]` | Template de prompt personalizado para o agente. |
| **Response Template** _(opcional)_ | `response_template` | `Optional[str]` | Template de resposta personalizado para o agente. |
| **Allow Code Execution** _(opcional)_ | `allow_code_execution` | `Optional[bool]` | Ativa execução de código pelo agente. Padrão: False. |
| **Max Retry Limit** _(opcional)_ | `max_retry_limit` | `int` | Número máximo de tentativas (retries) em caso de erro. Padrão: 2. |
| **Respect Context Window** _(opcional)_ | `respect_context_window` | `bool` | Mantém as mensagens dentro do tamanho da janela de contexto, resumindo quando necessário. Padrão: True. |
| **Code Execution Mode** _(opcional)_ | `code_execution_mode` | `Literal["safe", "unsafe"]` | Modo de execução de código: 'safe' (usando Docker) ou 'unsafe' (direto). Padrão: 'safe'. |
| **Multimodal** _(opcional)_ | `multimodal` | `bool` | Se o agente suporta capacidades multimodais. Padrão: False. |
| **Inject Date** _(opcional)_ | `inject_date` | `bool` | Se deve injetar automaticamente a data atual nas tarefas. Padrão: False. |
| **Date Format** _(opcional)_ | `date_format` | `str` | Formato de data utilizado quando `inject_date` está ativo. Padrão: "%Y-%m-%d" (formato ISO). |
| **Reasoning** _(opcional)_ | `reasoning` | `bool` | Se o agente deve refletir e criar um plano antes de executar uma tarefa. Padrão: False. |
| **Max Reasoning Attempts** _(opcional)_ | `max_reasoning_attempts` | `Optional[int]` | Número máximo de tentativas de raciocínio antes de executar a tarefa. Se None, tentará até estar pronto. |
| **Embedder** _(opcional)_ | `embedder` | `Optional[Dict[str, Any]]` | Configuração do embedder utilizado pelo agente. |
| **Knowledge Sources** _(opcional)_ | `knowledge_sources` | `Optional[List[BaseKnowledgeSource]]` | Fontes de conhecimento disponíveis para o agente. |
| **Use System Prompt** _(opcional)_ | `use_system_prompt` | `Optional[bool]` | Se deve usar o system prompt (suporte para modelo o1). Padrão: True. |
## Criando Agentes
@@ -137,7 +142,8 @@ class LatestAiDevelopmentCrew():
```
<Note>
Os nomes utilizados em seus arquivos YAML (`agents.yaml`) devem ser iguais aos nomes dos métodos no seu código Python.
Os nomes utilizados em seus arquivos YAML (`agents.yaml`) devem ser iguais aos
nomes dos métodos no seu código Python.
</Note>
### Definição Direta em Código
@@ -183,6 +189,7 @@ agent = Agent(
Vamos detalhar algumas combinações de parâmetros-chave para casos de uso comuns:
#### Agente de Pesquisa Básico
```python Code
research_agent = Agent(
role="Analista de Pesquisa",
@@ -194,6 +201,7 @@ research_agent = Agent(
```
#### Agente de Desenvolvimento de Código
```python Code
dev_agent = Agent(
role="Desenvolvedor Python Sênior",
@@ -207,6 +215,7 @@ dev_agent = Agent(
```
#### Agente de Análise de Longa Duração
```python Code
analysis_agent = Agent(
role="Analista de Dados",
@@ -220,6 +229,7 @@ analysis_agent = Agent(
```
#### Agente com Template Personalizado
```python Code
custom_agent = Agent(
role="Atendente de Suporte ao Cliente",
@@ -232,6 +242,7 @@ custom_agent = Agent(
```
#### Agente Ciente de Data, com Raciocínio
```python Code
strategic_agent = Agent(
role="Analista de Mercado",
@@ -246,6 +257,7 @@ strategic_agent = Agent(
```
#### Agente de Raciocínio
```python Code
reasoning_agent = Agent(
role="Planejador Estratégico",
@@ -259,6 +271,7 @@ reasoning_agent = Agent(
```
#### Agente Multimodal
```python Code
multimodal_agent = Agent(
role="Analista de Conteúdo Visual",
@@ -272,52 +285,65 @@ multimodal_agent = Agent(
### Detalhes dos Parâmetros
#### Parâmetros Críticos
- `role`, `goal` e `backstory` são obrigatórios e definem o comportamento do agente
- `llm` determina o modelo de linguagem utilizado (padrão: GPT-4 da OpenAI)
#### Memória e Contexto
- `memory`: Ative para manter o histórico de conversas
- `respect_context_window`: Evita problemas com limites de tokens
- `knowledge_sources`: Adicione bases de conhecimento específicas do domínio
#### Controle de Execução
- `max_iter`: Número máximo de tentativas antes da melhor resposta
- `max_execution_time`: Tempo limite em segundos
- `max_rpm`: Limite de requisições por minuto
- `max_retry_limit`: Tentativas de correção em erros
#### Execução de Código
- `allow_code_execution`: Deve ser True para permitir execução de código
- `code_execution_mode`:
- `"safe"`: Usa Docker (recomendado para produção)
- `"unsafe"`: Execução direta (apenas em ambientes confiáveis)
<Note>
Isso executa uma imagem Docker padrão. Se você deseja configurar a imagem Docker, veja a ferramenta Code Interpreter na seção de ferramentas.
Adicione a ferramenta de interpretação de código como um parâmetro em ferramentas no agente.
Isso executa uma imagem Docker padrão. Se você deseja configurar a imagem
Docker, veja a ferramenta Code Interpreter na seção de ferramentas. Adicione a
ferramenta de interpretação de código como um parâmetro em ferramentas no
agente.
</Note>
#### Funcionalidades Avançadas
- `multimodal`: Habilita capacidades multimodais para processar texto e conteúdo visual
- `reasoning`: Permite que o agente reflita e crie planos antes de executar tarefas
- `inject_date`: Injeta a data atual automaticamente nas descrições das tarefas
#### Templates
- `system_template`: Define o comportamento central do agente
- `prompt_template`: Estrutura o formato da entrada
- `response_template`: Formata as respostas do agente
<Note>
Ao usar templates personalizados, assegure-se de definir tanto `system_template` quanto `prompt_template`. O `response_template` é opcional, mas recomendado para formatação consistente de saída.
Ao usar templates personalizados, assegure-se de definir tanto
`system_template` quanto `prompt_template`. O `response_template` é opcional,
mas recomendado para formatação consistente de saída.
</Note>
<Note>
Ao usar templates personalizados, você pode usar variáveis como `{role}`, `{goal}` e `{backstory}` em seus templates. Elas serão automaticamente preenchidas durante a execução.
Ao usar templates personalizados, você pode usar variáveis como `{role}`, `
{goal}` e `{backstory}` em seus templates. Elas serão automaticamente
preenchidas durante a execução.
</Note>
## Ferramentas do Agente
Agentes podem ser equipados com diversas ferramentas para ampliar suas capacidades. O CrewAI suporta ferramentas do:
- [CrewAI Toolkit](https://github.com/joaomdmoura/crewai-tools)
- [LangChain Tools](https://python.langchain.com/docs/integrations/tools)
@@ -356,7 +382,9 @@ analyst = Agent(
```
<Note>
Quando `memory` está ativo, o agente manterá o contexto ao longo de múltiplas interações, melhorando a capacidade de lidar com tarefas complexas, em múltiplos passos.
Quando `memory` está ativo, o agente manterá o contexto ao longo de múltiplas
interações, melhorando a capacidade de lidar com tarefas complexas, em
múltiplos passos.
</Note>
## Gerenciamento da Janela de Contexto
@@ -386,6 +414,7 @@ smart_agent = Agent(
```
**O que acontece quando os limites de contexto são excedidos:**
- ⚠️ **Mensagem de aviso**: `"Context length exceeded. Summarizing content to fit the model context window."`
- 🔄 **Resumir automaticamente**: O CrewAI resume o histórico da conversa de forma inteligente
- ✅ **Execução contínua**: A execução da tarefa prossegue normalmente com o contexto resumido
@@ -407,6 +436,7 @@ strict_agent = Agent(
```
**O que acontece quando os limites de contexto são excedidos:**
- ❌ **Mensagem de erro**: `"Context length exceeded. Consider using smaller text or RAG tools from crewai_tools."`
- 🛑 **Execução interrompida**: A execução da tarefa é parada imediatamente
- 🔧 **Intervenção manual necessária**: Você precisará modificar sua abordagem
@@ -414,6 +444,7 @@ strict_agent = Agent(
### Como Escolher a Melhor Configuração
#### Use `respect_context_window=True` (padrão) quando:
- **Processar documentos grandes** que podem ultrapassar os limites de contexto
- **Conversas longas** onde certo grau de resumo é aceitável
- **Tarefas de pesquisa** onde o contexto geral é mais importante que detalhes exatos
@@ -432,6 +463,7 @@ document_processor = Agent(
```
#### Use `respect_context_window=False` quando:
- **Precisão é crítica** e perda de informação é inaceitável
- **Tarefas jurídicas ou médicas** que requerem contexto completo
- **Revisão de código** onde detalhes perdidos podem causar bugs
@@ -454,6 +486,7 @@ precision_agent = Agent(
Ao lidar com conjuntos de dados muito grandes, considere as seguintes estratégias:
#### 1. Use Ferramentas RAG
```python Code
from crewai_tools import RagTool
@@ -471,6 +504,7 @@ rag_agent = Agent(
```
#### 2. Use Fontes de Conhecimento
```python Code
# Use fontes de conhecimento ao invés de prompts grandes
knowledge_agent = Agent(
@@ -494,6 +528,7 @@ knowledge_agent = Agent(
### Solucionando Problemas de Contexto
**Se você receber erros de limite de contexto:**
```python Code
# Solução rápida: Habilite manipulação automática
agent.respect_context_window = True
@@ -507,6 +542,7 @@ agent.tools = [RagTool()]
```
**Se o resumo automático perder informações importantes:**
```python Code
# Desative o resumo automático e use RAG
agent = Agent(
@@ -520,28 +556,34 @@ agent = Agent(
```
<Note>
O recurso de gerenciamento da janela de contexto funciona automaticamente em segundo plano. Você não precisa chamar funções especiais – basta definir `respect_context_window` conforme deseja e o CrewAI cuida do resto!
O recurso de gerenciamento da janela de contexto funciona automaticamente em
segundo plano. Você não precisa chamar funções especiais – basta definir
`respect_context_window` conforme deseja e o CrewAI cuida do resto!
</Note>
## Considerações e Boas Práticas Importantes
### Segurança e Execução de Código
- Ao usar `allow_code_execution`, seja cauteloso com entradas do usuário e sempre as valide
- Use `code_execution_mode: "safe"` (Docker) em ambientes de produção
- Considere definir limites adequados de `max_execution_time` para evitar loops infinitos
### Otimização de Performance
- Use `respect_context_window: true` para evitar problemas com limite de tokens
- Ajuste `max_rpm` para evitar rate limiting
- Ative `cache: true` para melhorar performance em tarefas repetitivas
- Ajuste `max_iter` e `max_retry_limit` conforme a complexidade da tarefa
### Gerenciamento de Memória e Contexto
- Considere `knowledge_sources` para informações específicas de domínio
- Configure `embedder` ao usar modelos de embedding personalizados
- Use templates personalizados (`system_template`, `prompt_template`, `response_template`) para controle fino do comportamento do agente
### Funcionalidades Avançadas
- Ative `reasoning: true` para agentes que precisam planejar e refletir antes de tarefas complexas
- Defina `max_reasoning_attempts` para controlar as iterações de planejamento (`None` para ilimitadas)
- Use `inject_date: true` para dar consciência temporal a agentes em tarefas que dependem de datas
@@ -549,6 +591,7 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg
- Ative `multimodal: true` para agentes que precisam processar texto e imagem
### Colaboração entre Agentes
- Ative `allow_delegation: true` quando agentes precisarem trabalhar juntos
- Use `step_callback` para monitorar e registrar interações dos agentes
- Considere usar LLMs diferentes para propósitos distintos:
@@ -556,6 +599,7 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg
- `function_calling_llm` para uso eficiente de ferramentas
### Consciência de Data e Raciocínio
- Use `inject_date: true` para fornecer consciência temporal aos agentes em tarefas sensíveis ao tempo
- Customize o formato de data com `date_format` usando códigos standards de datetime do Python
- Códigos válidos incluem: %Y (ano), %m (mês), %d (dia), %B (nome completo do mês), etc.
@@ -563,22 +607,26 @@ O recurso de gerenciamento da janela de contexto funciona automaticamente em seg
- Ative `reasoning: true` para tarefas complexas que se beneficiam de planejamento e reflexão antecipados
### Compatibilidade de Modelos
- Defina `use_system_prompt: false` para modelos antigos que não suportam mensagens de sistema
- Certifique-se que o `llm` escolhido suporta as funcionalidades necessárias (como function calling)
## Solução de Problemas Comuns
1. **Limite de Taxa (Rate Limiting)**: Se atingir limites de API:
- Implemente o `max_rpm` adequado
- Use cache para operações repetitivas
- Considere agrupar requisições em lote
2. **Erros de Janela de Contexto**: Se exceder limites de contexto:
- Habilite `respect_context_window`
- Otimize seus prompts
- Limpe periodicamente a memória do agente
3. **Problemas de Execução de Código**: Se a execução de código falhar:
- Verifique se o Docker está instalado para o modo seguro
- Cheque permissões de execução
- Revise as configurações do sandbox de código

174
docs/pt-BR/concepts/cli.mdx
View File

@@ -4,7 +4,14 @@ description: Aprenda a usar o CLI do CrewAI para interagir com o CrewAI.
icon: terminal
mode: "wide"
---
<Warning>A partir da versão 0.140.0, a plataforma CrewAI AOP iniciou um processo de migração de seu provedor de login. Como resultado, o fluxo de autenticação via CLI foi atualizado. Usuários que utlizam o Google para fazer login, ou que criaram conta após 3 de julho de 2025 não poderão fazer login com versões anteriores da biblioteca `crewai`.</Warning>
<Warning>
A partir da versão 0.140.0, a plataforma CrewAI AMP iniciou um processo de
migração de seu provedor de login. Como resultado, o fluxo de autenticação via
CLI foi atualizado. Usuários que utlizam o Google para fazer login, ou que
criaram conta após 3 de julho de 2025 não poderão fazer login com versões
anteriores da biblioteca `crewai`.
</Warning>
## Visão Geral
@@ -40,6 +47,7 @@ crewai create [OPTIONS] TYPE NAME
- `NAME`: Nome do crew ou flow
Exemplo:
```shell Terminal
crewai create crew my_new_crew
crewai create flow my_new_flow
@@ -56,6 +64,7 @@ crewai version [OPTIONS]
- `--tools`: (Opcional) Mostra a versão instalada das ferramentas do CrewAI
Exemplo:
```shell Terminal
crewai version
crewai version --tools
@@ -73,6 +82,7 @@ crewai train [OPTIONS]
- `-f, --filename TEXT`: Caminho para um arquivo customizado para treinamento (padrão: "trained_agents_data.pkl")
Exemplo:
```shell Terminal
crewai train -n 10 -f my_training_data.pkl
```
@@ -104,6 +114,7 @@ crewai replay [OPTIONS]
- `-t, --task_id TEXT`: Reexecuta o crew a partir deste task ID, incluindo todas as tarefas subsequentes
Exemplo:
```shell Terminal
crewai replay -t task_123456
```
@@ -133,6 +144,7 @@ crewai reset-memories [OPTIONS]
- `-a, --all`: Redefine TODAS as memórias
Exemplo:
```shell Terminal
crewai reset-memories --long --short
crewai reset-memories --all
@@ -150,6 +162,7 @@ crewai test [OPTIONS]
- `-m, --model TEXT`: Modelo LLM para executar os testes no Crew (padrão: "gpt-4o-mini")
Exemplo:
```shell Terminal
crewai test -n 5 -m gpt-3.5-turbo
```
@@ -163,12 +176,17 @@ crewai run
```
<Note>
A partir da versão 0.103.0, o comando `crewai run` pode ser usado para executar tanto crews padrão quanto flows. Para flows, ele detecta automaticamente o tipo a partir do pyproject.toml e executa o comando apropriado. Este é agora o modo recomendado de executar tanto crews quanto flows.
A partir da versão 0.103.0, o comando `crewai run` pode ser usado para
executar tanto crews padrão quanto flows. Para flows, ele detecta
automaticamente o tipo a partir do pyproject.toml e executa o comando
apropriado. Este é agora o modo recomendado de executar tanto crews quanto
flows.
</Note>
<Note>
Certifique-se de executar estes comandos a partir do diretório onde seu projeto CrewAI está configurado.
Alguns comandos podem exigir configuração ou ajustes adicionais dentro da estrutura do seu projeto.
Certifique-se de executar estes comandos a partir do diretório onde seu
projeto CrewAI está configurado. Alguns comandos podem exigir configuração ou
ajustes adicionais dentro da estrutura do seu projeto.
</Note>
### 9. Chat
@@ -180,6 +198,7 @@ Depois de receber os resultados, você pode continuar interagindo com o assisten
```shell Terminal
crewai chat
```
<Note>
Garanta que você execute estes comandos a partir do diretório raiz do seu projeto CrewAI.
</Note>
@@ -197,28 +216,30 @@ def crew(self) -> Crew:
chat_llm="gpt-4o", # LLM para orquestração de chat
)
```
</Note>
### 10. Deploy
Implemente o crew ou flow no [CrewAI AOP](https://app.crewai.com).
Implemente o crew ou flow no [CrewAI AMP](https://app.crewai.com).
- **Autenticação**: Você precisa estar autenticado para implementar no CrewAI AOP.
Você pode fazer login ou criar uma conta com:
```shell Terminal
crewai login
```
- **Autenticação**: Você precisa estar autenticado para implementar no CrewAI AMP.
Você pode fazer login ou criar uma conta com:
```shell Terminal
crewai login
```
- **Criar um deployment**: Depois de autenticado, você pode criar um deployment para seu crew ou flow a partir da raiz do seu projeto local.
```shell Terminal
crewai deploy create
```
- Lê a configuração do seu projeto local.
- Solicita a confirmação das variáveis de ambiente (como `OPENAI_API_KEY`, `SERPER_API_KEY`) encontradas localmente. Elas serão armazenadas de forma segura junto ao deployment na plataforma Enterprise. Verifique se suas chaves sensíveis estão corretamente configuradas localmente (por exemplo, em um arquivo `.env`) antes de executar este comando.
```shell Terminal
crewai deploy create
```
- Lê a configuração do seu projeto local.
- Solicita a confirmação das variáveis de ambiente (como `OPENAI_API_KEY`, `SERPER_API_KEY`) encontradas localmente. Elas serão armazenadas de forma segura junto ao deployment na plataforma Enterprise. Verifique se suas chaves sensíveis estão corretamente configuradas localmente (por exemplo, em um arquivo `.env`) antes de executar este comando.
### 11. Gerenciamento de Organização
Gerencie suas organizações no CrewAI AOP.
Gerencie suas organizações no CrewAI AMP.
```shell Terminal
crewai org [COMMAND] [OPTIONS]
@@ -227,65 +248,80 @@ crewai org [COMMAND] [OPTIONS]
#### Comandos:
- `list`: Liste todas as organizações das quais você faz parte
```shell Terminal
crewai org list
```
- `current`: Exibe sua organização ativa atualmente
```shell Terminal
crewai org current
```
- `switch`: Mude para uma organização específica
```shell Terminal
crewai org switch <organization_id>
```
<Note>
Você deve estar autenticado no CrewAI AOP para usar estes comandos de gerenciamento de organização.
Você deve estar autenticado no CrewAI AMP para usar estes comandos de
gerenciamento de organização.
</Note>
- **Criar um deployment** (continuação):
- Vincula o deployment ao respectivo repositório remoto do GitHub (normalmente detectado automaticamente).
- **Implantar o Crew**: Depois de autenticado, você pode implantar seu crew ou flow no CrewAI AOP.
```shell Terminal
crewai deploy push
```
- Inicia o processo de deployment na plataforma CrewAI AOP.
- Após a iniciação bem-sucedida, será exibida a mensagem Deployment created successfully! juntamente com o Nome do Deployment e um Deployment ID (UUID) único.
- Vincula o deployment ao respectivo repositório remoto do GitHub (normalmente detectado automaticamente).
- **Implantar o Crew**: Depois de autenticado, você pode implantar seu crew ou flow no CrewAI AMP.
```shell Terminal
crewai deploy push
```
- Inicia o processo de deployment na plataforma CrewAI AMP.
- Após a iniciação bem-sucedida, será exibida a mensagem Deployment created successfully! juntamente com o Nome do Deployment e um Deployment ID (UUID) único.
- **Status do Deployment**: Você pode verificar o status do seu deployment com:
```shell Terminal
crewai deploy status
```
Isso retorna o status mais recente do último deployment iniciado (por exemplo, `Building Images for Crew`, `Deploy Enqueued`, `Online`).
```shell Terminal
crewai deploy status
```
Isso retorna o status mais recente do último deployment iniciado (por exemplo, `Building Images for Crew`, `Deploy Enqueued`, `Online`).
- **Logs do Deployment**: Você pode checar os logs do seu deployment com:
```shell Terminal
crewai deploy logs
```
Isso faz o streaming dos logs do deployment para seu terminal.
```shell Terminal
crewai deploy logs
```
Isso faz o streaming dos logs do deployment para seu terminal.
- **Listar deployments**: Você pode listar todos os seus deployments com:
```shell Terminal
crewai deploy list
```
Isto lista todos os seus deployments.
```shell Terminal
crewai deploy list
```
Isto lista todos os seus deployments.
- **Deletar um deployment**: Você pode deletar um deployment com:
```shell Terminal
crewai deploy remove
```
Isto exclui o deployment da plataforma CrewAI AOP.
```shell Terminal
crewai deploy remove
```
Isto exclui o deployment da plataforma CrewAI AMP.
- **Comando de Ajuda**: Você pode obter ajuda sobre o CLI com:
```shell Terminal
crewai deploy --help
```
Isto exibe a mensagem de ajuda para o CLI CrewAI Deploy.
```shell Terminal
crewai deploy --help
```
Isto exibe a mensagem de ajuda para o CLI CrewAI Deploy.
Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantação do seu crew no [CrewAI AOP](http://app.crewai.com) usando o CLI.
Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantação do seu crew no [CrewAI AMP](http://app.crewai.com) usando o CLI.
<iframe
className="w-full aspect-video rounded-xl"
@@ -298,7 +334,7 @@ Assista ao vídeo tutorial para uma demonstração passo-a-passo de implantaçã
### 11. Chaves de API
Ao executar o comando ```crewai create crew```, o CLI primeiro mostrará os 5 provedores de LLM mais comuns e pedirá para você selecionar um.
Ao executar o comando `crewai create crew`, o CLI primeiro mostrará os 5 provedores de LLM mais comuns e pedirá para você selecionar um.
Após selecionar um provedor de LLM, será solicitado que você informe as chaves de API.
@@ -306,11 +342,11 @@ Após selecionar um provedor de LLM, será solicitado que você informe as chave
Inicialmente, o CLI solicitará as chaves de API para os seguintes serviços:
* OpenAI
* Groq
* Anthropic
* Google Gemini
* SambaNova
- OpenAI
- Groq
- Anthropic
- Google Gemini
- SambaNova
Ao selecionar um provedor, o CLI solicitará que você insira sua chave de API.
@@ -322,7 +358,7 @@ Ao escolher um provedor, o CLI solicitará que você informe o nome da chave e a
Veja o seguinte link para o nome de chave de cada provedor:
* [LiteLLM Providers](https://docs.litellm.ai/docs/providers)
- [LiteLLM Providers](https://docs.litellm.ai/docs/providers)
### 12. Gerenciamento de Configuração
@@ -335,23 +371,26 @@ crewai config [COMANDO] [OPÇÕES]
#### Comandos:
- `list`: Exibir todos os parâmetros de configuração do CLI
```shell Terminal
crewai config list
```
- `set`: Definir um parâmetro de configuração do CLI
```shell Terminal
crewai config set <chave> <valor>
```
- `reset`: Redefinir todos os parâmetros de configuração do CLI para valores padrão
```shell Terminal
crewai config reset
```
#### Parâmetros de Configuração Disponíveis
- `enterprise_base_url`: URL base da instância CrewAI AOP
- `enterprise_base_url`: URL base da instância CrewAI AMP
- `oauth2_provider`: Provedor OAuth2 usado para autenticação (ex: workos, okta, auth0)
- `oauth2_audience`: Valor de audiência OAuth2, tipicamente usado para identificar a API ou recurso de destino
- `oauth2_client_id`: ID do cliente OAuth2 emitido pelo provedor, usado durante solicitações de autenticação
@@ -360,42 +399,51 @@ crewai config reset
#### Exemplos
Exibir configuração atual:
```shell Terminal
crewai config list
```
Exemplo de saída:
| Parâmetro | Valor | Descrição |
| :------------------- | :---------------------- | :------------------------------------------------------------ |
| enterprise_base_url | https://app.crewai.com | URL base da instância CrewAI AOP |
| org_name | Not set | Nome da organização atualmente ativa |
| org_uuid | Not set | UUID da organização atualmente ativa |
| oauth2_provider | workos | Provedor OAuth2 (ex.: workos, okta, auth0) |
| oauth2_audience | client_01YYY | Audience usada para identificar a API/recurso de destino |
| oauth2_client_id | client_01XXX | Client ID OAuth2 emitido pelo provedor (usado na autenticação) |
| oauth2_domain | login.crewai.com | Domínio do provedor OAuth2 (ex.: your-org.auth0.com) |
| Parâmetro | Valor | Descrição |
| :------------------ | :--------------------- | :------------------------------------------------------------- |
| enterprise_base_url | https://app.crewai.com | URL base da instância CrewAI AMP |
| org_name | Not set | Nome da organização atualmente ativa |
| org_uuid | Not set | UUID da organização atualmente ativa |
| oauth2_provider | workos | Provedor OAuth2 (ex.: workos, okta, auth0) |
| oauth2_audience | client_01YYY | Audience usada para identificar a API/recurso de destino |
| oauth2_client_id | client_01XXX | Client ID OAuth2 emitido pelo provedor (usado na autenticação) |
| oauth2_domain | login.crewai.com | Domínio do provedor OAuth2 (ex.: your-org.auth0.com) |
Definir a URL base do enterprise:
```shell Terminal
crewai config set enterprise_base_url https://minha-empresa.crewai.com
```
Definir provedor OAuth2:
```shell Terminal
crewai config set oauth2_provider auth0
```
Definir domínio OAuth2:
```shell Terminal
crewai config set oauth2_domain minha-empresa.auth0.com
```
Redefinir todas as configurações para padrões:
```shell Terminal
crewai config reset
```
<Note>
As configurações são armazenadas em `~/.config/crewai/settings.json`. Algumas configurações como nome da organização e UUID são somente leitura e gerenciadas através de comandos de autenticação e organização. Configurações relacionadas ao repositório de ferramentas são ocultas e não podem ser definidas diretamente pelo usuário.
As configurações são armazenadas em `~/.config/crewai/settings.json`. Algumas
configurações como nome da organização e UUID são somente leitura e
gerenciadas através de comandos de autenticação e organização. Configurações
relacionadas ao repositório de ferramentas são ocultas e não podem ser
definidas diretamente pelo usuário.
</Note>

8
docs/pt-BR/concepts/event-listener.mdx
View File

@@ -1,6 +1,6 @@
---
title: 'Listeners de Evento'
description: 'Acesse eventos do CrewAI para criar integrações e monitoramento personalizados'
title: "Listeners de Evento"
description: "Acesse eventos do CrewAI para criar integrações e monitoramento personalizados"
icon: spinner
mode: "wide"
---
@@ -20,11 +20,12 @@ O CrewAI utiliza uma arquitetura de event bus para emitir eventos ao longo do ci
Quando ações específicas ocorrem no CrewAI (como a inicialização de um Crew, um Agent concluindo uma tarefa ou o uso de uma ferramenta), o sistema emite os eventos correspondentes. Você pode registrar handlers para esses eventos para executar código personalizado quando eles acontecerem.
<Note type="info" title="Aprimoramento Enterprise: Prompt Tracing">
O CrewAI AOP fornece o recurso Prompt Tracing, que aproveita o sistema de eventos para rastrear, armazenar e visualizar todos os prompts, respostas e metadados associados. Isso proporciona poderosas capacidades de depuração e transparência nas operações dos seus agentes.
O CrewAI AMP fornece o recurso Prompt Tracing, que aproveita o sistema de eventos para rastrear, armazenar e visualizar todos os prompts, respostas e metadados associados. Isso proporciona poderosas capacidades de depuração e transparência nas operações dos seus agentes.
![Prompt Tracing Dashboard](/images/enterprise/traces-overview.png)
Com o Prompt Tracing você pode:
- Visualizar o histórico completo de todos os prompts enviados ao seu LLM
- Monitorar o uso de tokens e custos
- Depurar falhas de raciocínio dos agentes
@@ -263,7 +264,6 @@ A estrutura do objeto de evento depende do tipo do evento, mas todos herdam de `
Campos adicionais variam pelo tipo de evento. Por exemplo, `CrewKickoffCompletedEvent` inclui os campos `crew_name` e `output`.
## Uso Avançado: Handlers Escopados
Para lidar temporariamente com eventos (útil para testes ou operações específicas), você pode usar o context manager `scoped_handlers`:

136
docs/pt-BR/concepts/tasks.mdx
View File

@@ -14,11 +14,12 @@ As tarefas fornecem todos os detalhes necessários para sua execução, como des
As tarefas dentro do CrewAI podem ser colaborativas, exigindo que múltiplos agentes trabalhem juntos. Isso é gerenciado por meio das propriedades da tarefa e orquestrado pelo processo do Crew, potencializando o trabalho em equipe e a eficiência.
<Note type="info" title="Aprimoramento Empresarial: Construtor Visual de Tarefas">
O CrewAI AOP inclui um Construtor Visual de Tarefas no Crew Studio, que simplifica a criação e o encadeamento de tarefas complexas. Projete seus fluxos de tarefas visualmente e teste-os em tempo real sem necessidade de escrever código.
O CrewAI AMP inclui um Construtor Visual de Tarefas no Crew Studio, que simplifica a criação e o encadeamento de tarefas complexas. Projete seus fluxos de tarefas visualmente e teste-os em tempo real sem necessidade de escrever código.
![Task Builder Screenshot](/images/enterprise/crew-studio-interface.png)
O Construtor Visual de Tarefas permite:
- Criação de tarefas via arrastar-e-soltar
- Visualização de dependências e fluxo de tarefas
- Testes e validações em tempo real
@@ -28,10 +29,12 @@ O Construtor Visual de Tarefas permite:
### Fluxo de Execução de Tarefas
As tarefas podem ser executadas de duas maneiras:
- **Sequencial**: As tarefas são executadas na ordem em que são definidas
- **Hierárquica**: As tarefas são atribuídas aos agentes com base em seus papéis e especialidades
O fluxo de execução é definido ao criar o crew:
```python Code
crew = Crew(
agents=[agent1, agent2],
@@ -42,25 +45,25 @@ crew = Crew(
## Atributos da Tarefa
| Atributo | Parâmetros | Tipo | Descrição |
| :------------------------------- | :---------------- | :--------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| **Descrição** | `description` | `str` | Uma declaração clara e concisa do que a tarefa envolve. |
| **Saída Esperada** | `expected_output` | `str` | Uma descrição detalhada de como deve ser o resultado da tarefa concluída. |
| **Nome** _(opcional)_ | `name` | `Optional[str]` | Um identificador de nome para a tarefa. |
| **Agente** _(opcional)_ | `agent` | `Optional[BaseAgent]` | O agente responsável por executar a tarefa. |
| **Ferramentas** _(opcional)_ | `tools` | `List[BaseTool]` | As ferramentas/recursos que o agente pode usar para esta tarefa. |
| **Contexto** _(opcional)_ | `context` | `Optional[List["Task"]]` | Outras tarefas cujas saídas serão usadas como contexto para esta tarefa. |
| **Execução Assíncrona** _(opc.)_ | `async_execution` | `Optional[bool]` | Se a tarefa deve ser executada de forma assíncrona. O padrão é False. |
| **Input Humano** _(opcional)_ | `human_input` | `Optional[bool]` | Se a tarefa deve ter uma revisão humana da resposta final do agente. O padrão é False. |
| **Markdown** _(opcional)_ | `markdown` | `Optional[bool]` | Se a tarefa deve instruir o agente a retornar a resposta final formatada em Markdown. O padrão é False. |
| **Config** _(opcional)_ | `config` | `Optional[Dict[str, Any]]` | Parâmetros de configuração específicos da tarefa. |
| **Arquivo de Saída** _(opcional)_| `output_file` | `Optional[str]` | Caminho do arquivo para armazenar a saída da tarefa. |
| **Criar Diretório** _(opcional)_ | `create_directory` | `Optional[bool]` | Se deve criar o diretório para output_file caso não exista. O padrão é True. |
| **Saída JSON** _(opcional)_ | `output_json` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para estruturar a saída em JSON. |
| **Output Pydantic** _(opcional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para a saída da tarefa. |
| **Callback** _(opcional)_ | `callback` | `Optional[Any]` | Função/objeto a ser executado após a conclusão da tarefa. |
| **Guardrail** _(opcional)_ | `guardrail` | `Optional[Callable]` | Função para validar a saída da tarefa antes de prosseguir para a próxima tarefa. |
| **Max Tentativas Guardrail** _(opcional)_ | `guardrail_max_retries` | `Optional[int]` | Número máximo de tentativas quando a validação do guardrail falha. Padrão é 3. |
| Atributo | Parâmetros | Tipo | Descrição |
| :---------------------------------------- | :---------------------- | :-------------------------- | :------------------------------------------------------------------------------------------------------ |
| **Descrição** | `description` | `str` | Uma declaração clara e concisa do que a tarefa envolve. |
| **Saída Esperada** | `expected_output` | `str` | Uma descrição detalhada de como deve ser o resultado da tarefa concluída. |
| **Nome** _(opcional)_ | `name` | `Optional[str]` | Um identificador de nome para a tarefa. |
| **Agente** _(opcional)_ | `agent` | `Optional[BaseAgent]` | O agente responsável por executar a tarefa. |
| **Ferramentas** _(opcional)_ | `tools` | `List[BaseTool]` | As ferramentas/recursos que o agente pode usar para esta tarefa. |
| **Contexto** _(opcional)_ | `context` | `Optional[List["Task"]]` | Outras tarefas cujas saídas serão usadas como contexto para esta tarefa. |
| **Execução Assíncrona** _(opc.)_ | `async_execution` | `Optional[bool]` | Se a tarefa deve ser executada de forma assíncrona. O padrão é False. |
| **Input Humano** _(opcional)_ | `human_input` | `Optional[bool]` | Se a tarefa deve ter uma revisão humana da resposta final do agente. O padrão é False. |
| **Markdown** _(opcional)_ | `markdown` | `Optional[bool]` | Se a tarefa deve instruir o agente a retornar a resposta final formatada em Markdown. O padrão é False. |
| **Config** _(opcional)_ | `config` | `Optional[Dict[str, Any]]` | Parâmetros de configuração específicos da tarefa. |
| **Arquivo de Saída** _(opcional)_ | `output_file` | `Optional[str]` | Caminho do arquivo para armazenar a saída da tarefa. |
| **Criar Diretório** _(opcional)_ | `create_directory` | `Optional[bool]` | Se deve criar o diretório para output_file caso não exista. O padrão é True. |
| **Saída JSON** _(opcional)_ | `output_json` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para estruturar a saída em JSON. |
| **Output Pydantic** _(opcional)_ | `output_pydantic` | `Optional[Type[BaseModel]]` | Um modelo Pydantic para a saída da tarefa. |
| **Callback** _(opcional)_ | `callback` | `Optional[Any]` | Função/objeto a ser executado após a conclusão da tarefa. |
| **Guardrail** _(opcional)_ | `guardrail` | `Optional[Callable]` | Função para validar a saída da tarefa antes de prosseguir para a próxima tarefa. |
| **Max Tentativas Guardrail** _(opcional)_ | `guardrail_max_retries` | `Optional[int]` | Número máximo de tentativas quando a validação do guardrail falha. Padrão é 3. |
## Criando Tarefas
@@ -81,7 +84,7 @@ crew.kickoff(inputs={'topic': 'AI Agents'})
Veja um exemplo de configuração de tarefas usando YAML:
```yaml tasks.yaml
````yaml tasks.yaml
research_task:
description: >
Realize uma pesquisa detalhada sobre {topic}
@@ -101,7 +104,7 @@ reporting_task:
agent: reporting_analyst
markdown: true
output_file: report.md
```
````
Para usar essa configuração YAML em seu código, crie uma classe crew que herda de `CrewBase`:
@@ -159,7 +162,8 @@ class LatestAiDevelopmentCrew():
```
<Note>
Os nomes usados em seus arquivos YAML (`agents.yaml` e `tasks.yaml`) devem corresponder aos nomes dos métodos no seu código Python.
Os nomes usados em seus arquivos YAML (`agents.yaml` e `tasks.yaml`) devem
corresponder aos nomes dos métodos no seu código Python.
</Note>
### Definição Direta no Código (Alternativa)
@@ -196,7 +200,8 @@ reporting_task = Task(
```
<Tip>
Especifique diretamente um `agent` para a tarefa ou permita que o processo `hierarchical` do CrewAI decida com base em papéis, disponibilidade, etc.
Especifique diretamente um `agent` para a tarefa ou permita que o processo
`hierarchical` do CrewAI decida com base em papéis, disponibilidade, etc.
</Tip>
## Saída da Tarefa
@@ -209,22 +214,22 @@ Por padrão, o `TaskOutput` incluirá apenas a saída `raw`. Um `TaskOutput` só
### Atributos do Task Output
| Atributo | Parâmetros | Tipo | Descrição |
| :---------------- | :------------- | :------------------------- | :------------------------------------------------------------------------------------------ |
| **Description** | `description` | `str` | Descrição da tarefa. |
| **Summary** | `summary` | `Optional[str]` | Resumo da tarefa, gerado automaticamente a partir das primeiras 10 palavras da descrição. |
| **Raw** | `raw` | `str` | Saída bruta da tarefa. Este é o formato padrão da saída. |
| **Pydantic** | `pydantic` | `Optional[BaseModel]` | Objeto modelo Pydantic representando a saída da tarefa de forma estruturada. |
| **JSON Dict** | `json_dict` | `Optional[Dict[str, Any]]` | Dicionário representando a saída da tarefa em JSON. |
| **Agent** | `agent` | `str` | O agente que executou a tarefa. |
| **Output Format** | `output_format`| `OutputFormat` | O formato da saída da tarefa, podendo ser RAW, JSON e Pydantic. O padrão é RAW. |
| Atributo | Parâmetros | Tipo | Descrição |
| :---------------- | :-------------- | :------------------------- | :---------------------------------------------------------------------------------------- |
| **Description** | `description` | `str` | Descrição da tarefa. |
| **Summary** | `summary` | `Optional[str]` | Resumo da tarefa, gerado automaticamente a partir das primeiras 10 palavras da descrição. |
| **Raw** | `raw` | `str` | Saída bruta da tarefa. Este é o formato padrão da saída. |
| **Pydantic** | `pydantic` | `Optional[BaseModel]` | Objeto modelo Pydantic representando a saída da tarefa de forma estruturada. |
| **JSON Dict** | `json_dict` | `Optional[Dict[str, Any]]` | Dicionário representando a saída da tarefa em JSON. |
| **Agent** | `agent` | `str` | O agente que executou a tarefa. |
| **Output Format** | `output_format` | `OutputFormat` | O formato da saída da tarefa, podendo ser RAW, JSON e Pydantic. O padrão é RAW. |
### Métodos e Propriedades da Tarefa
| Método/Propriedade | Descrição |
| :----------------- | :--------------------------------------------------------------------------------------------- |
| **json** | Retorna a representação da saída da tarefa em JSON como string, se o formato de saída for JSON.|
| **to_dict** | Converte as saídas JSON e Pydantic para um dicionário. |
| Método/Propriedade | Descrição |
| :----------------- | :--------------------------------------------------------------------------------------------------- |
| **json** | Retorna a representação da saída da tarefa em JSON como string, se o formato de saída for JSON. |
| **to_dict** | Converte as saídas JSON e Pydantic para um dicionário. |
| **str** | Retorna a representação em string da saída da tarefa, priorizando Pydantic, depois JSON, depois raw. |
### Acessando Saídas das Tarefas
@@ -280,12 +285,13 @@ formatted_task = Task(
```
Quando `markdown=True`, o agente recebe instruções extras para formatar a saída usando:
- `#` para títulos
- `**texto**` para negrito
- `*texto*` para itálico
- `-` ou `*` para bullet points
- `` `código` `` para código inline
- ``` ```linguagem ``` para blocos de código
- ` `linguagem ``` para blocos de código
### Configuração YAML com Markdown
@@ -296,7 +302,7 @@ analysis_task:
expected_output: >
Uma análise completa com gráficos e descobertas-chave
agent: analyst
markdown: true # Habilita formatação em markdown
markdown: true # Habilita formatação em markdown
output_file: analysis.md
```
@@ -308,7 +314,9 @@ analysis_task:
- **Compatibilidade Multi-plataforma**: Markdown é universalmente suportado
<Note>
As instruções de formatação em markdown são adicionadas automaticamente ao prompt da tarefa quando `markdown=True`, então não é necessário detalhar os requisitos de formatação na descrição da tarefa.
As instruções de formatação em markdown são adicionadas automaticamente ao
prompt da tarefa quando `markdown=True`, então não é necessário detalhar os
requisitos de formatação na descrição da tarefa.
</Note>
## Dependências de Tarefas e Contexto
@@ -368,6 +376,7 @@ blog_task = Task(
### Requisitos da Função Guardrail
1. **Assinatura da Função**:
- Deve aceitar exatamente um parâmetro (a saída da tarefa)
- Deve retornar uma tupla `(bool, Any)`
- Type hints são recomendados, mas opcionais
@@ -376,11 +385,10 @@ blog_task = Task(
- Em caso de sucesso: retorna uma tupla `(True, resultado_validado)`
- Em caso de falha: retorna uma tupla `(False, "mensagem de erro explicando a falha")`
### Melhores Práticas de Tratamento de Erros
1. **Respostas de Erro Estruturadas**:
```python Code
from crewai import TaskOutput, LLMGuardrail
@@ -396,11 +404,13 @@ def validate_with_context(result: TaskOutput) -> Tuple[bool, Any]:
```
2. **Categorias de Erro**:
- Use códigos de erro específicos
- Inclua contexto relevante
- Forneça feedback acionável
3. **Cadeia de Validação**:
```python Code
from typing import Any, Dict, List, Tuple, Union
from crewai import TaskOutput
@@ -427,6 +437,7 @@ def complex_validation(result: TaskOutput) -> Tuple[bool, Any]:
### Tratamento dos Resultados do Guardrail
Quando um guardrail retorna `(False, erro)`:
1. O erro é enviado de volta para o agente
2. O agente tenta corrigir o problema
3. O processo se repete até:
@@ -434,6 +445,7 @@ Quando um guardrail retorna `(False, erro)`:
- O número máximo de tentativas ser atingido
Exemplo com manipulação de tentativas:
```python Code
from typing import Optional, Tuple, Union
from crewai import TaskOutput, Task
@@ -459,10 +471,12 @@ task = Task(
## Obtendo Saídas Estruturadas e Consistentes das Tarefas
<Note>
É importante também observar que a saída da última tarefa de um crew se torna a saída final do próprio crew.
É importante também observar que a saída da última tarefa de um crew se torna
a saída final do próprio crew.
</Note>
### Usando `output_pydantic`
A propriedade `output_pydantic` permite que você defina um modelo Pydantic que a saída da tarefa deve seguir. Isso garante que a saída seja não apenas estruturada, mas também validada de acordo com o modelo.
Veja um exemplo de uso do output_pydantic:
@@ -532,18 +546,22 @@ print("Acessando propriedades - Opção 5")
print("Blog:", result)
```
Neste exemplo:
* Um modelo Pydantic Blog é definido com os campos title e content.
* A tarefa task1 utiliza a propriedade output_pydantic para especificar que sua saída deve seguir o modelo Blog.
* Após executar o crew, você pode acessar a saída estruturada de várias formas, como mostrado.
- Um modelo Pydantic Blog é definido com os campos title e content.
- A tarefa task1 utiliza a propriedade output_pydantic para especificar que sua saída deve seguir o modelo Blog.
- Após executar o crew, você pode acessar a saída estruturada de várias formas, como mostrado.
#### Explicação sobre o acesso à saída
1. Indexação estilo dicionário: Acesse os campos diretamente usando result["nome_do_campo"]. Isso funciona porque a classe CrewOutput implementa o método __getitem__.
1. Indexação estilo dicionário: Acesse os campos diretamente usando result["nome_do_campo"]. Isso funciona porque a classe CrewOutput implementa o método **getitem**.
2. Diretamente do modelo Pydantic: Acesse os atributos diretamente do objeto result.pydantic.
3. Usando o método to_dict(): Converta a saída para um dicionário e acesse os campos.
4. Imprimindo o objeto inteiro: Simplesmente imprima o objeto result para ver a saída estruturada.
### Usando `output_json`
A propriedade `output_json` permite definir o formato de saída esperado em JSON. Isso garante que a saída da tarefa seja uma estrutura JSON válida que pode ser facilmente analisada e utilizada na aplicação.
Veja um exemplo de uso do `output_json`:
@@ -603,14 +621,15 @@ print("Blog:", result)
```
Neste exemplo:
* Um modelo Pydantic Blog é definido com os campos title e content, usado para especificar a estrutura do JSON de saída.
* A tarefa task1 utiliza a propriedade output_json para indicar que espera uma saída JSON que segue o modelo Blog.
* Após executar o crew, você pode acessar a saída estruturada em JSON conforme demonstrado.
- Um modelo Pydantic Blog é definido com os campos title e content, usado para especificar a estrutura do JSON de saída.
- A tarefa task1 utiliza a propriedade output_json para indicar que espera uma saída JSON que segue o modelo Blog.
- Após executar o crew, você pode acessar a saída estruturada em JSON conforme demonstrado.
#### Explicação sobre o acesso à saída
1. Acessando propriedades via indexação de dicionário: Você pode acessar os campos diretamente usando result["nome_do_campo"]. Isso é possível pois a classe CrewOutput implementa o método __getitem__, permitindo tratar a saída como um dicionário. Nesse caso, estamos acessando title e content do resultado.
2. Imprimindo o objeto Blog inteiro: Ao imprimir result, você obterá a representação em string do objeto CrewOutput. Como o método __str__ é implementado para retornar a saída em JSON, isso exibirá toda a saída como uma string formatada representando o objeto Blog.
1. Acessando propriedades via indexação de dicionário: Você pode acessar os campos diretamente usando result["nome_do_campo"]. Isso é possível pois a classe CrewOutput implementa o método **getitem**, permitindo tratar a saída como um dicionário. Nesse caso, estamos acessando title e content do resultado.
2. Imprimindo o objeto Blog inteiro: Ao imprimir result, você obterá a representação em string do objeto CrewOutput. Como o método **str** é implementado para retornar a saída em JSON, isso exibirá toda a saída como uma string formatada representando o objeto Blog.
---
@@ -827,8 +846,6 @@ task = Task(
)
```
```python Code
@CrewBase
class InternalCrew:
@@ -872,6 +889,7 @@ task = Task(
### Casos Comuns de Uso
#### Validação de Formato de Dados
```python Code
def validate_email_format(result: str) -> Tuple[bool, Union[str, str]]:
"""Garante que a saída contenha um e-mail válido."""
@@ -883,6 +901,7 @@ def validate_email_format(result: str) -> Tuple[bool, Union[str, str]]:
```
#### Filtragem de Conteúdo
```python Code
def filter_sensitive_info(result: str) -> Tuple[bool, Union[str, str]]:
"""Remove ou valida informações sensíveis."""
@@ -894,6 +913,7 @@ def filter_sensitive_info(result: str) -> Tuple[bool, Union[str, str]]:
```
#### Transformação de Dados
```python Code
def normalize_phone_number(result: str) -> Tuple[bool, Union[str, str]]:
"""Garante que números de telefone estejam em formato consistente."""
@@ -908,6 +928,7 @@ def normalize_phone_number(result: str) -> Tuple[bool, Union[str, str]]:
### Recursos Avançados
#### Encadeando Múltiplas Validações
```python Code
def chain_validations(*validators):
"""Encadeia múltiplos validadores."""
@@ -932,6 +953,7 @@ task = Task(
```
#### Lógica Customizada de Retentativas
```python Code
task = Task(
description="Gerar dados",
@@ -987,7 +1009,7 @@ analysis_task:
Um relatório financeiro abrangente com insights trimestrais
agent: financial_analyst
output_file: reports/quarterly/q4_2024_analysis.pdf
create_directory: true # Criar automaticamente o diretório 'reports/quarterly/'
create_directory: true # Criar automaticamente o diretório 'reports/quarterly/'
audit_task:
description: >
@@ -996,18 +1018,20 @@ audit_task:
Um relatório de auditoria de conformidade
agent: auditor
output_file: audit/compliance_report.md
create_directory: false # O diretório já deve existir
create_directory: false # O diretório já deve existir
```
### Casos de Uso
**Criação Automática de Diretórios (`create_directory=True`):**
- Ambientes de desenvolvimento e prototipagem
- Geração dinâmica de relatórios com pastas baseadas em datas
- Fluxos de trabalho automatizados onde a estrutura de diretórios pode variar
- Aplicações multi-tenant com pastas específicas do usuário
**Gerenciamento Manual de Diretórios (`create_directory=False`):**
- Ambientes de produção com controles rígidos do sistema de arquivos
- Aplicações sensíveis à segurança onde diretórios devem ser pré-configurados
- Sistemas com requisitos específicos de permissão

78
docs/pt-BR/concepts/tools.mdx
View File

@@ -17,9 +17,10 @@ Isso inclui ferramentas do [CrewAI Toolkit](https://github.com/joaomdmoura/crewa
permitindo desde buscas simples até interações complexas e trabalho em equipe eficiente entre agentes.
<Note type="info" title="Aprimoramento para Empresas: Repositório de Ferramentas">
O CrewAI AOP oferece um Repositório de Ferramentas abrangente, com integrações pré-construídas para sistemas empresariais e APIs comuns. Implemente agentes com ferramentas corporativas em minutos em vez de dias.
O CrewAI AMP oferece um Repositório de Ferramentas abrangente, com integrações pré-construídas para sistemas empresariais e APIs comuns. Implemente agentes com ferramentas corporativas em minutos em vez de dias.
O Repositório de Ferramentas Empresariais inclui:
- Conectores pré-construídos para sistemas empresariais populares
- Interface para criação de ferramentas personalizadas
- Controle de versão e funcionalidades de compartilhamento
@@ -116,44 +117,45 @@ crew.kickoff()
Aqui está uma lista das ferramentas disponíveis e suas descrições:
| Ferramenta | Descrição |
| :------------------------------- | :------------------------------------------------------------------------------------------- |
| **ApifyActorsTool** | Ferramenta que integra Apify Actors aos seus fluxos de trabalho para web scraping e automação.|
| **BrowserbaseLoadTool** | Ferramenta para interação e extração de dados de navegadores web. |
| **CodeDocsSearchTool** | Uma ferramenta RAG otimizada para busca em documentações de código e documentos técnicos. |
| **CodeInterpreterTool** | Ferramenta para interpretar código Python. |
| **ComposioTool** | Permite o uso de ferramentas Composio. |
| **CSVSearchTool** | Ferramenta RAG projetada para busca em arquivos CSV, ideal para dados estruturados. |
| **DALL-E Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |
| **DirectorySearchTool** | Ferramenta RAG para busca em diretórios, útil para navegação em sistemas de arquivos. |
| **DOCXSearchTool** | Ferramenta RAG voltada para busca em documentos DOCX, ideal para processar arquivos Word. |
| **DirectoryReadTool** | Facilita a leitura e processamento de estruturas de diretórios e seus conteúdos. |
| **EXASearchTool** | Ferramenta projetada para buscas exaustivas em diversas fontes de dados. |
| **FileReadTool** | Permite a leitura e extração de dados de arquivos, suportando diversos formatos. |
| **FirecrawlSearchTool** | Ferramenta para buscar páginas web usando Firecrawl e retornar os resultados. |
| **FirecrawlCrawlWebsiteTool** | Ferramenta para rastrear páginas web utilizando o Firecrawl. |
| **FirecrawlScrapeWebsiteTool** | Ferramenta para extrair o conteúdo de URLs usando Firecrawl. |
| **GithubSearchTool** | Ferramenta RAG para buscar em repositórios GitHub, útil para pesquisa de código e documentação.|
| **SerperDevTool** | Ferramenta especializada para finalidades de desenvolvimento, com funcionalidades em evolução. |
| **TXTSearchTool** | Ferramenta RAG voltada para busca em arquivos de texto (.txt), adaptada para dados não estruturados. |
| **JSONSearchTool** | Ferramenta RAG para busca em arquivos JSON, voltada ao manuseio de dados estruturados. |
| **LlamaIndexTool** | Permite o uso das ferramentas LlamaIndex. |
| **MDXSearchTool** | Ferramenta RAG para busca em arquivos Markdown (MDX), útil para documentação. |
| **PDFSearchTool** | Ferramenta RAG para busca em documentos PDF, ideal para processar documentos digitalizados. |
| **PGSearchTool** | Ferramenta RAG otimizada para busca em bancos de dados PostgreSQL, adequada para consultas. |
| **Vision Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |
| **RagTool** | Ferramenta RAG de uso geral, capaz de lidar com diferentes fontes e tipos de dados. |
| **ScrapeElementFromWebsiteTool** | Permite extrair elementos específicos de sites, útil para extração de dados direcionada. |
| **ScrapeWebsiteTool** | Facilita o scraping de sites inteiros, ideal para coleta abrangente de dados. |
| **WebsiteSearchTool** | Ferramenta RAG para busca em conteúdos de sites, otimizada para extração de dados web. |
| **XMLSearchTool** | Ferramenta RAG para busca em arquivos XML, adequada para formatos de dados estruturados. |
| **YoutubeChannelSearchTool** | Ferramenta RAG para busca em canais do YouTube, útil para análise de conteúdo em vídeo. |
| **YoutubeVideoSearchTool** | Ferramenta RAG para busca em vídeos do YouTube, ideal para extração de dados de vídeo. |
| Ferramenta | Descrição |
| :------------------------------- | :--------------------------------------------------------------------------------------------------- |
| **ApifyActorsTool** | Ferramenta que integra Apify Actors aos seus fluxos de trabalho para web scraping e automação. |
| **BrowserbaseLoadTool** | Ferramenta para interação e extração de dados de navegadores web. |
| **CodeDocsSearchTool** | Uma ferramenta RAG otimizada para busca em documentações de código e documentos técnicos. |
| **CodeInterpreterTool** | Ferramenta para interpretar código Python. |
| **ComposioTool** | Permite o uso de ferramentas Composio. |
| **CSVSearchTool** | Ferramenta RAG projetada para busca em arquivos CSV, ideal para dados estruturados. |
| **DALL-E Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |
| **DirectorySearchTool** | Ferramenta RAG para busca em diretórios, útil para navegação em sistemas de arquivos. |
| **DOCXSearchTool** | Ferramenta RAG voltada para busca em documentos DOCX, ideal para processar arquivos Word. |
| **DirectoryReadTool** | Facilita a leitura e processamento de estruturas de diretórios e seus conteúdos. |
| **EXASearchTool** | Ferramenta projetada para buscas exaustivas em diversas fontes de dados. |
| **FileReadTool** | Permite a leitura e extração de dados de arquivos, suportando diversos formatos. |
| **FirecrawlSearchTool** | Ferramenta para buscar páginas web usando Firecrawl e retornar os resultados. |
| **FirecrawlCrawlWebsiteTool** | Ferramenta para rastrear páginas web utilizando o Firecrawl. |
| **FirecrawlScrapeWebsiteTool** | Ferramenta para extrair o conteúdo de URLs usando Firecrawl. |
| **GithubSearchTool** | Ferramenta RAG para buscar em repositórios GitHub, útil para pesquisa de código e documentação. |
| **SerperDevTool** | Ferramenta especializada para finalidades de desenvolvimento, com funcionalidades em evolução. |
| **TXTSearchTool** | Ferramenta RAG voltada para busca em arquivos de texto (.txt), adaptada para dados não estruturados. |
| **JSONSearchTool** | Ferramenta RAG para busca em arquivos JSON, voltada ao manuseio de dados estruturados. |
| **LlamaIndexTool** | Permite o uso das ferramentas LlamaIndex. |
| **MDXSearchTool** | Ferramenta RAG para busca em arquivos Markdown (MDX), útil para documentação. |
| **PDFSearchTool** | Ferramenta RAG para busca em documentos PDF, ideal para processar documentos digitalizados. |
| **PGSearchTool** | Ferramenta RAG otimizada para busca em bancos de dados PostgreSQL, adequada para consultas. |
| **Vision Tool** | Ferramenta para gerar imagens utilizando a API do DALL-E. |
| **RagTool** | Ferramenta RAG de uso geral, capaz de lidar com diferentes fontes e tipos de dados. |
| **ScrapeElementFromWebsiteTool** | Permite extrair elementos específicos de sites, útil para extração de dados direcionada. |
| **ScrapeWebsiteTool** | Facilita o scraping de sites inteiros, ideal para coleta abrangente de dados. |
| **WebsiteSearchTool** | Ferramenta RAG para busca em conteúdos de sites, otimizada para extração de dados web. |
| **XMLSearchTool** | Ferramenta RAG para busca em arquivos XML, adequada para formatos de dados estruturados. |
| **YoutubeChannelSearchTool** | Ferramenta RAG para busca em canais do YouTube, útil para análise de conteúdo em vídeo. |
| **YoutubeVideoSearchTool** | Ferramenta RAG para busca em vídeos do YouTube, ideal para extração de dados de vídeo. |
## Criando suas próprias Ferramentas
<Tip>
Desenvolvedores podem criar `ferramentas personalizadas` adaptadas para as necessidades de seus agentes ou utilizar opções pré-construídas.
Desenvolvedores podem criar `ferramentas personalizadas` adaptadas para as
necessidades de seus agentes ou utilizar opções pré-construídas.
</Tip>
Existem duas formas principais de criar uma ferramenta CrewAI:
@@ -248,8 +250,10 @@ def my_tool(question: str) -> str:
### Mecanismo de Cache Personalizado
<Tip>
As ferramentas podem implementar opcionalmente uma `cache_function` para ajuste fino do comportamento de cache.
Esta função determina quando armazenar resultados em cache com base em condições específicas, oferecendo controle granular sobre a lógica de cache.
As ferramentas podem implementar opcionalmente uma `cache_function` para
ajuste fino do comportamento de cache. Esta função determina quando armazenar
resultados em cache com base em condições específicas, oferecendo controle
granular sobre a lógica de cache.
</Tip>
```python Code

35
docs/pt-BR/enterprise/features/rbac.mdx
View File

@@ -7,10 +7,10 @@ mode: "wide"
## Visão Geral
O RBAC no CrewAI AOP permite gerenciar acesso de forma segura e escalável combinando **funções em nível de organização** com **controles de visibilidade em nível de automação**.
O RBAC no CrewAI AMP permite gerenciar acesso de forma segura e escalável combinando **funções em nível de organização** com **controles de visibilidade em nível de automação**.
<Frame>
<img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI AOP" />
<img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI AMP" />
</Frame>
@@ -28,10 +28,11 @@ A configuração de usuários e funções é feita em Settings → Roles.
<Steps>
<Step title="Abrir Roles">
Vá em <b>Settings → Roles</b> no CrewAI AOP.
Vá em <b>Settings → Roles</b> no CrewAI AMP.
</Step>
<Step title="Escolher a função">
Use <b>Owner</b> ou <b>Member</b>, ou clique em <b>Create role</b> para criar uma função personalizada.
Use <b>Owner</b> ou <b>Member</b>, ou clique em <b>Create role</b> para
criar uma função personalizada.
</Step>
<Step title="Atribuir aos membros">
Selecione os usuários e atribua a função. Você pode alterar depois.
@@ -40,10 +41,10 @@ A configuração de usuários e funções é feita em Settings → Roles.
### Resumo de configuração
| Área | Onde configurar | Opções |
|:---|:---|:---|
| Usuários & Funções | Settings → Roles | Pré-definidas: Owner, Member; Funções personalizadas |
| Visibilidade da automação | Automation → Settings → Visibility | Private; Lista de usuários/funções |
| Área | Onde configurar | Opções |
| :------------------------ | :--------------------------------- | :--------------------------------------------------- |
| Usuários & Funções | Settings → Roles | Pré-definidas: Owner, Member; Funções personalizadas |
| Visibilidade da automação | Automation → Settings → Visibility | Private; Lista de usuários/funções |
## Controle de Acesso em Nível de Automação
@@ -73,7 +74,8 @@ Configure em Automation → Settings → Visibility.
Selecione <b>Private</b> para restringir o acesso. O owner mantém acesso.
</Step>
<Step title="Permitir acesso">
Adicione usuários e funções que poderão ver/executar e acessar logs/métricas/configurações.
Adicione usuários e funções que poderão ver/executar e acessar
logs/métricas/configurações.
</Step>
<Step title="Salvar e verificar">
Salve e confirme que não listados não conseguem ver ou executar a automação.
@@ -82,18 +84,19 @@ Configure em Automation → Settings → Visibility.
### Resultado de acesso no modo Private
| Ação | Owner | Usuário/função na whitelist | Não listado |
|:---|:---|:---|:---|
| Ver automação | ✓ | ✓ | ✗ |
| Executar/API | ✓ | ✓ | ✗ |
| Logs/métricas/configurações | ✓ | ✓ | ✗ |
| Ação | Owner | Usuário/função na whitelist | Não listado |
| :-------------------------- | :---- | :-------------------------- | :---------- |
| Ver automação | ✓ | ✓ | ✗ |
| Executar/API | ✓ | ✓ | ✗ |
| Logs/métricas/configurações | ✓ | ✓ | ✗ |
<Tip>
O owner sempre possui acesso. Em modo privado, somente usuários/funções na whitelist têm permissão.
O owner sempre possui acesso. Em modo privado, somente usuários/funções na
whitelist têm permissão.
</Tip>
<Frame>
<img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI AOP" />
<img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI AMP" />
</Frame>

333
docs/pt-BR/enterprise/features/tools-and-integrations.mdx
View File

@@ -18,212 +18,221 @@ Ferramentas & Integrações é o hub central para conectar aplicações de terce
<Tabs>
<Tab title="Integrações" icon="plug">
## Aplicativos para Agentes (Integrações)
## Aplicativos para Agentes (Integrações)
Conecte aplicações empresariais (por exemplo, Gmail, Google Drive, HubSpot, Slack) via OAuth para habilitar ações de agentes.
Conecte aplicações empresariais (por exemplo, Gmail, Google Drive, HubSpot, Slack) via OAuth para habilitar ações de agentes.
<Steps>
<Step title="Conectar">
Clique em <b>Conectar</b> no app desejado e conclua o OAuth.
</Step>
<Step title="Configurar">
Ajuste escopos, gatilhos e ações disponíveis conforme necessário.
</Step>
<Step title="Usar em Agentes">
Os serviços conectados ficam disponíveis como ferramentas para seus agentes.
</Step>
</Steps>
{" "}
<Steps>
<Step title="Conectar">
Clique em <b>Conectar</b> no app desejado e conclua o OAuth.
</Step>
<Step title="Configurar">
Ajuste escopos, gatilhos e ações disponíveis conforme necessário.
</Step>
<Step title="Usar em Agentes">
Os serviços conectados ficam disponíveis como ferramentas para seus agentes.
</Step>
</Steps>
<Frame>
![Aplicativos](/images/enterprise/agent-apps.png)
</Frame>
{" "}
<Frame>![Aplicativos](/images/enterprise/agent-apps.png)</Frame>
### Conectar sua conta
### Conectar sua conta
1. Acesse <Link href="https://app.crewai.com/crewai_plus/connectors">Integrações</Link>
2. Clique em <b>Conectar</b> no serviço desejado
3. Conclua o fluxo OAuth e conceda os escopos
4. Copie seu Token Enterprise em <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Configurações de Integração</Link>
1. Acesse <Link href="https://app.crewai.com/crewai_plus/connectors">Integrações</Link>
2. Clique em <b>Conectar</b> no serviço desejado
3. Conclua o fluxo OAuth e conceda os escopos
4. Copie seu Token Enterprise em <Link href="https://app.crewai.com/crewai_plus/settings/integrations">Configurações de Integração</Link>
<Frame>
![Token Enterprise](/images/enterprise/enterprise_action_auth_token.png)
</Frame>
{" "}
<Frame>
![Token Enterprise](/images/enterprise/enterprise_action_auth_token.png)
</Frame>
### Instalar ferramentas de integração
### Instalar ferramentas de integração
Para usar as integrações localmente, instale a versão mais recente do pacote `crewai-tools`.
Para usar as integrações localmente, instale a versão mais recente do pacote `crewai-tools`.
```bash
uv add crewai-tools
```
```bash
uv add crewai-tools
```
### Configuração de variável de ambiente
### 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>
{" "}
<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
export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"
```
```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="seu_enterprise_token"
```
Ou adicione ao seu arquivo `.env`:
Ou adicione ao seu arquivo `.env`:
```
CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
```
```
CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
```
### Exemplo de uso
### Exemplo de uso
<Tip>
Use a nova abordagem simplificada para integrar aplicativos empresariais. Simplesmente especifique o aplicativo e suas ações diretamente na configuração do Agent.
</Tip>
{" "}
<Tip>
Use a nova abordagem simplificada para integrar aplicativos empresariais.
Simplesmente especifique o aplicativo e suas ações diretamente na configuração
do Agent.
</Tip>
```python
from crewai import Agent, Task, Crew
```python
from crewai import Agent, Task, Crew
# Crie um agente com capacidades do Gmail
email_agent = Agent(
role="Gerente de Email",
goal="Gerenciar e organizar comunicações por email",
backstory="Assistente de IA especializado em gestão de emails",
apps=['gmail', 'gmail/send_email'] # Usando nome canônico 'gmail'
)
# Crie um agente com capacidades do Gmail
email_agent = Agent(
role="Gerente de Email",
goal="Gerenciar e organizar comunicações por email",
backstory="Assistente de IA especializado em gestão de emails",
apps=['gmail', 'gmail/send_email'] # Usando nome canônico 'gmail'
)
email_task = Task(
description="Criar e enviar follow-up para john@example.com sobre a atualização do projeto",
agent=email_agent,
expected_output="Confirmação de envio do email com sucesso"
)
email_task = Task(
description="Criar e enviar follow-up para john@example.com sobre a atualização do projeto",
agent=email_agent,
expected_output="Confirmação de envio do email com sucesso"
)
crew = Crew(agents=[email_agent], tasks=[email_task])
crew.kickoff()
```
crew = Crew(agents=[email_agent], tasks=[email_task])
crew.kickoff()
```
### Filtrando ferramentas
### Filtrando ferramentas
```python
from crewai import Agent, Task, Crew
```python
from crewai import Agent, Task, Crew
# Crie agente com ações específicas do Gmail apenas
gmail_agent = Agent(
role="Gerente de Gmail",
goal="Gerenciar comunicações e notificações no Gmail",
backstory="Assistente de IA para coordenação de emails",
apps=['gmail/fetch_emails'] # Usando nome canônico com ação específica
)
# Crie agente com ações específicas do Gmail apenas
gmail_agent = Agent(
role="Gerente de Gmail",
goal="Gerenciar comunicações e notificações no Gmail",
backstory="Assistente de IA para coordenação de emails",
apps=['gmail/fetch_emails'] # Usando nome canônico com ação específica
)
notification_task = Task(
description="Encontrar o email de john@example.com",
agent=gmail_agent,
expected_output="Email encontrado de john@example.com"
)
notification_task = Task(
description="Encontrar o email de john@example.com",
agent=gmail_agent,
expected_output="Email encontrado de john@example.com"
)
crew = Crew(agents=[gmail_agent], tasks=[notification_task])
```
crew = Crew(agents=[gmail_agent], tasks=[notification_task])
```
Em um crew implantado, você pode especificar quais ações ficam disponíveis em cada integração na página de configurações do serviço.
Em um crew implantado, você pode especificar quais ações ficam disponíveis em cada integração na página de configurações do serviço.
<Frame>
![Filtrar Ações](/images/enterprise/filtering_enterprise_action_tools.png)
</Frame>
{" "}
<Frame>
![Filtrar Ações](/images/enterprise/filtering_enterprise_action_tools.png)
</Frame>
### Implantações com escopo (organizações multiusuário)
### Implantações com escopo (organizações multiusuário)
Você pode escopar cada integração para um usuário específico (por exemplo, usar a conta Gmail de um usuário).
Você pode escopar cada integração para um usuário específico (por exemplo, usar a conta Gmail de um usuário).
<Tip>
Útil quando diferentes equipes/usuários precisam manter o acesso a dados isolado.
</Tip>
{" "}
<Tip>
Útil quando diferentes equipes/usuários precisam manter o acesso a dados
isolado.
</Tip>
Use `user_bearer_token` para escopar a autenticação ao usuário solicitante. Se o usuário não estiver logado, o crew não usará integrações conectadas; caso contrário, usa o token padrão configurado na implantação.
Use `user_bearer_token` para escopar a autenticação ao usuário solicitante. Se o usuário não estiver logado, o crew não usará integrações conectadas; caso contrário, usa o token padrão configurado na implantação.
<Frame>
![Token de Usuário](/images/enterprise/user_bearer_token.png)
</Frame>
{" "}
<Frame>![Token de Usuário](/images/enterprise/user_bearer_token.png)</Frame>
<div id="catalog"></div>
### Catálogo
{" "}
<div id="catalog"></div>
### Catálogo
#### Comunicação & Colaboração
- Gmail — Gerenciamento de emails e rascunhos
- Slack — Notificações e alertas do workspace
- Microsoft — Integração com Office 365 e Teams
#### Comunicação & Colaboração
#### Gestão de Projetos
- Jira — Rastreamento de issues e projetos
- ClickUp — Gestão de tarefas e produtividade
- Asana — Coordenação de tarefas de equipe
- Notion — Páginas e bancos de dados
- Linear — Gestão de bugs e projetos de software
- GitHub — Repositórios e issues
- Gmail — Gerenciamento de emails e rascunhos
- Slack — Notificações e alertas do workspace
- Microsoft — Integração com Office 365 e Teams
#### CRM
- Salesforce — Contas e oportunidades
- HubSpot — Pipeline de vendas e contatos
- Zendesk — Tickets de suporte
#### Gestão de Projetos
#### Negócios & Finanças
- Stripe — Pagamentos e clientes
- Shopify — E‑commerce e produtos
- Jira — Rastreamento de issues e projetos
- ClickUp — Gestão de tarefas e produtividade
- Asana — Coordenação de tarefas de equipe
- Notion — Páginas e bancos de dados
- Linear — Gestão de bugs e projetos de software
- GitHub — Repositórios e issues
#### Produtividade & Armazenamento
- Google Sheets — Sincronização de planilhas
- Google Calendar — Eventos e agenda
- Box — Armazenamento de arquivos
#### CRM
…e mais por vir!
- Salesforce — Contas e oportunidades
- HubSpot — Pipeline de vendas e contatos
- Zendesk — Tickets de suporte
#### Negócios & Finanças
- Stripe — Pagamentos e clientes
- Shopify — E‑commerce e produtos
#### Produtividade & Armazenamento
- Google Sheets — Sincronização de planilhas
- Google Calendar — Eventos e agenda
- Box — Armazenamento de arquivos
…e mais por vir!
</Tab>
<Tab title="Ferramentas Internas" icon="toolbox">
## Ferramentas Internas
## Ferramentas Internas
Crie ferramentas localmente, publique no Repositório de Ferramentas da CrewAI AOP e use nos seus agentes.
Crie ferramentas localmente, publique no Repositório de Ferramentas da CrewAI AMP e use nos seus agentes.
<Tip>
Antes de executar os comandos abaixo, faça login na sua conta CrewAI AOP:
```bash
crewai login
```
</Tip>
{" "}
<Tip>
Antes de executar os comandos abaixo, faça login na sua conta CrewAI AMP:
```bash crewai login ```
</Tip>
<Frame>
![Ferramenta Interna](/images/enterprise/tools-integrations-internal.png)
</Frame>
{" "}
<Frame>
![Ferramenta Interna](/images/enterprise/tools-integrations-internal.png)
</Frame>
<Steps>
<Step title="Criar">
Criar uma nova ferramenta localmente.
```bash
crewai tool create your-tool
```
</Step>
<Step title="Publicar">
Publicar a ferramenta no Repositório de Ferramentas.
```bash
crewai tool publish
```
</Step>
<Step title="Instalar">
Instalar a ferramenta do Repositório de Ferramentas.
```bash
crewai tool install your-tool
```
</Step>
</Steps>
{" "}
<Steps>
<Step title="Criar">
Criar uma nova ferramenta localmente. ```bash crewai tool create your-tool```
</Step>
<Step title="Publicar">
Publicar a ferramenta no Repositório de Ferramentas. ```bash crewai tool
publish ```
</Step>
<Step title="Instalar">
Instalar a ferramenta do Repositório de Ferramentas. ```bash crewai tool
install your-tool ```
</Step>
</Steps>
Gerenciar:
Gerenciar:
- Nome e descrição
- Visibilidade (Privado / Público)
- Variáveis de ambiente necessárias
- Histórico de versões e downloads
- Acesso por equipe e função
- Nome e descrição
- Visibilidade (Privado / Público)
- Variáveis de ambiente necessárias
- Histórico de versões e downloads
- Acesso por equipe e função
<Frame>
![Configurações de Ferramenta](/images/enterprise/tool-configs.png)
</Frame>
{" "}
<Frame>
![Configurações de Ferramenta](/images/enterprise/tool-configs.png)
</Frame>
</Tab>
</Tabs>
@@ -231,10 +240,18 @@ Ferramentas & Integrações é o hub central para conectar aplicações de terce
## Relacionados
<CardGroup cols={2}>
<Card title="Repositório de Ferramentas" href="/pt-BR/enterprise/guides/tool-repository" icon="toolbox">
<Card
title="Repositório de Ferramentas"
href="/pt-BR/enterprise/guides/tool-repository"
icon="toolbox"
>
Publique e instale ferramentas para ampliar as capacidades dos seus crews.
</Card>
<Card title="Automação com Webhook" href="/pt-BR/enterprise/guides/webhook-automation" icon="bolt">
<Card
title="Automação com Webhook"
href="/pt-BR/enterprise/guides/webhook-automation"
icon="bolt"
>
Automatize fluxos e integre com plataformas e serviços externos.
</Card>
</CardGroup>

35
docs/pt-BR/enterprise/features/traces.mdx
View File

@@ -11,7 +11,7 @@ Traces fornecem visibilidade abrangente sobre as execuções dos seus crews, aju
## O que são Traces?
Traces no CrewAI AOP são registros detalhados de execução que capturam todos os aspectos da operação do seu crew, desde as entradas iniciais até as saídas finais. Eles registram:
Traces no CrewAI AMP são registros detalhados de execução que capturam todos os aspectos da operação do seu crew, desde as entradas iniciais até as saídas finais. Eles registram:
- Pensamentos e raciocínio do agente
- Detalhes da execução das tarefas
@@ -20,15 +20,13 @@ Traces no CrewAI AOP são registros detalhados de execução que capturam todos
- Tempos de execução
- Estimativas de custo
<Frame>
![Traces Overview](/images/enterprise/traces-overview.png)
</Frame>
<Frame>![Traces Overview](/images/enterprise/traces-overview.png)</Frame>
## Acessando os Traces
<Steps>
<Step title="Navegue até a aba Traces">
No seu painel do CrewAI AOP, clique em **Traces** para ver todos os registros de execução.
No seu painel do CrewAI AMP, clique em **Traces** para ver todos os registros de execução.
</Step>
<Step title="Selecione uma Execução">
@@ -51,9 +49,7 @@ A seção superior exibe métricas de alto nível sobre a execução:
- **Tempo de Execução**: Duração total da execução do crew
- **Custo Estimado**: Custo aproximado com base no uso de tokens
<Frame>
![Execution Summary](/images/enterprise/trace-summary.png)
</Frame>
<Frame>![Execution Summary](/images/enterprise/trace-summary.png)</Frame>
### 2. Tarefas & Agentes
@@ -64,33 +60,25 @@ Esta seção mostra todas as tarefas e agentes que fizeram parte da execução d
- Status (concluído/falhou)
- Tempo de execução individual da tarefa
<Frame>
![Task List](/images/enterprise/trace-tasks.png)
</Frame>
<Frame>![Task List](/images/enterprise/trace-tasks.png)</Frame>
### 3. Saída Final
Exibe o resultado final produzido pelo crew após a conclusão de todas as tarefas.
<Frame>
![Final Output](/images/enterprise/final-output.png)
</Frame>
<Frame>![Final Output](/images/enterprise/final-output.png)</Frame>
### 4. Linha do Tempo da Execução
Uma representação visual de quando cada tarefa começou e terminou, ajudando a identificar gargalos ou padrões de execução paralela.
<Frame>
![Execution Timeline](/images/enterprise/trace-timeline.png)
</Frame>
<Frame>![Execution Timeline](/images/enterprise/trace-timeline.png)</Frame>
### 5. Visão Detalhada da Tarefa
Ao clicar em uma tarefa específica na linha do tempo ou na lista de tarefas, você verá:
<Frame>
![Detailed Task View](/images/enterprise/trace-detailed-task.png)
</Frame>
<Frame>![Detailed Task View](/images/enterprise/trace-detailed-task.png)</Frame>
- **Task Key**: Identificador único da tarefa
- **Task ID**: Identificador técnico no sistema
@@ -104,7 +92,6 @@ Ao clicar em uma tarefa específica na linha do tempo ou na lista de tarefas, vo
- **Input**: Qualquer entrada fornecida a essa tarefa vinda de tarefas anteriores
- **Output**: O resultado real produzido pelo agente
## Usando Traces para Depuração
Traces são indispensáveis para solucionar problemas nos seus crews:
@@ -121,6 +108,7 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
<Frame>
![Failure Points](/images/enterprise/failure.png)
</Frame>
</Step>
<Step title="Otimizar Desempenho">
@@ -130,6 +118,7 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
- Uso excessivo de tokens
- Operações redundantes de ferramentas
- Chamadas de API desnecessárias
</Step>
<Step title="Melhore a Eficiência de Custos">
@@ -139,9 +128,11 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
- Refine prompts para serem mais concisos
- Faça cache de informações acessadas frequentemente
- Estruture tarefas para minimizar operações redundantes
</Step>
</Steps>
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência com análise de traces ou outros recursos do CrewAI AOP.
Entre em contato com nossa equipe de suporte para assistência com análise de
traces ou outros recursos do CrewAI AMP.
</Card>

15
docs/pt-BR/enterprise/features/webhook-streaming.mdx
View File

@@ -7,16 +7,17 @@ mode: "wide"
## Visão Geral
O Enterprise Event Streaming permite que você receba atualizações em tempo real via webhook sobre suas crews e flows implantados no CrewAI AOP, como chamadas de modelo, uso de ferramentas e etapas do flow.
O Enterprise Event Streaming permite que você receba atualizações em tempo real via webhook sobre suas crews e flows implantados no CrewAI AMP, como chamadas de modelo, uso de ferramentas e etapas do flow.
## Uso
Ao utilizar a API Kickoff, inclua um objeto `webhooks` em sua requisição, por exemplo:
# Exemplo de uso da API Kickoff com webhooks
```json
{
"inputs": {"foo": "bar"},
"inputs": { "foo": "bar" },
"webhooks": {
"events": ["crew_kickoff_started", "llm_call_started"],
"url": "https://seu.endpoint/webhook",
@@ -36,6 +37,7 @@ Se `realtime` estiver definido como `true`, cada evento será entregue individua
Cada webhook envia uma lista de eventos:
# Exemplo de evento enviado pelo webhook
```json
{
"events": [
@@ -47,8 +49,8 @@ Cada webhook envia uma lista de eventos:
"data": {
"model": "gpt-4",
"messages": [
{"role": "system", "content": "Você é um assistente."},
{"role": "user", "content": "Resuma este artigo."}
{ "role": "system", "content": "Você é um assistente." },
{ "role": "user", "content": "Resuma este artigo." }
]
}
}
@@ -73,12 +75,13 @@ O CrewAI oferece suporte a eventos do sistema e eventos personalizados no Enterp
- `tool_usage_started`
- `tool_usage_completed`
- `crew_test_failed`
- *...e outros*
- _...e outros_
Os nomes dos eventos correspondem ao event bus interno. Veja o [código fonte no GitHub](https://github.com/crewAIInc/crewAI/tree/main/src/crewai/utilities/events) para a lista completa.
Você pode emitir seus próprios eventos personalizados, e eles serão entregues através do webhook stream juntamente com os eventos do sistema.
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência com integração de webhook ou solução de problemas.
Entre em contato com nossa equipe de suporte para assistência com integração
de webhook ou solução de problemas.
</Card>

97
docs/pt-BR/enterprise/guides/automation-triggers.mdx
View File

@@ -1,11 +1,11 @@
---
title: "Visão Geral de Triggers"
description: "Entenda como os triggers da CrewAI AOP funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração"
description: "Entenda como os triggers da CrewAI AMP funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração"
icon: "bolt"
mode: "wide"
---
Os triggers da CrewAI AOP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.
Os triggers da CrewAI AMP conectam suas automações a eventos em tempo real nas ferramentas que sua equipe já usa. Em vez de fazer polling ou depender de execuções manuais, os triggers escutam mudanças — novos e‑mails, atualizações de calendário, alterações no CRM — e iniciam imediatamente a crew ou flow que você definiu.
<iframe
className="w-full aspect-video rounded-xl"
@@ -25,37 +25,62 @@ Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:
<a href="/pt-BR/enterprise/guides/gmail-trigger">Dispare crews quando novos e‑mails chegarem ou threads forem atualizadas.</a>
</Card>
<Card title="Trigger do Google Calendar" icon="calendar-days">
<a href="/pt-BR/enterprise/guides/google-calendar-trigger">Reaja a eventos de calendário criados, atualizados ou cancelados.</a>
</Card>
{" "}
<Card title="Trigger do Google Calendar" icon="calendar-days">
<a href="/pt-BR/enterprise/guides/google-calendar-trigger">
Reaja a eventos de calendário criados, atualizados ou cancelados.
</a>
</Card>
<Card title="Trigger do Google Drive" icon="folder-open">
<a href="/pt-BR/enterprise/guides/google-drive-trigger">Monitore uploads, edições e exclusões de arquivos no Drive.</a>
</Card>
{" "}
<Card title="Trigger do Google Drive" icon="folder-open">
<a href="/pt-BR/enterprise/guides/google-drive-trigger">
Monitore uploads, edições e exclusões de arquivos no Drive.
</a>
</Card>
<Card title="Trigger do Outlook" icon="envelope-open">
<a href="/pt-BR/enterprise/guides/outlook-trigger">Automatize respostas a novos e‑mails ou eventos removidos no Outlook.</a>
</Card>
{" "}
<Card title="Trigger do Outlook" icon="envelope-open">
<a href="/pt-BR/enterprise/guides/outlook-trigger">
Automatize respostas a novos e‑mails ou eventos removidos no Outlook.
</a>
</Card>
<Card title="Trigger do OneDrive" icon="cloud">
<a href="/pt-BR/enterprise/guides/onedrive-trigger">Audite atividade e compartilhamentos de arquivos no OneDrive.</a>
</Card>
{" "}
<Card title="Trigger do OneDrive" icon="cloud">
<a href="/pt-BR/enterprise/guides/onedrive-trigger">
Audite atividade e compartilhamentos de arquivos no OneDrive.
</a>
</Card>
<Card title="Trigger do Microsoft Teams" icon="comments">
<a href="/pt-BR/enterprise/guides/microsoft-teams-trigger">Inicie workflows quando novos chats forem criados no Teams.</a>
</Card>
{" "}
<Card title="Trigger do Microsoft Teams" icon="comments">
<a href="/pt-BR/enterprise/guides/microsoft-teams-trigger">
Inicie workflows quando novos chats forem criados no Teams.
</a>
</Card>
<Card title="Trigger do HubSpot" icon="hubspot">
<a href="/pt-BR/enterprise/guides/hubspot-trigger">Execute automações a partir de workflows e eventos de ciclo de vida no HubSpot.</a>
</Card>
{" "}
<Card title="Trigger do HubSpot" icon="hubspot">
<a href="/pt-BR/enterprise/guides/hubspot-trigger">
Execute automações a partir de workflows e eventos de ciclo de vida no
HubSpot.
</a>
</Card>
<Card title="Trigger do Salesforce" icon="salesforce">
<a href="/pt-BR/enterprise/guides/salesforce-trigger">Conecte processos do Salesforce às suas crews para automação de CRM.</a>
</Card>
{" "}
<Card title="Trigger do Salesforce" icon="salesforce">
<a href="/pt-BR/enterprise/guides/salesforce-trigger">
Conecte processos do Salesforce às suas crews para automação de CRM.
</a>
</Card>
<Card title="Trigger do Slack" icon="slack">
<a href="/pt-BR/enterprise/guides/slack-trigger">Dispare crews diretamente de comandos slash no Slack.</a>
</Card>
{" "}
<Card title="Trigger do Slack" icon="slack">
<a href="/pt-BR/enterprise/guides/slack-trigger">
Dispare crews diretamente de comandos slash no Slack.
</a>
</Card>
<Card title="Trigger do Zapier" icon="bolt">
<a href="/pt-BR/enterprise/guides/zapier-trigger">Integre a CrewAI com milhares de apps suportados pelo Zapier.</a>
@@ -79,7 +104,10 @@ Com triggers você pode:
2. Clique na aba **Triggers** para listar todas as integrações disponíveis
<Frame>
<img src="/images/enterprise/list-available-triggers.png" alt="Lista de triggers disponíveis" />
<img
src="/images/enterprise/list-available-triggers.png"
alt="Lista de triggers disponíveis"
/>
</Frame>
### Habilitando e Desabilitando
@@ -87,7 +115,10 @@ Com triggers você pode:
Cada trigger possui uma chave de ativação:
<Frame>
<img src="/images/enterprise/trigger-selected.png" alt="Alternância de trigger habilitado" />
<img
src="/images/enterprise/trigger-selected.png"
alt="Alternância de trigger habilitado"
/>
</Frame>
- **Habilitado (azul)** – Executa a automação quando o evento ocorrer
@@ -100,7 +131,10 @@ As alterações são aplicadas imediatamente.
Use a lista de execuções para acompanhar histórico, status e payloads:
<Frame>
<img src="/images/enterprise/list-executions.png" alt="Lista de execuções acionadas por triggers" />
<img
src="/images/enterprise/list-executions.png"
alt="Lista de execuções acionadas por triggers"
/>
</Frame>
## Construindo Automações Orientadas por Trigger
@@ -129,6 +163,7 @@ crewai triggers list
```
Este comando exibe todos os triggers disponíveis baseados nas suas integrações conectadas, mostrando:
- Nome da integração e status de conexão
- Tipos de triggers disponíveis
- Nomes e descrições dos triggers
@@ -148,6 +183,7 @@ crewai triggers run microsoft_onedrive/file_changed
```
Este comando:
- Executa sua crew localmente
- Passa um payload de trigger completo e realista
- Simula exatamente como sua crew será chamada em produção
@@ -233,17 +269,20 @@ def delegar_para_crew(self, crewai_trigger_payload: dict = None):
## Solução de Problemas
**Trigger não dispara:**
- Verifique se o trigger está habilitado na aba Triggers do seu deployment
- Confira o status da conexão em Tools & Integrations
- Garanta que todas as variáveis de ambiente necessárias estão configuradas
**Falhas de execução:**
- Consulte os logs de execução para detalhes do erro
- Use `crewai triggers run <nome_do_trigger>` para testar localmente e ver a estrutura exata do payload
- Verifique se sua crew pode processar o parâmetro `crewai_trigger_payload`
- Garanta que sua crew não espera parâmetros que não estão incluídos no payload do trigger
**Problemas de desenvolvimento:**
- Sempre teste com `crewai triggers run <trigger>` antes de fazer deploy para ver o payload completo
- Lembre-se que `crewai run` NÃO simula chamadas de trigger—use `crewai triggers run` em vez disso
- Use `crewai triggers list` para verificar quais triggers estão disponíveis para suas integrações conectadas

6
docs/pt-BR/enterprise/guides/azure-openai-setup.mdx
View File

@@ -20,7 +20,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera
</Step>
<Step title="Configure a Conexão Enterprise do CrewAI">
4. Em outra aba, abra `CrewAI AOP > LLM Connections`. Dê um nome à sua LLM Connection, selecione Azure como provedor e escolha o mesmo modelo que você selecionou no Azure.
4. Em outra aba, abra `CrewAI AMP > LLM Connections`. Dê um nome à sua LLM Connection, selecione Azure como provedor e escolha o mesmo modelo que você selecionou no Azure.
5. Na mesma página, adicione as variáveis de ambiente do passo 3:
- Uma chamada `AZURE_DEPLOYMENT_TARGET_URL` (usando o Target URI). A URL deve ser parecida com: https://your-deployment.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview
- Outra chamada `AZURE_API_KEY` (usando a Key).
@@ -28,7 +28,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera
</Step>
<Step title="Defina Configurações Padrão">
7. Em `CrewAI AOP > Settings > Defaults > Crew Studio LLM Settings`, defina a nova LLM Connection e o modelo como padrão.
7. Em `CrewAI AMP > Settings > Defaults > Crew Studio LLM Settings`, defina a nova LLM Connection e o modelo como padrão.
</Step>
<Step title="Configure o Acesso à Rede">
@@ -37,6 +37,7 @@ Este guia orienta você na conexão do Azure OpenAI com o Crew Studio para opera
- Navegue até `Resource Management > Networking`.
- Certifique-se de que a opção `Allow access from all networks` está habilitada. Se essa configuração estiver restrita, o CrewAI pode ser impedido de acessar seu endpoint do Azure OpenAI.
</Step>
</Steps>
## Verificação
@@ -46,6 +47,7 @@ Tudo pronto! O Crew Studio agora utilizará sua conexão Azure OpenAI. Teste a c
## Solução de Problemas
Se você encontrar problemas:
- Verifique se o formato do Target URI corresponde ao padrão esperado
- Confira se a API key está correta e com as permissões adequadas
- Certifique-se de que o acesso à rede está configurado para permitir conexões do CrewAI

18
docs/pt-BR/enterprise/guides/build-crew.mdx
View File

@@ -7,7 +7,7 @@ mode: "wide"
## Visão Geral
[CrewAI AOP](https://app.crewai.com) simplifica o processo de **criação**, **implantação** e **gerenciamento** dos seus agentes de IA em ambientes de produção.
[CrewAI AMP](https://app.crewai.com) simplifica o processo de **criação**, **implantação** e **gerenciamento** dos seus agentes de IA em ambientes de produção.
## Primeiros Passos
@@ -23,20 +23,26 @@ mode: "wide"
### Instalação e Configuração
<Card title="Siga a Instalação Padrão" icon="wrench" href="/pt-BR/installation">
Siga nosso guia de instalação padrão para configurar o CrewAI CLI e criar seu primeiro projeto.
Siga nosso guia de instalação padrão para configurar o CrewAI CLI e criar seu
primeiro projeto.
</Card>
### Construindo Sua Crew
<Card title="Tutorial Rápido" icon="rocket" href="/pt-BR/quickstart">
Siga nosso tutorial rápido para criar sua primeira crew de agentes usando a configuração YAML.
Siga nosso tutorial rápido para criar sua primeira crew de agentes usando a
configuração YAML.
</Card>
## Suporte e Recursos
Para suporte ou dúvidas específicas da versão Enterprise, entre em contato com nossa equipe dedicada através do [support@crewai.com](mailto:support@crewai.com).
<Card title="Agende uma Demonstração" icon="calendar" href="mailto:support@crewai.com">
Reserve um horário com nossa equipe para saber mais sobre os recursos Enterprise e como eles podem beneficiar sua organização.
<Card
title="Agende uma Demonstração"
icon="calendar"
href="mailto:support@crewai.com"
>
Reserve um horário com nossa equipe para saber mais sobre os recursos
Enterprise e como eles podem beneficiar sua organização.
</Card>

61
docs/pt-BR/enterprise/guides/deploy-crew.mdx
View File

@@ -1,12 +1,15 @@
---
title: "Deploy Crew"
description: "Implantando um Crew na CrewAI AOP"
description: "Implantando um Crew na CrewAI AMP"
icon: "rocket"
mode: "wide"
---
<Note>
Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é implantá-lo na plataforma CrewAI AOP. Este guia cobre múltiplos métodos de implantação para ajudá-lo a escolher a melhor abordagem para o seu fluxo de trabalho.
Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é
implantá-lo na plataforma CrewAI AMP. Este guia cobre múltiplos métodos de
implantação para ajudá-lo a escolher a melhor abordagem para o seu fluxo de
trabalho.
</Note>
## Pré-requisitos
@@ -16,7 +19,8 @@ Depois de criar um crew localmente ou pelo Crew Studio, o próximo passo é impl
Você deve ter um crew funcional, criado localmente ou pelo Crew Studio
</Card>
<Card title="Repositório GitHub" icon="github">
O código do seu crew deve estar em um repositório do GitHub (para o método de integração com GitHub)
O código do seu crew deve estar em um repositório do GitHub (para o método
de integração com GitHub)
</Card>
</CardGroup>
@@ -39,10 +43,10 @@ A CLI fornece a maneira mais rápida de implantar crews desenvolvidos localmente
</Step>
<Step title="Autentique-se na Plataforma Enterprise">
Primeiro, você precisa autenticar sua CLI com a plataforma CrewAI AOP:
Primeiro, você precisa autenticar sua CLI com a plataforma CrewAI AMP:
```bash
# Se já possui uma conta CrewAI AOP, ou deseja criar uma:
# Se já possui uma conta CrewAI AMP, ou deseja criar uma:
crewai login
```
@@ -105,38 +109,38 @@ A CLI fornece a maneira mais rápida de implantar crews desenvolvidos localmente
O CrewAI CLI oferece vários comandos para gerenciar suas implantações:
```bash
# Liste todas as suas implantações
crewai deploy list
```bash
# Liste todas as suas implantações
crewai deploy list
# Consulte o status de uma implantação
crewai deploy status
# Consulte o status de uma implantação
crewai deploy status
# Veja os logs da implantação
crewai deploy logs
# Veja os logs da implantação
crewai deploy logs
# Envie atualizações após alterações no código
crewai deploy push
# Envie atualizações após alterações no código
crewai deploy push
# Remova uma implantação
crewai deploy remove <deployment_id>
```
# Remova uma implantação
crewai deploy remove <deployment_id>
```
## Opção 2: Implantar Diretamente pela Interface Web
Você também pode implantar seus crews diretamente pela interface web da CrewAI AOP conectando sua conta do GitHub. Esta abordagem não requer utilizar a CLI na sua máquina local.
Você também pode implantar seus crews diretamente pela interface web da CrewAI AMP conectando sua conta do GitHub. Esta abordagem não requer utilizar a CLI na sua máquina local.
<Steps>
<Step title="Enviar no GitHub">
Você precisa subir seu crew para um repositório do GitHub. Caso ainda não tenha criado um crew, você pode [seguir este tutorial](/pt-BR/quickstart).
Você precisa subir seu crew para um repositório do GitHub. Caso ainda não tenha criado um crew, você pode [seguir este tutorial](/pt-BR/quickstart).
</Step>
<Step title="Conectando o GitHub ao CrewAI AOP">
<Step title="Conectando o GitHub ao CrewAI AMP">
1. Faça login em [CrewAI AOP](https://app.crewai.com)
1. Faça login em [CrewAI AMP](https://app.crewai.com)
2. Clique no botão "Connect GitHub"
<Frame>
@@ -190,7 +194,9 @@ Você também pode implantar seus crews diretamente pela interface web da CrewAI
## ⚠️ Requisitos de Segurança para Variáveis de Ambiente
<Warning>
**Importante**: A CrewAI AOP possui restrições de segurança sobre os nomes de variáveis de ambiente que podem causar falha na implantação caso não sejam seguidas.
**Importante**: A CrewAI AMP possui restrições de segurança sobre os nomes de
variáveis de ambiente que podem causar falha na implantação caso não sejam
seguidas.
</Warning>
### Padrões de Variáveis de Ambiente Bloqueados
@@ -198,12 +204,14 @@ Você também pode implantar seus crews diretamente pela interface web da CrewAI
Por motivos de segurança, os seguintes padrões de nome de variável de ambiente são **automaticamente filtrados** e causarão problemas de implantação:
**Padrões Bloqueados:**
- Variáveis terminando em `_TOKEN` (ex: `MY_API_TOKEN`)
- Variáveis terminando em `_PASSWORD` (ex: `DB_PASSWORD`)
- Variáveis terminando em `_SECRET` (ex: `API_SECRET`)
- Variáveis terminando em `_KEY` em certos contextos
**Variáveis Bloqueadas Específicas:**
- `GITHUB_USER`, `GITHUB_TOKEN`
- `AWS_REGION`, `AWS_DEFAULT_REGION`
- Diversas variáveis internas do sistema CrewAI
@@ -211,6 +219,7 @@ Por motivos de segurança, os seguintes padrões de nome de variável de ambient
### Exceções Permitidas
Algumas variáveis são explicitamente permitidas mesmo coincidindo com os padrões bloqueados:
- `AZURE_AD_TOKEN`
- `AZURE_OPENAI_AD_TOKEN`
- `ENTERPRISE_ACTION_TOKEN`
@@ -240,7 +249,9 @@ API_CONFIG=segredo123
4. **Documente as mudanças**: Mantenha registro das variáveis renomeadas para seu time
<Tip>
Se você se deparar com falhas de implantação com erros enigmáticos de variáveis de ambiente, confira primeiro os nomes das variáveis em relação a esses padrões.
Se você se deparar com falhas de implantação com erros enigmáticos de
variáveis de ambiente, confira primeiro os nomes das variáveis em relação a
esses padrões.
</Tip>
### Interaja com Seu Crew Implantado
@@ -248,6 +259,7 @@ Se você se deparar com falhas de implantação com erros enigmáticos de variá
Após a implantação, você pode acessar seu crew por meio de:
1. **REST API**: A plataforma gera um endpoint HTTPS exclusivo com estas rotas principais:
- `/inputs`: Lista os parâmetros de entrada requeridos
- `/kickoff`: Inicia uma execução com os inputs fornecidos
- `/status/{kickoff_id}`: Consulta o status da execução
@@ -287,5 +299,6 @@ A plataforma Enterprise também oferece:
- **Crew Studio**: Monte crews via interface de chat sem escrever código
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para ajuda com questões de implantação ou dúvidas sobre a plataforma Enterprise.
Entre em contato com nossa equipe de suporte para ajuda com questões de
implantação ou dúvidas sobre a plataforma Enterprise.
</Card>

50
docs/pt-BR/enterprise/guides/enable-crew-studio.mdx
View File

@@ -1,12 +1,13 @@
---
title: "Ativar Crew Studio"
description: "Ativando o Crew Studio no CrewAI AOP"
description: "Ativando o Crew Studio no CrewAI AMP"
icon: "comments"
mode: "wide"
---
<Tip>
Crew Studio é uma poderosa ferramenta **no-code/low-code** que permite criar ou estruturar Crews rapidamente por meio de uma interface conversacional.
Crew Studio é uma poderosa ferramenta **no-code/low-code** que permite criar
ou estruturar Crews rapidamente por meio de uma interface conversacional.
</Tip>
## O que é o Crew Studio?
@@ -24,7 +25,7 @@ Com o Crew Studio, você pode:
- Selecionar as ferramentas apropriadas
- Configurar os inputs necessários
- Gerar código para download e personalização
- Fazer deploy diretamente na plataforma CrewAI AOP
- Fazer deploy diretamente na plataforma CrewAI AMP
## Etapas de Configuração
@@ -32,7 +33,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões
<Steps>
<Step title="Configurar a Conexão LLM">
Acesse a aba **LLM Connections** no painel do CrewAI AOP e crie uma nova conexão LLM.
Acesse a aba **LLM Connections** no painel do CrewAI AMP e crie uma nova conexão LLM.
<Note>
Sinta-se à vontade para utilizar qualquer provedor LLM suportado pelo CrewAI.
@@ -52,6 +53,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões
<Frame>
![LLM Connection Configuration](/images/enterprise/llm-connection-config.png)
</Frame>
</Step>
<Step title="Verificar Conexão Adicionada">
@@ -60,6 +62,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões
<Frame>
![Connection Added](/images/enterprise/connection-added.png)
</Frame>
</Step>
<Step title="Configurar Padrões do LLM">
@@ -73,6 +76,7 @@ Antes de começar a usar o Crew Studio, você precisa configurar suas conexões
<Frame>
![LLM Defaults Configuration](/images/enterprise/llm-defaults.png)
</Frame>
</Step>
</Steps>
@@ -82,7 +86,7 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com
<Steps>
<Step title="Acessar o Studio">
Navegue até a seção **Studio** no painel do CrewAI AOP.
Navegue até a seção **Studio** no painel do CrewAI AMP.
</Step>
<Step title="Iniciar uma Conversa">
@@ -93,6 +97,7 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com
```
O Crew Assistant fará perguntas de esclarecimento para entender melhor suas necessidades.
</Step>
<Step title="Revisar o Crew Gerado">
@@ -104,14 +109,16 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com
- Ferramentas a serem utilizadas
Esta é sua oportunidade para refinar a configuração antes de prosseguir.
</Step>
<Step title="Fazer Deploy ou Baixar">
Quando estiver satisfeito com a configuração, você pode:
- Baixar o código gerado para personalização local
- Fazer deploy do crew diretamente na plataforma CrewAI AOP
- Fazer deploy do crew diretamente na plataforma CrewAI AMP
- Modificar a configuração e gerar o crew novamente
</Step>
<Step title="Testar seu Crew">
@@ -120,7 +127,9 @@ Agora que você configurou sua conexão LLM e os padrões, está pronto para com
</Steps>
<Tip>
Para melhores resultados, forneça descrições claras e detalhadas do que deseja que seu crew realize. Inclua inputs específicos e outputs esperados em sua descrição.
Para melhores resultados, forneça descrições claras e detalhadas do que deseja
que seu crew realize. Inclua inputs específicos e outputs esperados em sua
descrição.
</Tip>
## Exemplo de Fluxo de Trabalho
@@ -134,11 +143,14 @@ Veja um fluxo de trabalho típico para criação de um crew com o Crew Studio:
```md
I need a crew that can analyze financial news and provide investment recommendations
```
</Step>
<Step title="Responder Perguntas">
Responda às perguntas de esclarecimento do Crew Assistant para refinar seus requisitos.
</Step>
{" "}
<Step title="Responder Perguntas">
Responda às perguntas de esclarecimento do Crew Assistant para refinar seus
requisitos.
</Step>
<Step title="Revisar o Plano">
Revise o plano do crew gerado, que pode incluir:
@@ -146,15 +158,18 @@ Veja um fluxo de trabalho típico para criação de um crew com o Crew Studio:
- Um Research Agent para coletar notícias financeiras
- Um Analysis Agent para interpretar os dados
- Um Recommendations Agent para fornecer conselhos de investimento
</Step>
<Step title="Aprovar ou Modificar">
Aprove o plano ou solicite alterações, se necessário.
</Step>
{" "}
<Step title="Aprovar ou Modificar">
Aprove o plano ou solicite alterações, se necessário.
</Step>
<Step title="Baixar ou Fazer Deploy">
Baixe o código para personalização ou faça o deploy diretamente na plataforma.
</Step>
{" "}
<Step title="Baixar ou Fazer Deploy">
Baixe o código para personalização ou faça o deploy diretamente na plataforma.
</Step>
<Step title="Testar e Refinar">
Teste seu crew com inputs de exemplo e faça ajustes conforme necessário.
@@ -162,5 +177,6 @@ Veja um fluxo de trabalho típico para criação de um crew com o Crew Studio:
</Steps>
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para obter assistência com o Crew Studio ou qualquer outro recurso do CrewAI AOP.
Entre em contato com nossa equipe de suporte para obter assistência com o Crew
Studio ou qualquer outro recurso do CrewAI AMP.
</Card>

19
docs/pt-BR/enterprise/guides/gmail-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.
<Tip>
Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.
Make sure Gmail is connected in Tools & Integrations and the trigger is
enabled for your deployment.
</Tip>
## Enabling the Gmail Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Gmail** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/trigger-selected.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/trigger-selected.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Process new emails
@@ -68,7 +72,9 @@ crewai triggers run gmail/new_email_received
O comando `crewai triggers run` executará sua crew com um payload completo do Gmail, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run gmail/new_email_received` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run gmail/new_email_received` (não `crewai run`) para
simular execução de trigger durante o desenvolvimento. Após o deployment, sua
crew receberá automaticamente o payload do trigger.
</Warning>
## Monitoring Executions
@@ -76,7 +82,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do G
Track history and performance of triggered runs:
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

19
docs/pt-BR/enterprise/guides/google-calendar-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Google Calendar trigger to launch automations whenever calendar events change. Common use cases include briefing a team before a meeting, notifying stakeholders when a critical event is cancelled, or summarizing daily schedules.
<Tip>
Make sure Google Calendar is connected in **Tools & Integrations** and enabled for the deployment you want to automate.
Make sure Google Calendar is connected in **Tools & Integrations** and enabled
for the deployment you want to automate.
</Tip>
## Enabling the Google Calendar Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Google Calendar** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/calendar-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/calendar-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize meeting details
@@ -54,7 +58,9 @@ crewai triggers run google_calendar/event_changed
O comando `crewai triggers run` executará sua crew com um payload completo do Calendar, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run google_calendar/event_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run google_calendar/event_changed` (não `crewai run`)
para simular execução de trigger durante o desenvolvimento. Após o deployment,
sua crew receberá automaticamente o payload do trigger.
</Warning>
## Monitoring Executions
@@ -62,7 +68,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do C
The **Executions** list in the deployment dashboard tracks every triggered run and surfaces payload metadata, output summaries, and errors.
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

19
docs/pt-BR/enterprise/guides/google-drive-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Trigger your automations when files are created, updated, or removed in Google Drive. Typical workflows include summarizing newly uploaded content, enforcing sharing policies, or notifying owners when critical files change.
<Tip>
Connect Google Drive in **Tools & Integrations** and confirm the trigger is enabled for the automation you want to monitor.
Connect Google Drive in **Tools & Integrations** and confirm the trigger is
enabled for the automation you want to monitor.
</Tip>
## Enabling the Google Drive Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Google Drive** and switch the toggle to enable
<Frame>
<img src="/images/enterprise/gdrive-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/gdrive-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize file activity
@@ -51,7 +55,9 @@ crewai triggers run google_drive/file_changed
O comando `crewai triggers run` executará sua crew com um payload completo do Drive, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run google_drive/file_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run google_drive/file_changed` (não `crewai run`) para
simular execução de trigger durante o desenvolvimento. Após o deployment, sua
crew receberá automaticamente o payload do trigger.
</Warning>
## Monitoring Executions
@@ -59,7 +65,10 @@ O comando `crewai triggers run` executará sua crew com um payload completo do D
Track history and performance of triggered runs with the **Executions** list in the deployment dashboard.
<Frame>
<img src="/images/enterprise/list-executions.png" alt="List of executions triggered by automation" />
<img
src="/images/enterprise/list-executions.png"
alt="List of executions triggered by automation"
/>
</Frame>
## Troubleshooting

79
docs/pt-BR/enterprise/guides/hubspot-trigger.mdx
View File

@@ -5,48 +5,59 @@ icon: "hubspot"
mode: "wide"
---
Este guia fornece um processo passo a passo para configurar gatilhos do HubSpot para o CrewAI AOP, permitindo iniciar crews diretamente a partir de Workflows do HubSpot.
Este guia fornece um processo passo a passo para configurar gatilhos do HubSpot para o CrewAI AMP, permitindo iniciar crews diretamente a partir de Workflows do HubSpot.
## Pré-requisitos
- Uma conta CrewAI AOP
- Uma conta CrewAI AMP
- Uma conta HubSpot com o recurso de [Workflows do HubSpot](https://knowledge.hubspot.com/workflows/create-workflows)
## Etapas de Configuração
<Steps>
<Step title="Conecte sua conta HubSpot com o CrewAI AOP">
- Faça login na sua `Conta CrewAI AOP > Triggers`
- Selecione `HubSpot` na lista de gatilhos disponíveis
- Escolha a conta HubSpot que deseja conectar ao CrewAI AOP
- Siga as instruções na tela para autorizar o acesso do CrewAI AOP à sua conta HubSpot
- Uma mensagem de confirmação aparecerá assim que o HubSpot estiver conectado com sucesso ao CrewAI AOP
</Step>
<Step title="Crie um Workflow no HubSpot">
- Faça login na sua `Conta HubSpot > Automations > Workflows > New workflow`
- Selecione o tipo de workflow que atende às suas necessidades (por exemplo, Começar do zero)
- No construtor de workflow, clique no ícone de mais (+) para adicionar uma nova ação.
- Escolha `Integrated apps > CrewAI > Kickoff a Crew`.
- Selecione a Crew que deseja iniciar.
- Clique em `Save` para adicionar a ação ao seu workflow
<Frame>
<img src="/images/enterprise/hubspot-workflow-1.png" alt="HubSpot Workflow 1" />
</Frame>
</Step>
<Step title="Use os resultados da Crew com outras ações">
- Após a etapa Kickoff a Crew, clique no ícone de mais (+) para adicionar uma nova ação.
- Por exemplo, para enviar uma notificação de e-mail interna, escolha `Communications > Send internal email notification`
- No campo Body, clique em `Insert data`, selecione `View properties or action outputs from > Action outputs > Crew Result` para incluir dados da Crew no e-mail
<Frame>
<img src="/images/enterprise/hubspot-workflow-2.png" alt="HubSpot Workflow 2" />
</Frame>
- Configure quaisquer ações adicionais necessárias
- Revise as etapas do seu workflow para garantir que tudo está configurado corretamente
- Ative o workflow
<Frame>
<img src="/images/enterprise/hubspot-workflow-3.png" alt="HubSpot Workflow 3" />
</Frame>
</Step>
<Step title="Conecte sua conta HubSpot com o CrewAI AMP">
- Faça login na sua `Conta CrewAI AMP > Triggers` - Selecione `HubSpot` na
lista de gatilhos disponíveis - Escolha a conta HubSpot que deseja conectar
ao CrewAI AMP - Siga as instruções na tela para autorizar o acesso do CrewAI
AMP à sua conta HubSpot - Uma mensagem de confirmação aparecerá assim que o
HubSpot estiver conectado com sucesso ao CrewAI AMP
</Step>
<Step title="Crie um Workflow no HubSpot">
- Faça login na sua `Conta HubSpot > Automations > Workflows > New workflow`
- Selecione o tipo de workflow que atende às suas necessidades (por exemplo,
Começar do zero) - No construtor de workflow, clique no ícone de mais (+)
para adicionar uma nova ação. - Escolha `Integrated apps > CrewAI > Kickoff
a Crew`. - Selecione a Crew que deseja iniciar. - Clique em `Save` para
adicionar a ação ao seu workflow
<Frame>
<img
src="/images/enterprise/hubspot-workflow-1.png"
alt="HubSpot Workflow 1"
/>
</Frame>
</Step>
<Step title="Use os resultados da Crew com outras ações">
- Após a etapa Kickoff a Crew, clique no ícone de mais (+) para adicionar
uma nova ação. - Por exemplo, para enviar uma notificação de e-mail interna,
escolha `Communications > Send internal email notification` - No campo Body,
clique em `Insert data`, selecione `View properties or action outputs from >
Action outputs > Crew Result` para incluir dados da Crew no e-mail
<Frame>
<img
src="/images/enterprise/hubspot-workflow-2.png"
alt="HubSpot Workflow 2"
/>
</Frame>
- Configure quaisquer ações adicionais necessárias - Revise as
etapas do seu workflow para garantir que tudo está configurado corretamente
- Ative o workflow
<Frame>
<img
src="/images/enterprise/hubspot-workflow-3.png"
alt="HubSpot Workflow 3"
/>
</Frame>
</Step>
</Steps>
## Recursos Adicionais

36
docs/pt-BR/enterprise/guides/kickoff-crew.mdx
View File

@@ -1,25 +1,23 @@
---
title: "Kickoff Crew"
description: "Inicie um Crew no CrewAI AOP"
description: "Inicie um Crew no CrewAI AMP"
icon: "flag-checkered"
mode: "wide"
---
## Visão Geral
Uma vez que você tenha implantado seu crew na plataforma CrewAI AOP, é possível iniciar execuções pela interface web ou pela API. Este guia aborda ambos os métodos.
Uma vez que você tenha implantado seu crew na plataforma CrewAI AMP, é possível iniciar execuções pela interface web ou pela API. Este guia aborda ambos os métodos.
## Método 1: Usando a Interface Web
### Passo 1: Navegue até seu Crew Implantado
1. Faça login no [CrewAI AOP](https://app.crewai.com)
1. Faça login no [CrewAI AMP](https://app.crewai.com)
2. Clique no nome do crew na sua lista de projetos
3. Você será direcionado para a página de detalhes do crew
<Frame>
![Crew Dashboard](/images/enterprise/crew-dashboard.png)
</Frame>
<Frame>![Crew Dashboard](/images/enterprise/crew-dashboard.png)</Frame>
### Passo 2: Iniciar Execução
@@ -31,9 +29,7 @@ Na página de detalhes do seu crew, você tem duas opções para iniciar uma exe
2. Insira os parâmetros de entrada necessários para seu crew no editor JSON
3. Clique no botão `Send Request`
<Frame>
![Kickoff Endpoint](/images/enterprise/kickoff-endpoint.png)
</Frame>
<Frame>![Kickoff Endpoint](/images/enterprise/kickoff-endpoint.png)</Frame>
#### Opção B: Usando a Interface Visual
@@ -41,9 +37,7 @@ Na página de detalhes do seu crew, você tem duas opções para iniciar uma exe
2. Insira os inputs necessários nos campos do formulário
3. Clique no botão `Run Crew`
<Frame>
![Run Crew](/images/enterprise/run-crew.png)
</Frame>
<Frame>![Run Crew](/images/enterprise/run-crew.png)</Frame>
### Passo 3: Monitorar o Progresso da Execução
@@ -52,9 +46,7 @@ Após iniciar a execução:
1. Você receberá uma resposta contendo um `kickoff_id` - **copie este ID**
2. Esse ID é fundamental para o acompanhamento da sua execução
<Frame>
![Copy Task ID](/images/enterprise/copy-task-id.png)
</Frame>
<Frame>![Copy Task ID](/images/enterprise/copy-task-id.png)</Frame>
### Passo 4: Verificar o Status da Execução
@@ -64,11 +56,10 @@ Para monitorar o andamento da sua execução:
2. Cole o `kickoff_id` no campo indicado
3. Clique no botão "Get Status"
<Frame>
![Get Status](/images/enterprise/get-status.png)
</Frame>
<Frame>![Get Status](/images/enterprise/get-status.png)</Frame>
A resposta de status mostrará:
- Estado atual da execução (`running`, `completed`, etc.)
- Detalhes sobre quais tarefas estão em andamento
- Quaisquer outputs gerados até o momento
@@ -83,7 +74,7 @@ Quando a execução for concluída:
## Método 2: Usando a API
Você também pode iniciar crews programaticamente usando a REST API do CrewAI AOP.
Você também pode iniciar crews programaticamente usando a REST API do CrewAI AMP.
### Autenticação
@@ -122,7 +113,7 @@ curl -X GET \
A resposta será um objeto JSON contendo um array de parâmetros de entrada obrigatórios, por exemplo:
```json
{"inputs":["topic","current_year"]}
{ "inputs": ["topic", "current_year"] }
```
Este exemplo mostra que este crew em particular requer dois inputs: `topic` e `current_year`.
@@ -142,7 +133,7 @@ curl -X POST \
A resposta incluirá um `kickoff_id` que você precisará para o acompanhamento:
```json
{"kickoff_id":"abcd1234-5678-90ef-ghij-klmnopqrstuv"}
{ "kickoff_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv" }
```
### Passo 3: Verificar Status da Execução
@@ -182,5 +173,6 @@ Se uma execução falhar:
3. Procure por respostas LLM e uso de ferramentas nos detalhes do trace
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para obter ajuda com problemas de execução ou dúvidas sobre a plataforma Enterprise.
Entre em contato com nossa equipe de suporte para obter ajuda com problemas de
execução ou dúvidas sobre a plataforma Enterprise.
</Card>

14
docs/pt-BR/enterprise/guides/microsoft-teams-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Use the Microsoft Teams trigger to start automations whenever a new chat is created. Common patterns include summarizing inbound requests, routing urgent messages to support teams, or creating follow-up tasks in other systems.
<Tip>
Confirm Microsoft Teams is connected under **Tools & Integrations** and enabled in the **Triggers** tab for your deployment.
Confirm Microsoft Teams is connected under **Tools & Integrations** and
enabled in the **Triggers** tab for your deployment.
</Tip>
## Enabling the Microsoft Teams Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Microsoft Teams** and switch the toggle to enable
<Frame caption="Microsoft Teams trigger connection">
<img src="/images/enterprise/msteams-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/msteams-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize a new chat thread
@@ -52,7 +56,9 @@ crewai triggers run microsoft_teams/teams_message_created
O comando `crewai triggers run` executará sua crew com um payload completo do Teams, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run microsoft_teams/teams_message_created` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run microsoft_teams/teams_message_created` (não `crewai
run`) para simular execução de trigger durante o desenvolvimento. Após o
deployment, sua crew receberá automaticamente o payload do trigger.
</Warning>
## Troubleshooting

14
docs/pt-BR/enterprise/guides/onedrive-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.
<Tip>
Connect OneDrive in **Tools & Integrations** and toggle the trigger on for your deployment.
Connect OneDrive in **Tools & Integrations** and toggle the trigger on for
your deployment.
</Tip>
## Enabling the OneDrive Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **OneDrive** and switch the toggle to enable
<Frame caption="Microsoft OneDrive trigger connection">
<img src="/images/enterprise/onedrive-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/onedrive-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Audit file permissions
@@ -51,7 +55,9 @@ crewai triggers run microsoft_onedrive/file_changed
O comando `crewai triggers run` executará sua crew com um payload completo do OneDrive, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run microsoft_onedrive/file_changed` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run microsoft_onedrive/file_changed` (não `crewai run`)
para simular execução de trigger durante o desenvolvimento. Após o deployment,
sua crew receberá automaticamente o payload do trigger.
</Warning>
## Troubleshooting

14
docs/pt-BR/enterprise/guides/outlook-trigger.mdx
View File

@@ -10,17 +10,21 @@ mode: "wide"
Automate responses when Outlook delivers a new message or when an event is removed from the calendar. Teams commonly route escalations, file tickets, or alert attendees of cancellations.
<Tip>
Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled for your deployment.
Connect Outlook in **Tools & Integrations** and ensure the trigger is enabled
for your deployment.
</Tip>
## Enabling the Outlook Trigger
1. Open your deployment in CrewAI AOP
1. Open your deployment in CrewAI AMP
2. Go to the **Triggers** tab
3. Locate **Outlook** and switch the toggle to enable
<Frame caption="Microsoft Outlook trigger connection">
<img src="/images/enterprise/outlook-trigger.png" alt="Enable or disable triggers with toggle" />
<img
src="/images/enterprise/outlook-trigger.png"
alt="Enable or disable triggers with toggle"
/>
</Frame>
## Example: Summarize a new email
@@ -51,7 +55,9 @@ crewai triggers run microsoft_outlook/email_received
O comando `crewai triggers run` executará sua crew com um payload completo do Outlook, permitindo que você teste sua lógica de parsing antes do deployment.
<Warning>
Use `crewai triggers run microsoft_outlook/email_received` (não `crewai run`) para simular execução de trigger durante o desenvolvimento. Após o deployment, sua crew receberá automaticamente o payload do trigger.
Use `crewai triggers run microsoft_outlook/email_received` (não `crewai run`)
para simular execução de trigger durante o desenvolvimento. Após o deployment,
sua crew receberá automaticamente o payload do trigger.
</Warning>
## Troubleshooting

16
docs/pt-BR/enterprise/guides/react-component-export.mdx
View File

@@ -1,11 +1,11 @@
---
title: "Exportação de Componentes React"
description: "Aprenda como exportar e integrar componentes React do CrewAI AOP em suas aplicações"
description: "Aprenda como exportar e integrar componentes React do CrewAI AMP em suas aplicações"
icon: "react"
mode: "wide"
---
Este guia explica como exportar crews do CrewAI AOP como componentes React e integrá-los às suas próprias aplicações.
Este guia explica como exportar crews do CrewAI AMP como componentes React e integrá-los às suas próprias aplicações.
## Exportando um Componente React
@@ -17,6 +17,7 @@ Este guia explica como exportar crews do CrewAI AOP como componentes React e int
<img src="/images/enterprise/export-react-component.png" alt="Exportar Componente React" />
</Frame>
</Step>
</Steps>
## Configurando seu Ambiente React
@@ -83,6 +84,7 @@ Para executar este componente React localmente, você precisará configurar um a
```
- Isso iniciará o servidor de desenvolvimento, e seu navegador padrão será aberto automaticamente em http://localhost:3000, onde você verá sua aplicação React rodando.
</Step>
</Steps>
## Personalização
@@ -90,10 +92,16 @@ Para executar este componente React localmente, você precisará configurar um a
Você pode então personalizar o `CrewLead.jsx` para adicionar cor, título etc.
<Frame>
<img src="/images/enterprise/customise-react-component.png" alt="Personalizar Componente React" />
<img
src="/images/enterprise/customise-react-component.png"
alt="Personalizar Componente React"
/>
</Frame>
<Frame>
<img src="/images/enterprise/customise-react-component-2.png" alt="Personalizar Componente React" />
<img
src="/images/enterprise/customise-react-component-2.png"
alt="Personalizar Componente React"
/>
</Frame>
## Próximos Passos

6
docs/pt-BR/enterprise/guides/salesforce-trigger.mdx
View File

@@ -5,7 +5,7 @@ icon: "salesforce"
mode: "wide"
---
A CrewAI AOP pode ser acionada a partir do Salesforce para automatizar fluxos de trabalho de gestão de relacionamento com o cliente e aprimorar suas operações de vendas.
A CrewAI AMP pode ser acionada a partir do Salesforce para automatizar fluxos de trabalho de gestão de relacionamento com o cliente e aprimorar suas operações de vendas.
## Visão Geral
@@ -31,7 +31,7 @@ O Salesforce é uma das principais plataformas de gestão de relacionamento com
Para configurar triggers no Salesforce:
1. **Contato com o Suporte**: Entre em contato com o suporte da CrewAI AOP para obter assistência na configuração dos triggers no Salesforce
1. **Contato com o Suporte**: Entre em contato com o suporte da CrewAI AMP para obter assistência na configuração dos triggers no Salesforce
2. **Revisar Requisitos**: Certifique-se de possuir as permissões necessárias no Salesforce e acesso à API
3. **Configurar Conexão**: Trabalhe com a equipe de suporte para estabelecer a conexão entre a CrewAI e sua instância do Salesforce
4. **Testar Triggers**: Verifique se os triggers funcionam corretamente para os seus casos de uso específicos
@@ -47,4 +47,4 @@ Cenários comuns de uso de triggers Salesforce + CrewAI incluem:
## Próximos Passos
Para instruções detalhadas de configuração e opções avançadas, entre em contato com o suporte da CrewAI AOP, que pode fornecer orientações personalizadas para o seu ambiente Salesforce e necessidades de negócio.
Para instruções detalhadas de configuração e opções avançadas, entre em contato com o suporte da CrewAI AMP, que pode fornecer orientações personalizadas para o seu ambiente Salesforce e necessidades de negócio.

142
docs/pt-BR/enterprise/guides/team-management.mdx
View File

@@ -1,40 +1,44 @@
---
title: "Gestão de Equipes"
description: "Aprenda como convidar e gerenciar membros da equipe em sua organização CrewAI AOP"
description: "Aprenda como convidar e gerenciar membros da equipe em sua organização CrewAI AMP"
icon: "users"
mode: "wide"
---
Como administrador de uma conta CrewAI AOP, você pode facilmente convidar novos membros para sua organização. Este guia irá orientá-lo passo a passo pelo processo.
Como administrador de uma conta CrewAI AMP, você pode facilmente convidar novos membros para sua organização. Este guia irá orientá-lo passo a passo pelo processo.
## Convidando Membros da Equipe
<Steps>
<Step title="Acesse a Página de Configurações">
- Faça login na sua conta CrewAI AOP
- Procure o ícone de engrenagem (⚙️) no canto superior direito do painel
- Clique no ícone de engrenagem para acessar a página de **Configurações**:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="Página de Configurações" />
</Frame>
</Step>
<Step title="Navegue até a Seção de Membros">
- Na página de Configurações, você verá a aba `Members`
- Clique na aba `Members` para acessar a página de **Membros**:
<Frame>
<img src="/images/enterprise/members-tab.png" alt="Aba Membros" />
</Frame>
</Step>
<Step title="Convidar Novos Membros">
- Na seção de Membros, você verá uma lista dos membros atuais (incluindo você)
- Localize o campo de entrada `Email`
- Digite o endereço de e-mail da pessoa que você deseja convidar
- Clique no botão `Invite` para enviar o convite
</Step>
<Step title="Repita Conforme Necessário">
- Você pode repetir esse processo para convidar vários membros da equipe
- Cada membro convidado receberá um convite por e-mail para ingressar na sua organização
</Step>
<Step title="Acesse a Página de Configurações">
- Faça login na sua conta CrewAI AMP - Procure o ícone de engrenagem (⚙️) no
canto superior direito do painel - Clique no ícone de engrenagem para
acessar a página de **Configurações**:
<Frame>
<img
src="/images/enterprise/settings-page.png"
alt="Página de Configurações"
/>
</Frame>
</Step>
<Step title="Navegue até a Seção de Membros">
- Na página de Configurações, você verá a aba `Members` - Clique na aba
`Members` para acessar a página de **Membros**:
<Frame>
<img src="/images/enterprise/members-tab.png" alt="Aba Membros" />
</Frame>
</Step>
<Step title="Convidar Novos Membros">
- Na seção de Membros, você verá uma lista dos membros atuais (incluindo
você) - Localize o campo de entrada `Email` - Digite o endereço de e-mail da
pessoa que você deseja convidar - Clique no botão `Invite` para enviar o
convite
</Step>
<Step title="Repita Conforme Necessário">
- Você pode repetir esse processo para convidar vários membros da equipe -
Cada membro convidado receberá um convite por e-mail para ingressar na sua
organização
</Step>
</Steps>
## Adicionando Funções
@@ -42,40 +46,54 @@ Como administrador de uma conta CrewAI AOP, você pode facilmente convidar novos
Você pode adicionar funções aos membros da equipe para controlar o acesso a diferentes partes da plataforma.
<Steps>
<Step title="Acesse a Página de Configurações">
- Faça login na sua conta CrewAI AOP
- Procure o ícone de engrenagem (⚙️) no canto superior direito do painel
- Clique no ícone de engrenagem para acessar a página de **Configurações**:
<Frame>
<img src="/images/enterprise/settings-page.png" alt="Página de Configurações" />
</Frame>
</Step>
<Step title="Navegue até a Seção de Funções">
- Na página de Configurações, você verá a aba `Roles`
- Clique na aba `Roles` para acessar a página de **Funções**.
<Frame>
<img src="/images/enterprise/roles-tab.png" alt="Aba Funções" />
</Frame>
- Clique no botão `Add Role` para adicionar uma nova função.
- Insira os detalhes e as permissões da função e clique no botão `Create Role` para criar a função.
<Frame>
<img src="/images/enterprise/add-role-modal.png" alt="Modal Adicionar Função" />
</Frame>
</Step>
<Step title="Adicionar Funções aos Membros">
- Na seção de Membros, você verá uma lista dos membros atuais (incluindo você)
<Frame>
<img src="/images/enterprise/member-accepted-invitation.png" alt="Membro Aceitou Convite" />
</Frame>
- Após o membro aceitar o convite, você poderá adicionar uma função a ele.
- Volte para a aba `Roles`
- Vá até o membro ao qual deseja adicionar uma função e, na coluna `Role`, clique no menu suspenso
- Selecione a função que deseja atribuir ao membro
- Clique no botão `Update` para salvar a função
<Frame>
<img src="/images/enterprise/assign-role.png" alt="Adicionar Função ao Membro" />
</Frame>
</Step>
<Step title="Acesse a Página de Configurações">
- Faça login na sua conta CrewAI AMP - Procure o ícone de engrenagem (⚙️) no
canto superior direito do painel - Clique no ícone de engrenagem para
acessar a página de **Configurações**:
<Frame>
<img
src="/images/enterprise/settings-page.png"
alt="Página de Configurações"
/>
</Frame>
</Step>
<Step title="Navegue até a Seção de Funções">
- Na página de Configurações, você verá a aba `Roles` - Clique na aba
`Roles` para acessar a página de **Funções**.
<Frame>
<img src="/images/enterprise/roles-tab.png" alt="Aba Funções" />
</Frame>
- Clique no botão `Add Role` para adicionar uma nova função. -
Insira os detalhes e as permissões da função e clique no botão `Create Role`
para criar a função.
<Frame>
<img
src="/images/enterprise/add-role-modal.png"
alt="Modal Adicionar Função"
/>
</Frame>
</Step>
<Step title="Adicionar Funções aos Membros">
- Na seção de Membros, você verá uma lista dos membros atuais (incluindo
você)
<Frame>
<img
src="/images/enterprise/member-accepted-invitation.png"
alt="Membro Aceitou Convite"
/>
</Frame>
- Após o membro aceitar o convite, você poderá adicionar uma função
a ele. - Volte para a aba `Roles` - Vá até o membro ao qual deseja adicionar
uma função e, na coluna `Role`, clique no menu suspenso - Selecione a função
que deseja atribuir ao membro - Clique no botão `Update` para salvar a
função
<Frame>
<img
src="/images/enterprise/assign-role.png"
alt="Adicionar Função ao Membro"
/>
</Frame>
</Step>
</Steps>
## Notas Importantes
@@ -85,4 +103,4 @@ Você pode adicionar funções aos membros da equipe para controlar o acesso a d
- **Aceite do Convite**: Os membros convidados precisarão aceitar o convite para ingressar na sua organização
- **Notificações por E-mail**: Oriente seus membros a verificarem o e-mail (incluindo a pasta de spam) para localizar o convite
Seguindo estes passos, você conseguirá expandir sua equipe e colaborar de forma mais eficaz dentro da sua organização CrewAI AOP.
Seguindo estes passos, você conseguirá expandir sua equipe e colaborar de forma mais eficaz dentro da sua organização CrewAI AMP.

14
docs/pt-BR/enterprise/guides/tool-repository.mdx
View File

@@ -20,11 +20,11 @@ O repositório não é um sistema de controle de versões. Use Git para rastrear
Antes de usar o Repositório de Ferramentas, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com)
- Uma conta [CrewAI AMP](https://app.crewai.com)
- [CrewAI CLI](/pt-BR/concepts/cli#cli) instalada
- uv>=0.5.0 instalado. Veja [como atualizar](https://docs.astral.sh/uv/getting-started/installation/#upgrading-uv)
- [Git](https://git-scm.com) instalado e configurado
- Permissões de acesso para publicar ou instalar ferramentas em sua organização CrewAI AOP
- Permissões de acesso para publicar ou instalar ferramentas em sua organização CrewAI AMP
## Instalando ferramentas
@@ -85,13 +85,14 @@ crewai tool publish
Para excluir uma ferramenta:
1. Acesse o [CrewAI AOP](https://app.crewai.com)
1. Acesse o [CrewAI AMP](https://app.crewai.com)
2. Navegue até **Ferramentas**
3. Selecione a ferramenta
4. Clique em **Excluir**
<Warning>
A exclusão é permanente. Ferramentas excluídas não podem ser restauradas ou reinstaladas.
A exclusão é permanente. Ferramentas excluídas não podem ser restauradas ou
reinstaladas.
</Warning>
## Verificações de segurança
@@ -100,8 +101,9 @@ Cada versão publicada passa por verificações automáticas de segurança e só
Você pode verificar o status das verificações de segurança de uma ferramenta em:
`CrewAI AOP > Tools > Your Tool > Versions`
`CrewAI AMP > Tools > Your Tool > Versions`
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência com integração de API ou resolução de problemas.
Entre em contato com nossa equipe de suporte para assistência com integração
de API ou resolução de problemas.
</Card>

34
docs/pt-BR/enterprise/guides/update-crew.mdx
View File

@@ -1,13 +1,14 @@
---
title: "Atualizar Crew"
description: "Atualizando uma Crew no CrewAI AOP"
description: "Atualizando uma Crew no CrewAI AMP"
icon: "pencil"
mode: "wide"
---
<Note>
Após implantar sua crew no CrewAI AOP, pode ser necessário fazer atualizações no código, configurações de segurança ou configuração.
Este guia explica como realizar essas operações de atualização comuns.
Após implantar sua crew no CrewAI AMP, pode ser necessário fazer atualizações
no código, configurações de segurança ou configuração. Este guia explica como
realizar essas operações de atualização comuns.
</Note>
## Por que atualizar sua Crew?
@@ -15,6 +16,7 @@ Este guia explica como realizar essas operações de atualização comuns.
Por padrão, o CrewAI não irá buscar atualizações do GitHub automaticamente, então você precisará acionar manualmente as atualizações, a menos que tenha marcado a opção `Auto-update` ao implantar sua crew.
Há várias razões para querer atualizar sua implantação de crew:
- Você deseja atualizar o código com o commit mais recente que enviou para o GitHub
- Você deseja redefinir o bearer token por motivos de segurança
- Você deseja atualizar variáveis de ambiente
@@ -23,12 +25,10 @@ Há várias razões para querer atualizar sua implantação de crew:
Quando você fizer push de novos commits no seu repositório do GitHub e quiser atualizar sua implantação:
1. Navegue até sua crew na plataforma CrewAI AOP
1. Navegue até sua crew na plataforma CrewAI AMP
2. Clique no botão `Re-deploy` na página de detalhes da sua crew
<Frame>
![Botão Re-deploy](/images/enterprise/redeploy-button.png)
</Frame>
<Frame>![Botão Re-deploy](/images/enterprise/redeploy-button.png)</Frame>
Isso irá acionar uma atualização que pode ser acompanhada pela barra de progresso. O sistema irá buscar o código mais recente do seu repositório e reconstruir sua implantação.
@@ -36,16 +36,16 @@ Isso irá acionar uma atualização que pode ser acompanhada pela barra de progr
Se precisar gerar um novo bearer token (por exemplo, se suspeitar que o token atual possa ter sido comprometido):
1. Navegue até sua crew na plataforma CrewAI AOP
1. Navegue até sua crew na plataforma CrewAI AMP
2. Encontre a seção `Bearer Token`
3. Clique no botão `Reset` ao lado do token atual
<Frame>
![Reset Token](/images/enterprise/reset-token.png)
</Frame>
<Frame>![Reset Token](/images/enterprise/reset-token.png)</Frame>
<Warning>
A redefinição do bearer token invalidará imediatamente o token anterior. Certifique-se de atualizar quaisquer aplicações ou scripts que estejam utilizando o token antigo.
A redefinição do bearer token invalidará imediatamente o token anterior.
Certifique-se de atualizar quaisquer aplicações ou scripts que estejam
utilizando o token antigo.
</Warning>
## 3. Atualizando Variáveis de Ambiente
@@ -69,7 +69,8 @@ Para atualizar as variáveis de ambiente da sua crew:
5. Por fim, clique no botão `Update Deployment` na parte inferior da página para aplicar as alterações
<Note>
A atualização das variáveis de ambiente irá acionar uma nova implantação, mas isso atualizará apenas a configuração de ambiente e não o código em si.
A atualização das variáveis de ambiente irá acionar uma nova implantação, mas
isso atualizará apenas a configuração de ambiente e não o código em si.
</Note>
## Após atualizar
@@ -81,9 +82,12 @@ Após realizar qualquer atualização:
3. Quando finalizado, teste sua crew para garantir que as alterações estão funcionando como esperado
<Tip>
Se encontrar algum problema após a atualização, é possível visualizar os logs de implantação na plataforma ou entrar em contato com o suporte para obter assistência.
Se encontrar algum problema após a atualização, é possível visualizar os logs
de implantação na plataforma ou entrar em contato com o suporte para obter
assistência.
</Tip>
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para obter assistência com a atualização da sua crew ou solução de problemas de implantação.
Entre em contato com nossa equipe de suporte para obter assistência com a
atualização da sua crew ou solução de problemas de implantação.
</Card>

10
docs/pt-BR/enterprise/guides/webhook-automation.mdx
View File

@@ -1,17 +1,17 @@
---
title: "Automação com Webhook"
description: "Automatize fluxos de trabalho do CrewAI AOP usando webhooks com plataformas como ActivePieces, Zapier e Make.com"
description: "Automatize fluxos de trabalho do CrewAI AMP usando webhooks com plataformas como ActivePieces, Zapier e Make.com"
icon: "webhook"
mode: "wide"
---
O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks. Este artigo irá guiá-lo no processo de configuração e uso de webhooks para iniciar a execução do crew, com foco na integração com o ActivePieces, uma plataforma de automação de fluxos de trabalho semelhante ao Zapier e Make.com.
O CrewAI AMP permite que você automatize seu fluxo de trabalho usando webhooks. Este artigo irá guiá-lo no processo de configuração e uso de webhooks para iniciar a execução do crew, com foco na integração com o ActivePieces, uma plataforma de automação de fluxos de trabalho semelhante ao Zapier e Make.com.
## Configurando Webhooks
<Steps>
<Step title="Acessando a Interface de Kickoff">
- Navegue até o painel do CrewAI AOP
- Navegue até o painel do CrewAI AMP
- Procure pela seção `/kickoff`, que é usada para iniciar a execução do crew
<Frame>
<img src="/images/enterprise/kickoff-interface.png" alt="Interface Kickoff" />
@@ -44,7 +44,7 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.
3. Adicione uma etapa de ação HTTP
- Configure a ação como `Send HTTP request`
- Use o método `POST`
- Defina a URL para o endpoint de kickoff do CrewAI AOP
- Defina a URL para o endpoint de kickoff do CrewAI AMP
- Adicione os headers necessários (ex.: `Bearer Token`)
<Frame>
<img src="/images/enterprise/activepieces-headers.png" alt="Headers ActivePieces" />
@@ -76,6 +76,7 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.
<img src="/images/enterprise/activepieces-email.png" alt="Email ActivePieces" />
</Frame>
</Step>
</Steps>
## Exemplos de Output do Webhook
@@ -121,4 +122,5 @@ O CrewAI AOP permite que você automatize seu fluxo de trabalho usando webhooks.
}
```
</Tab>
</Tabs>

21
docs/pt-BR/enterprise/guides/zapier-trigger.mdx
View File

@@ -5,11 +5,11 @@ icon: "bolt"
mode: "wide"
---
Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier para o CrewAI AOP, permitindo automatizar fluxos de trabalho entre CrewAI AOP e outros aplicativos.
Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier para o CrewAI AMP, permitindo automatizar fluxos de trabalho entre CrewAI AMP e outros aplicativos.
## Pré-requisitos
- Uma conta CrewAI AOP
- Uma conta CrewAI AMP
- Uma conta Zapier
- Uma conta Slack (para este exemplo específico)
@@ -32,7 +32,7 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier
- Conecte sua conta Slack, caso ainda não tenha feito isso.
</Step>
<Step title="Configure a ação do CrewAI AOP">
<Step title="Configure a ação do CrewAI AMP">
- Adicione uma nova etapa de ação ao seu Zap.
- Escolha CrewAI+ como o app de ação e Kickoff como Evento de Ação.
@@ -41,8 +41,8 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier
</Frame>
</Step>
<Step title="Conecte sua conta CrewAI AOP">
- Conecte sua conta CrewAI AOP.
<Step title="Conecte sua conta CrewAI AMP">
- Conecte sua conta CrewAI AMP.
- Selecione o Crew apropriado para seu fluxo de trabalho.
<Frame>
@@ -51,8 +51,8 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier
- Configure as entradas para o Crew usando os dados da mensagem do Slack.
</Step>
<Step title="Formate a saída do CrewAI AOP">
- Adicione outra etapa de ação para formatar a saída de texto do CrewAI AOP.
<Step title="Formate a saída do CrewAI AMP">
- Adicione outra etapa de ação para formatar a saída de texto do CrewAI AMP.
- Utilize as ferramentas de formatação do Zapier para converter a saída em Markdown para HTML.
<Frame>
@@ -67,7 +67,7 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier
- Adicione uma etapa final de ação para enviar a saída formatada por e-mail.
- Escolha seu serviço de e-mail preferido (ex.: Gmail, Outlook).
- Configure os detalhes do e-mail, incluindo destinatário, assunto e corpo.
- Insira a saída formatada do CrewAI AOP no corpo do e-mail.
- Insira a saída formatada do CrewAI AMP no corpo do e-mail.
<Frame>
<img src="/images/enterprise/zapier-7.png" alt="Zapier 7" />
@@ -93,12 +93,13 @@ Este guia irá conduzi-lo pelo processo de configuração de triggers no Zapier
<img src="/images/enterprise/zapier-9.png" alt="Zapier 12" />
</Frame>
</Step>
</Steps>
## Dicas para o Sucesso
- Certifique-se de que as entradas do CrewAI AOP estejam corretamente mapeadas a partir da mensagem do Slack.
- Certifique-se de que as entradas do CrewAI AMP estejam corretamente mapeadas a partir da mensagem do Slack.
- Teste seu Zap cuidadosamente antes de ativá-lo para identificar possíveis problemas.
- Considere adicionar etapas de tratamento de erros para gerenciar possíveis falhas no fluxo.
Seguindo estes passos, você terá configurado com sucesso triggers no Zapier para o CrewAI AOP, permitindo fluxos de trabalho automatizados disparados por mensagens no Slack e resultando em notificações por e-mail com a saída do CrewAI AOP.
Seguindo estes passos, você terá configurado com sucesso triggers no Zapier para o CrewAI AMP, permitindo fluxos de trabalho automatizados disparados por mensagens no Slack e resultando em notificações por e-mail com a saída do CrewAI AMP.

19
docs/pt-BR/enterprise/integrations/asana.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem tarefas, projetos e a coordenação da equipe
Antes de usar a integração com o Asana, assegure-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Asana com as permissões apropriadas
- Sua conta Asana conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Asana, assegure-se de ter:
### 1. Conecte sua Conta Asana
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Asana** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de tarefas e projetos
@@ -36,7 +36,8 @@ 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.
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
@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `task` (string, obrigatório): ID da Tarefa - O ID da tarefa à qual o comentário será adicionado. O comentário será escrito pelo usuário atualmente autenticado.
- `text` (string, obrigatório): Texto (exemplo: "Este é um comentário.").
</Accordion>
<Accordion title="asana/create_project">
@@ -68,6 +70,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `workspace` (string, obrigatório): Área de trabalho - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham em qual área de trabalho criar projetos. Por padrão, será usada a primeira área de trabalho do usuário se deixado em branco.
- `team` (string, opcional): Equipe - Use as Configurações de Fluxo do Portal Connect para permitir que usuários escolham com qual equipe compartilhar o projeto. Por padrão, será usada a primeira equipe do usuário se deixado em branco.
- `notes` (string, opcional): Notas (exemplo: "Esses são itens que precisamos comprar.").
</Accordion>
<Accordion title="asana/get_projects">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `archived` (string, opcional): Arquivado - Escolha "true" para mostrar projetos arquivados, "false" para exibir apenas projetos ativos ou "default" para mostrar ambos.
- Opções: `default`, `true`, `false`
</Accordion>
<Accordion title="asana/get_project_by_id">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `projectFilterId` (string, obrigatório): ID do Projeto.
</Accordion>
<Accordion title="asana/create_task">
@@ -97,6 +102,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `dueAtDate` (string, opcional): Vence Em - A data e hora (timestamp ISO) em que esta tarefa deve ser concluída. Não pode ser usada em conjunto com Due On. (exemplo: "2019-09-15T02:06:58.147Z").
- `assignee` (string, opcional): Responsável - O ID do usuário Asana a quem esta tarefa será atribuída. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um responsável.
- `gid` (string, opcional): ID Externo - Um ID da sua aplicação para associar esta tarefa. Você pode usar este ID para sincronizar atualizações com esta tarefa posteriormente.
</Accordion>
<Accordion title="asana/update_task">
@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `dueAtDate` (string, opcional): Vence Em - A data e hora (timestamp ISO) em que esta tarefa deve ser concluída. Não pode ser usada junto com Due On. (exemplo: "2019-09-15T02:06:58.147Z").
- `assignee` (string, opcional): Responsável - O ID do usuário Asana a quem esta tarefa será atribuída. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem o responsável.
- `gid` (string, opcional): ID Externo - Um ID da sua aplicação para associar a tarefa. Você pode usar este ID para sincronizar atualizações posteriormente.
</Accordion>
<Accordion title="asana/get_tasks">
@@ -122,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `project` (string, opcional): Projeto - O ID do projeto para filtrar as tarefas. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um projeto.
- `assignee` (string, opcional): Responsável - O ID do responsável para filtrar tarefas. Use as Configurações de Fluxo do Portal Connect para permitir que usuários selecionem um responsável.
- `completedSince` (string, opcional): Concluída desde - Retorna apenas tarefas que estejam incompletas ou que tenham sido concluídas desde este horário (timestamp ISO ou Unix). (exemplo: "2014-04-25T16:15:47-04:00").
</Accordion>
<Accordion title="asana/get_tasks_by_id">
@@ -129,6 +137,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `taskId` (string, obrigatório): ID da Tarefa.
</Accordion>
<Accordion title="asana/get_task_by_external_id">
@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `gid` (string, obrigatório): ID Externo - O ID que esta tarefa está associada ou sincronizada, de sua aplicação.
</Accordion>
<Accordion title="asana/add_task_to_section">
@@ -146,6 +156,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `taskId` (string, obrigatório): ID da Tarefa - O ID da tarefa. (exemplo: "1204619611402340").
- `beforeTaskId` (string, opcional): Antes da Tarefa - O ID de uma tarefa nesta seção antes da qual esta tarefa será inserida. Não pode ser usada junto com After Task ID. (exemplo: "1204619611402340").
- `afterTaskId` (string, opcional): Após a Tarefa - O ID de uma tarefa nesta seção após a qual esta tarefa será inserida. Não pode ser usada junto com Before Task ID. (exemplo: "1204619611402340").
</Accordion>
<Accordion title="asana/get_teams">
@@ -153,12 +164,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `workspace` (string, obrigatório): Área de trabalho - Retorna as equipes nesta área de trabalho visíveis para o usuário autorizado.
</Accordion>
<Accordion title="asana/get_workspaces">
**Descrição:** Obtém uma lista de áreas de trabalho do Asana.
**Parâmetros:** Nenhum obrigatório.
</Accordion>
</AccordionGroup>

13
docs/pt-BR/enterprise/integrations/box.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem arquivos, pastas e documentos através do Box
Antes de utilizar a integração com o Box, assegure-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Box com as permissões apropriadas
- Sua conta Box conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Box, assegure-se de que você possui:
### 1. Conecte sua conta Box
1. Acesse [Integrações do CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações do CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Box** na seção de Integrações de Autenticação
3. Clique em **Conectar** e conclua o fluxo de OAuth
4. Conceda as permissões necessárias para gerenciamento de arquivos e pastas
@@ -50,6 +50,7 @@ uv add crewai-tools
}
```
- `file` (string, obrigatório): URL do arquivo - Os arquivos devem ter menos de 50MB. (exemplo: "https://picsum.photos/200/300").
</Accordion>
<Accordion title="box/save_file_from_object">
@@ -59,6 +60,7 @@ uv add crewai-tools
- `file` (string, obrigatório): Arquivo - Aceita um Objeto de Arquivo contendo os dados. O arquivo deve ter menos de 50MB.
- `fileName` (string, obrigatório): Nome do Arquivo (exemplo: "qwerty.png").
- `folder` (string, opcional): Pasta - Use as configurações de workflow do Connect Portal para permitir que usuários escolham o destino da pasta. Caso em branco, o padrão é a pasta raiz do usuário.
</Accordion>
<Accordion title="box/get_file_by_id">
@@ -66,6 +68,7 @@ uv add crewai-tools
**Parâmetros:**
- `fileId` (string, obrigatório): ID do arquivo - Identificador único que representa um arquivo. (exemplo: "12345").
</Accordion>
<Accordion title="box/list_files">
@@ -91,6 +94,7 @@ uv add crewai-tools
]
}
```
</Accordion>
<Accordion title="box/create_folder">
@@ -104,6 +108,7 @@ uv add crewai-tools
"id": "123456"
}
```
</Accordion>
<Accordion title="box/move_folder">
@@ -118,6 +123,7 @@ uv add crewai-tools
"id": "123456"
}
```
</Accordion>
<Accordion title="box/get_folder_by_id">
@@ -125,6 +131,7 @@ uv add crewai-tools
**Parâmetros:**
- `folderId` (string, obrigatório): ID da pasta - Identificador único que representa uma pasta. (exemplo: "0").
</Accordion>
<Accordion title="box/search_folders">
@@ -150,6 +157,7 @@ uv add crewai-tools
]
}
```
</Accordion>
<Accordion title="box/delete_folder">
@@ -158,6 +166,7 @@ uv add crewai-tools
**Parâmetros:**
- `folderId` (string, obrigatório): ID da pasta - Identificador único que representa uma pasta. (exemplo: "0").
- `recursive` (boolean, opcional): Recursivo - Exclui uma pasta que não está vazia, deletando de forma recursiva a pasta e todo o seu conteúdo.
</Accordion>
</AccordionGroup>

21
docs/pt-BR/enterprise/integrations/clickup.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem tarefas, projetos e fluxos de produtividade p
Antes de utilizar a integração com o ClickUp, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta ClickUp com as permissões apropriadas
- Sua conta ClickUp conectada pela [Página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de utilizar a integração com o ClickUp, certifique-se de que você possu
### 1. Conecte sua Conta ClickUp
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **ClickUp** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de tarefas e projetos
@@ -36,7 +36,8 @@ 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.
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
@@ -75,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
```
Campos disponíveis: `space_ids%5B%5D`, `project_ids%5B%5D`, `list_ids%5B%5D`, `statuses%5B%5D`, `include_closed`, `assignees%5B%5D`, `tags%5B%5D`, `due_date_gt`, `due_date_lt`, `date_created_gt`, `date_created_lt`, `date_updated_gt`, `date_updated_lt`
</Accordion>
<Accordion title="clickup/get_task_in_list">
@@ -83,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listId` (string, obrigatório): Lista - Selecione uma Lista da qual obter as tarefas. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem uma Lista ClickUp.
- `taskFilterFormula` (string, opcional): Busque tarefas que correspondam aos filtros especificados. Por exemplo: name=task1.
</Accordion>
<Accordion title="clickup/create_task">
@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `assignees` (string, opcional): Responsáveis - Selecione um Membro (ou um array de IDs de membros) para ser responsável por esta tarefa. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem um Membro ClickUp.
- `dueDate` (string, opcional): Data de Vencimento - Especifique uma data para a conclusão desta tarefa.
- `additionalFields` (string, opcional): Campos Adicionais - Especifique campos adicionais para incluir nesta tarefa em formato JSON.
</Accordion>
<Accordion title="clickup/update_task">
@@ -110,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `assignees` (string, opcional): Responsáveis - Selecione um Membro (ou um array de IDs de membros) para ser responsável por esta tarefa. Use as Configurações do Usuário no Portal de Conexão para permitir que os usuários selecionem um Membro ClickUp.
- `dueDate` (string, opcional): Data de Vencimento - Especifique uma data para a conclusão desta tarefa.
- `additionalFields` (string, opcional): Campos Adicionais - Especifique campos adicionais para incluir nesta tarefa em formato JSON.
</Accordion>
<Accordion title="clickup/delete_task">
@@ -117,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `taskId` (string, obrigatório): ID da tarefa - O ID da tarefa a ser excluída.
</Accordion>
<Accordion title="clickup/get_list">
@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `spaceId` (string, obrigatório): ID do Espaço - O ID do espaço que contém as listas.
</Accordion>
<Accordion title="clickup/get_custom_fields_in_list">
@@ -131,6 +138,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listId` (string, obrigatório): ID da Lista - O ID da lista da qual obter os campos personalizados.
</Accordion>
<Accordion title="clickup/get_all_fields_in_list">
@@ -138,6 +146,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listId` (string, obrigatório): ID da Lista - O ID da lista da qual obter todos os campos.
</Accordion>
<Accordion title="clickup/get_space">
@@ -145,6 +154,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `spaceId` (string, opcional): ID do Espaço - O ID do espaço a ser recuperado.
</Accordion>
<Accordion title="clickup/get_folders">
@@ -152,12 +162,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `spaceId` (string, obrigatório): ID do Espaço - O ID do espaço que contém as pastas.
</Accordion>
<Accordion title="clickup/get_member">
**Descrição:** Obtenha informações de Membro no ClickUp.
**Parâmetros:** Nenhum obrigatório.
</Accordion>
</AccordionGroup>
@@ -283,5 +295,6 @@ crew.kickoff()
### Precisa de Ajuda?
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para auxílio na configuração ou solução de problemas da integração com ClickUp.
Entre em contato com nossa equipe de suporte para auxílio na configuração ou
solução de problemas da integração com ClickUp.
</Card>

17
docs/pt-BR/enterprise/integrations/github.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem repositórios, issues e releases através do
Antes de usar a integração do GitHub, assegure-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta GitHub com permissões adequadas no repositório
- Conta do GitHub conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração do GitHub, assegure-se de ter:
### 1. Conecte sua conta GitHub
1. Acesse [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **GitHub** 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 gerenciamento de repositório e issues
@@ -45,6 +45,7 @@ uv add crewai-tools
- `title` (string, obrigatório): Título da Issue - Especifique o título da issue a ser criada.
- `body` (string, opcional): Corpo da Issue - Especifique o conteúdo do corpo da issue a ser criada.
- `assignees` (string, opcional): Responsáveis - Especifique o login dos responsáveis no GitHub como um array de strings para esta issue. (exemplo: `["octocat"]`).
</Accordion>
<Accordion title="github/update_issue">
@@ -59,6 +60,7 @@ uv add crewai-tools
- `assignees` (string, opcional): Responsáveis - Especifique o login dos responsáveis no GitHub como um array de strings para esta issue. (exemplo: `["octocat"]`).
- `state` (string, opcional): Estado - Especifique o estado atualizado da issue.
- Opções: `open`, `closed`
</Accordion>
<Accordion title="github/get_issue_by_number">
@@ -68,6 +70,7 @@ uv add crewai-tools
- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a esta Issue. (exemplo: "abc").
- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a esta Issue.
- `issue_number` (string, obrigatório): Número da Issue - Especifique o número da issue a ser buscada.
</Accordion>
<Accordion title="github/lock_issue">
@@ -79,6 +82,7 @@ uv add crewai-tools
- `issue_number` (string, obrigatório): Número da Issue - Especifique o número da issue a ser bloqueada.
- `lock_reason` (string, obrigatório): Motivo do Bloqueio - Especifique um motivo para bloquear a discussão da issue ou pull request.
- Opções: `off-topic`, `too heated`, `resolved`, `spam`
</Accordion>
<Accordion title="github/search_issue">
@@ -106,6 +110,7 @@ uv add crewai-tools
}
```
Campos disponíveis: `assignee`, `creator`, `mentioned`, `labels`
</Accordion>
<Accordion title="github/create_release">
@@ -124,6 +129,7 @@ uv add crewai-tools
- `discussion_category_name` (string, opcional): Nome da Categoria de Discussão - Se especificado, uma discussão da categoria indicada é criada e vinculada ao release. O valor deve ser uma categoria já existente no repositório.
- `generate_release_notes` (string, opcional): Notas de Release - Especifique se o release criado deve criar automaticamente notas de release usando o nome e a descrição fornecidos.
- Opções: `true`, `false`
</Accordion>
<Accordion title="github/update_release">
@@ -143,6 +149,7 @@ uv add crewai-tools
- `discussion_category_name` (string, opcional): Nome da Categoria de Discussão - Se especificado, uma discussão da categoria indicada é criada e vinculada ao release. O valor deve ser uma categoria já existente no repositório.
- `generate_release_notes` (string, opcional): Notas de Release - Especifique se o release criado deve criar automaticamente notas de release usando o nome e a descrição fornecidos.
- Opções: `true`, `false`
</Accordion>
<Accordion title="github/get_release_by_id">
@@ -152,6 +159,7 @@ uv add crewai-tools
- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").
- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.
- `id` (string, obrigatório): ID do Release - Especifique o ID do release a ser recuperado.
</Accordion>
<Accordion title="github/get_release_by_tag_name">
@@ -161,6 +169,7 @@ uv add crewai-tools
- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").
- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.
- `tag_name` (string, obrigatório): Nome - Especifique o nome da tag do release a ser recuperado. (exemplo: "v1.0.0").
</Accordion>
<Accordion title="github/delete_release">
@@ -170,6 +179,7 @@ uv add crewai-tools
- `owner` (string, obrigatório): Proprietário - Especifique o nome do proprietário da conta do repositório associado a este Release. (exemplo: "abc").
- `repo` (string, obrigatório): Repositório - Especifique o nome do repositório associado a este Release.
- `id` (string, obrigatório): ID do Release - Especifique o ID do release a ser excluído.
</Accordion>
</AccordionGroup>
@@ -297,5 +307,6 @@ crew.kickoff()
### Obtendo Ajuda
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para auxílio na configuração ou solução de problemas com a integração do GitHub.
Entre em contato com nossa equipe de suporte para auxílio na configuração ou
solução de problemas com a integração do GitHub.
</Card>

19
docs/pt-BR/enterprise/integrations/gmail.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem e-mails, contatos e rascunhos através do Gma
Antes de usar a integração com o Gmail, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta do Gmail com as permissões adequadas
- Conectou sua conta do Gmail através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Gmail, certifique-se de que você possui:
### 1. Conecte sua Conta do Gmail
1. Navegue até [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue até [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Gmail** na seção de Integrações de Autenticação
3. Clique em **Conectar** e conclua o fluxo OAuth
4. Conceda as permissões necessárias para o gerenciamento de e-mail e contato
@@ -36,7 +36,8 @@ 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.
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
@@ -73,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"reply-to": "Nome do Remetente <sender@domain.com>"
}
```
</Accordion>
<Accordion title="gmail/get_email_by_id">
@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `userId` (string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: "user@domain.com").
- `messageId` (string, obrigatório): ID da Mensagem - Especifique o ID da mensagem a ser recuperada.
</Accordion>
<Accordion title="gmail/fetch_emails">
@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="gmail/delete_email">
@@ -120,6 +124,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `userId` (string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: "user@domain.com").
- `messageId` (string, obrigatório): ID da Mensagem - Especifique o ID da mensagem para enviar para a lixeira.
</Accordion>
<Accordion title="gmail/create_a_contact">
@@ -140,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
]
}
```
</Accordion>
<Accordion title="gmail/get_contact_by_resource_name">
@@ -147,6 +153,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `resourceName` (string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser buscado.
</Accordion>
<Accordion title="gmail/search_for_contact">
@@ -154,6 +161,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `searchTerm` (string, obrigatório): Termo - Especifique um termo para buscar correspondências aproximadas ou exatas nos campos nome, apelido, endereços de e-mail, números de telefone ou organizações do contato.
</Accordion>
<Accordion title="gmail/delete_contact">
@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `resourceName` (string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser excluído.
</Accordion>
<Accordion title="gmail/create_draft">
@@ -184,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"reply-to": "Nome do Remetente <sender@domain.com>"
}
```
</Accordion>
</AccordionGroup>
@@ -341,5 +351,6 @@ crew.kickoff()
### Precisa de Ajuda?
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Gmail.
Entre em contato com nosso time de suporte para obter assistência na
configuração ou solução de problemas da integração Gmail.
</Card>

27
docs/pt-BR/enterprise/integrations/google_calendar.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem eventos de calendário, agendas e disponibili
Antes de usar a integração com o Google Calendar, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Calendar
- Sua conta Google conectada pela [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Google Calendar, certifique-se de ter:
### 1. Conecte sua Conta Google
1. Acesse [Integrações do CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações do CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Google Calendar** 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 ao calendário e contatos
@@ -36,7 +36,8 @@ 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.
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
@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `eventDescription` (string, opcional): Descrição do evento.
- `eventId` (string, opcional): ID do evento – Um ID da sua aplicação para associar a este evento. Você pode usar esse ID para sincronizar atualizações posteriores neste evento.
- `includeMeetLink` (boolean, opcional): Incluir link do Google Meet? – Cria automaticamente um link para conferência Google Meet para este evento.
</Accordion>
<Accordion title="google_calendar/update_event">
@@ -79,6 +81,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `attendees` (string, opcional): Participantes – Aceita um array de e-mails ou e-mails separados por vírgula.
- `eventLocation` (string, opcional): Local do evento.
- `eventDescription` (string, opcional): Descrição do evento.
</Accordion>
<Accordion title="google_calendar/view_events">
@@ -88,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.
- `after` (string, opcional): Após – Filtra eventos que começam após a data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: "2025-04-12T10:00:00Z ou 1712908800000").
- `before` (string, opcional): Antes – Filtra eventos que terminam antes da data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: "2025-04-12T10:00:00Z ou 1712908800000").
</Accordion>
<Accordion title="google_calendar/get_event_by_id">
@@ -96,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `eventId` (string, obrigatório): ID do evento.
- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.
</Accordion>
<Accordion title="google_calendar/delete_event">
@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `eventId` (string, obrigatório): ID do evento – O ID do evento do calendário a ser excluído.
- `calendar` (string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.
</Accordion>
<Accordion title="google_calendar/get_contacts">
@@ -116,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_contacts">
@@ -123,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `query` (string, opcional): Termo de pesquisa para buscar contatos.
</Accordion>
<Accordion title="google_calendar/list_directory_people">
@@ -135,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_directory_people">
@@ -148,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/list_other_contacts">
@@ -160,6 +170,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"pageCursor": "page_cursor_string"
}
```
</Accordion>
<Accordion title="google_calendar/search_other_contacts">
@@ -167,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `query` (string, opcional): Termo de pesquisa para buscar contatos.
</Accordion>
<Accordion title="google_calendar/get_availability">
@@ -187,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
]
```
</Accordion>
</AccordionGroup>
@@ -354,27 +367,32 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Google possui as permissões necessárias para acessar o calendário
- Verifique se a conexão OAuth inclui todos os escopos necessários para a API do Google Calendar
- Confirme se as configurações de compartilhamento do calendário permitem o nível de acesso necessário
**Problemas na Criação de Eventos**
- Verifique se os formatos de horário estão corretos (ISO8601 ou timestamps Unix)
- Assegure-se de que os endereços de e-mail dos participantes estão corretamente formatados
- Verifique se o calendário de destino existe e está acessível
- Confirme se os fusos horários estão especificados corretamente
**Disponibilidade e Conflitos de Horário**
- Use formato ISO adequado para os intervalos de horário ao verificar disponibilidade
- Certifique-se de que os fusos horários estão consistentes em todas as operações
- Verifique se os IDs dos calendários estão corretos ao consultar múltiplos calendários
**Pesquisa de Contatos e Pessoas**
- Assegure-se de que os termos de pesquisa estão devidamente formatados
- Verifique se as permissões para acesso ao diretório foram concedidas
- Certifique-se de que as informações de contato estão atualizadas e acessíveis
**Atualização e Exclusão de Eventos**
- Verifique se os IDs dos eventos estão corretos e se os eventos existem
- Assegure-se de que você possui permissões de edição para os eventos
- Verifique se a propriedade do calendário permite modificações
@@ -382,5 +400,6 @@ crew.kickoff()
### Obtendo Ajuda
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nosso time de suporte para assistência na configuração da integração com o Google Calendar ou solução de problemas.
Entre em contato com nosso time de suporte para assistência na configuração da
integração com o Google Calendar ou solução de problemas.
</Card>

28
docs/pt-BR/enterprise/integrations/google_contacts.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem informações de contatos e diretório atrav
Antes de usar a integração Google Contacts, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Contacts
- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Google Contacts, certifique-se de ter:
### 1. Conecte sua Conta Google
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Google Contacts** 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 contatos e diretório
@@ -36,7 +36,8 @@ 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.
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
@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers
- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false
- `sortOrder` (string, opcional): A ordem na qual as conexões devem ser classificadas. Opções: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING
</Accordion>
<Accordion title="google_contacts/search_contacts">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `pageSize` (integer, opcional): Número de resultados a retornar. Mínimo: 1, Máximo: 30
- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.
- `sources` (array, opcional): As fontes para pesquisar. Opções: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. Padrão: READ_SOURCE_TYPE_CONTACT
</Accordion>
<Accordion title="google_contacts/list_directory_people">
@@ -84,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `readMask` (string, opcional): Campos a ler (ex: 'names,emailAddresses')
- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false
- `mergeSources` (array, opcional): Dados adicionais para mesclar nas respostas de pessoas do diretório. Opções: CONTACT
</Accordion>
<Accordion title="google_contacts/search_directory_people">
@@ -94,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sources` (string, obrigatório): Fontes de diretório (use 'DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE')
- `pageSize` (integer, opcional): Número de resultados a retornar
- `readMask` (string, opcional): Campos a ler
</Accordion>
<Accordion title="google_contacts/list_other_contacts">
@@ -104,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.
- `readMask` (string, opcional): Campos a ler
- `requestSyncToken` (boolean, opcional): Se a resposta deve incluir um token de sincronização. Padrão: false
</Accordion>
<Accordion title="google_contacts/search_other_contacts">
@@ -113,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `query` (string, obrigatório): Consulta de pesquisa
- `readMask` (string, obrigatório): Campos a ler (ex: 'names,emailAddresses')
- `pageSize` (integer, opcional): Número de resultados
</Accordion>
<Accordion title="google_contacts/get_person">
@@ -121,6 +128,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `resourceName` (string, obrigatório): O nome do recurso da pessoa a obter (ex: 'people/c123456789')
- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers
</Accordion>
<Accordion title="google_contacts/create_contact">
@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `phoneNumbers` (array, opcional): Números de telefone. Cada item é um objeto com `value` (string, número de telefone) e `type` (string, 'home', 'work', 'mobile', 'other', padrão 'other').
- `addresses` (array, opcional): Endereços postais. Cada item é um objeto com `formattedValue` (string, endereço formatado) e `type` (string, 'home', 'work', 'other', padrão 'other').
- `organizations` (array, opcional): Organizações/empresas. Cada item é um objeto com `name` (string, nome da organização), `title` (string, cargo) e `type` (string, 'work', 'other', padrão 'work').
</Accordion>
<Accordion title="google_contacts/update_contact">
@@ -143,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `names` (array, opcional): Nomes da pessoa. Cada item é um objeto com `givenName` (string), `familyName` (string), `displayName` (string).
- `emailAddresses` (array, opcional): Endereços de email. Cada item é um objeto com `value` (string, endereço de email) e `type` (string, 'home', 'work', 'other').
- `phoneNumbers` (array, opcional): Números de telefone. Cada item é um objeto com `value` (string, número de telefone) e `type` (string, 'home', 'work', 'mobile', 'other').
</Accordion>
<Accordion title="google_contacts/delete_contact">
@@ -150,6 +160,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `resourceName` (string, obrigatório): O nome do recurso da pessoa a excluir (ex: 'people/c123456789').
</Accordion>
<Accordion title="google_contacts/batch_get_people">
@@ -158,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `resourceNames` (array, obrigatório): Nomes de recursos das pessoas a obter (máx 200 itens).
- `personFields` (string, opcional): Campos a incluir (ex: 'names,emailAddresses,phoneNumbers'). Padrão: names,emailAddresses,phoneNumbers
</Accordion>
<Accordion title="google_contacts/list_contact_groups">
@@ -167,6 +179,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `pageSize` (integer, opcional): Número de grupos de contatos a retornar. Mínimo: 1, Máximo: 1000
- `pageToken` (string, opcional): Token especificando qual página de resultado retornar.
- `groupFields` (string, opcional): Campos a incluir (ex: 'name,memberCount,clientData'). Padrão: name,memberCount
</Accordion>
<Accordion title="google_contacts/get_contact_group">
@@ -176,6 +189,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `resourceName` (string, obrigatório): O nome do recurso do grupo de contatos (ex: 'contactGroups/myContactGroup').
- `maxMembers` (integer, opcional): Número máximo de membros a incluir. Mínimo: 0, Máximo: 20000
- `groupFields` (string, opcional): Campos a incluir (ex: 'name,memberCount,clientData'). Padrão: name,memberCount
</Accordion>
<Accordion title="google_contacts/create_contact_group">
@@ -184,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `name` (string, obrigatório): O nome do grupo de contatos.
- `clientData` (array, opcional): Dados específicos do cliente. Cada item é um objeto com `key` (string) e `value` (string).
</Accordion>
</AccordionGroup>
@@ -279,24 +294,29 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso a contatos e diretório.
- Verifique se a conexão OAuth inclui todos os escopos necessários para a API Google People.
**Problemas de Criação/Atualização de Contatos**
- Certifique-se de que campos obrigatórios como `email` sejam fornecidos para criação de contatos.
- Verifique se o `resourceName` está correto ao atualizar ou excluir contatos.
- Confirme se o formato dos dados para `names`, `emailAddresses`, `phoneNumbers`, etc., corresponde às especificações da API.
**Problemas de Pesquisa e Filtro**
- Certifique-se de que os parâmetros de `query` e `readMask` estejam especificados corretamente para `search_contacts` e `search_other_contacts`.
- Para pesquisas de diretório, certifique-se de que `sources` esteja definido corretamente (ex: 'DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE').
**Gerenciamento de Grupos de Contatos**
- Ao criar um grupo de contatos, certifique-se de que o `name` seja fornecido.
- Para `get_contact_group`, certifique-se de que o `resourceName` esteja correto.
### 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 Google Contacts.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Google Contacts.
</Card>

23
docs/pt-BR/enterprise/integrations/google_docs.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes criem, editem e gerenciem documentos do Google Docs com
Antes de usar a integração Google Docs, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Docs
- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Google Docs, certifique-se de ter:
### 1. Conecte sua Conta Google
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Google Docs** 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 documentos
@@ -36,7 +36,8 @@ 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.
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
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `title` (string, opcional): O título para o novo documento.
</Accordion>
<Accordion title="google_docs/get_document">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `documentId` (string, obrigatório): O ID do documento a recuperar.
- `includeTabsContent` (boolean, opcional): Se deve incluir conteúdo de abas. Padrão: false
- `suggestionsViewMode` (string, opcional): O modo de visualização de sugestões a aplicar ao documento. Opções: DEFAULT_FOR_CURRENT_ACCESS, PREVIEW_SUGGESTIONS_ACCEPTED, PREVIEW_WITHOUT_SUGGESTIONS. Padrão: DEFAULT_FOR_CURRENT_ACCESS
</Accordion>
<Accordion title="google_docs/batch_update">
@@ -75,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `documentId` (string, obrigatório): O ID do documento a atualizar.
- `requests` (array, obrigatório): Uma lista de atualizações a aplicar ao documento. Cada item é um objeto representando uma solicitação.
- `writeControl` (object, opcional): Fornece controle sobre como as solicitações de escrita são executadas. Contém `requiredRevisionId` (string) e `targetRevisionId` (string).
</Accordion>
<Accordion title="google_docs/insert_text">
@@ -84,6 +88,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `documentId` (string, obrigatório): O ID do documento a atualizar.
- `text` (string, obrigatório): O texto a inserir.
- `index` (integer, opcional): O índice baseado em zero onde inserir o texto. Padrão: 1
</Accordion>
<Accordion title="google_docs/replace_text">
@@ -94,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `containsText` (string, obrigatório): O texto a encontrar e substituir.
- `replaceText` (string, obrigatório): O texto para substituir.
- `matchCase` (boolean, opcional): Se a pesquisa deve respeitar maiúsculas e minúsculas. Padrão: false
</Accordion>
<Accordion title="google_docs/delete_content_range">
@@ -103,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `documentId` (string, obrigatório): O ID do documento a atualizar.
- `startIndex` (integer, obrigatório): O índice inicial do intervalo a excluir.
- `endIndex` (integer, obrigatório): O índice final do intervalo a excluir.
</Accordion>
<Accordion title="google_docs/insert_page_break">
@@ -111,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `documentId` (string, obrigatório): O ID do documento a atualizar.
- `index` (integer, opcional): O índice baseado em zero onde inserir a quebra de página. Padrão: 1
</Accordion>
<Accordion title="google_docs/create_named_range">
@@ -121,6 +129,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `name` (string, obrigatório): O nome para o intervalo nomeado.
- `startIndex` (integer, obrigatório): O índice inicial do intervalo.
- `endIndex` (integer, obrigatório): O índice final do intervalo.
</Accordion>
</AccordionGroup>
@@ -216,29 +225,35 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Docs.
- Verifique se a conexão OAuth inclui todos os escopos necessários (`https://www.googleapis.com/auth/documents`).
**Problemas de ID do Documento**
- Verifique novamente os IDs dos documentos para correção.
- Certifique-se de que o documento existe e está acessível à sua conta.
- IDs de documentos podem ser encontrados na URL do Google Docs.
**Inserção de Texto e Operações de Intervalo**
- Ao usar `insert_text` ou `delete_content_range`, certifique-se de que as posições de índice sejam válidas.
- Lembre-se de que o Google Docs usa indexação baseada em zero.
- O documento deve ter conteúdo nas posições de índice especificadas.
**Formatação de Solicitação de Atualização em Lote**
- Ao usar `batch_update`, certifique-se de que o array `requests` esteja formatado corretamente de acordo com a documentação da API do Google Docs.
- Atualizações complexas requerem estruturas JSON específicas para cada tipo de solicitação.
**Operações de Substituição de Texto**
- Para `replace_text`, certifique-se de que o parâmetro `containsText` corresponda exatamente ao texto que você deseja substituir.
- Use o parâmetro `matchCase` para controlar a sensibilidade a maiúsculas e minúsculas.
### 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 Google Docs.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Google Docs.
</Card>

11
docs/pt-BR/enterprise/integrations/google_drive.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem arquivos e pastas no Google Drive.
Antes de usar a integração Google Drive, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Drive
- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Google Drive, certifique-se de ter:
### 1. Conecte sua Conta Google
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Google Drive** 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
@@ -36,7 +36,8 @@ 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.
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
@@ -58,10 +59,12 @@ Para informações detalhadas sobre parâmetros e uso, consulte a [documentaçã
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Drive.
### 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 Google Drive.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Google Drive.
</Card>

19
docs/pt-BR/enterprise/integrations/google_sheets.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem dados de planilhas por meio do Google Sheets.
Antes de utilizar a integração com o Google Sheets, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Sheets
- Sua conta Google conectada pela [página de integrações](https://app.crewai.com/crewai_plus/connectors)
- Planilhas com cabeçalhos de coluna adequados para operações com dados
@@ -22,7 +22,7 @@ Antes de utilizar a integração com o Google Sheets, certifique-se de que você
### 1. Conecte sua Conta Google
1. Acesse [Integrações do CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações do CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Localize **Google Sheets** na seção Integrações de Autenticação
3. Clique em **Conectar** e conclua o fluxo OAuth
4. Conceda as permissões necessárias para acesso à planilha
@@ -37,7 +37,8 @@ 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.
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
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `spreadsheetId` (string, obrigatório): Planilha - Use as Configurações de Workflow do Portal de Conexão para permitir ao usuário selecionar uma planilha. Por padrão, usa a primeira worksheet da planilha selecionada.
- `limit` (string, opcional): Limite de linhas - Limita o número máximo de linhas retornadas.
</Accordion>
<Accordion title="google_sheets/append_values">
@@ -76,6 +78,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"columnName4": "columnValue4"
}
```
</Accordion>
<Accordion title="google_sheets/update_values">
@@ -112,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"columnName4": "newValue4"
}
```
</Accordion>
</AccordionGroup>
@@ -279,32 +283,38 @@ crew.kickoff()
### Problemas Comuns
**Erros de Permissão**
- Certifique-se de que sua conta Google tem acesso de edição às planilhas alvo
- Verifique se a conexão OAuth inclui os escopos necessários para a API do Google Sheets
- Confira se as planilhas estão compartilhadas com a conta autenticada
**Problemas de Estrutura da Planilha**
- Certifique-se de que as worksheets têm cabeçalhos de coluna antes de criar ou atualizar linhas
- Verifique se os nomes das colunas em `additionalFields` correspondem exatamente aos cabeçalhos
- Confirme que a worksheet especificada existe na planilha
**Problemas de Tipo e Formato de Dados**
- Garanta que os valores dos dados estejam no formato esperado para cada coluna
- Utilize formatos de data adequados nas colunas de data (recomenda-se ISO)
- Verifique se valores numéricos estão devidamente formatados para colunas numéricas
**Problemas com Fórmulas de Filtro**
- Certifique-se de que as fórmulas de filtro seguem a estrutura JSON correta para forma normal disjuntiva
- Use nomes de campos válidos, correspondendo exatamente aos cabeçalhos das colunas
- Teste filtros simples antes de criar consultas com múltiplas condições
- Verifique se os tipos de operadores correspondem aos tipos de dados das colunas
**Limites de Linhas e Performance**
- Fique atento aos limites de linhas ao usar `GOOGLE_SHEETS_GET_ROW`
- Considere paginação para grandes volumes de dados
- Use filtros específicos para reduzir a quantidade de dados processados
**Operações de Atualização**
- Certifique-se de que as condições de filtro identifiquem corretamente as linhas a serem atualizadas
- Teste condições de filtro com pequenos conjuntos de dados antes de grandes atualizações
- Verifique se todos os campos obrigatórios estão incluídos nas operações de atualização
@@ -312,5 +322,6 @@ crew.kickoff()
### Obtendo Ajuda
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas da integração com o Google Sheets.
Entre em contato com nosso time de suporte para auxílio na configuração ou
solução de problemas da integração com o Google Sheets.
</Card>

24
docs/pt-BR/enterprise/integrations/google_slides.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes criem, editem e gerenciem apresentações do Google Sli
Antes de usar a integração Google Slides, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Google com acesso ao Google Slides
- Conectado sua conta Google através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Google Slides, certifique-se de ter:
### 1. Conecte sua Conta Google
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Google Slides** 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 apresentações, planilhas e drive
@@ -36,7 +36,8 @@ 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.
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
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `title` (string, obrigatório): O título da apresentação.
</Accordion>
<Accordion title="google_slides/get_presentation">
@@ -65,6 +67,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `presentationId` (string, obrigatório): O ID da apresentação a ser recuperada.
- `fields` (string, opcional): Os campos a incluir na resposta. Use isso para melhorar o desempenho retornando apenas os dados necessários.
</Accordion>
<Accordion title="google_slides/batch_update_presentation">
@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `presentationId` (string, obrigatório): O ID da apresentação a ser atualizada.
- `requests` (array, obrigatório): Uma lista de atualizações a aplicar à apresentação. Cada item é um objeto representando uma solicitação.
- `writeControl` (object, opcional): Fornece controle sobre como as solicitações de escrita são executadas. Contém `requiredRevisionId` (string).
</Accordion>
<Accordion title="google_slides/get_page">
@@ -82,6 +86,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `presentationId` (string, obrigatório): O ID da apresentação.
- `pageObjectId` (string, obrigatório): O ID da página a ser recuperada.
</Accordion>
<Accordion title="google_slides/get_thumbnail">
@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `presentationId` (string, obrigatório): O ID da apresentação.
- `pageObjectId` (string, obrigatório): O ID da página para geração de miniatura.
</Accordion>
<Accordion title="google_slides/import_data_from_sheet">
@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `presentationId` (string, obrigatório): O ID da apresentação.
- `sheetId` (string, obrigatório): O ID da planilha do Google para importar.
- `dataRange` (string, obrigatório): O intervalo de dados a importar da planilha.
</Accordion>
<Accordion title="google_slides/upload_file_to_drive">
@@ -107,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file` (string, obrigatório): Os dados do arquivo a fazer upload.
- `presentationId` (string, obrigatório): O ID da apresentação para vincular o arquivo carregado.
</Accordion>
<Accordion title="google_slides/link_file_to_presentation">
@@ -115,6 +123,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `presentationId` (string, obrigatório): O ID da apresentação.
- `fileId` (string, obrigatório): O ID do arquivo a vincular.
</Accordion>
<Accordion title="google_slides/get_all_presentations">
@@ -123,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `pageSize` (integer, opcional): O número de apresentações a retornar por página.
- `pageToken` (string, opcional): Um token para paginação.
</Accordion>
<Accordion title="google_slides/delete_presentation">
@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `presentationId` (string, obrigatório): O ID da apresentação a ser excluída.
</Accordion>
</AccordionGroup>
@@ -225,18 +236,22 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Google tenha as permissões necessárias para acesso ao Google Slides e Google Drive.
- Verifique se a conexão OAuth inclui todos os escopos necessários.
**Problemas de ID de Apresentação/Página**
- Verifique novamente os IDs de apresentação e IDs de objeto de página para correção.
- Certifique-se de que a apresentação ou página existe e está acessível.
**Formatação de Solicitação de Atualização em Lote**
- Ao usar `batch_update_presentation`, certifique-se de que o array `requests` esteja formatado corretamente de acordo com a documentação da API do Google Slides.
- Atualizações complexas frequentemente requerem estruturas JSON específicas para cada tipo de solicitação (ex: `createText`, `insertShape`).
**Problemas de Upload/Vinculação de Arquivos**
- Certifique-se de que o conteúdo do `file` esteja fornecido corretamente para `upload_file_to_drive`.
- Verifique se o `fileId` está correto ao vincular arquivos a uma apresentação.
- Verifique as permissões do Google Drive para acesso a arquivos.
@@ -244,5 +259,6 @@ crew.kickoff()
### 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 Google Slides.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Google Slides.
</Card>

42
docs/pt-BR/enterprise/integrations/hubspot.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem empresas e contatos dentro do HubSpot. Crie n
Antes de utilizar a integração com o HubSpot, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa.
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa.
- Uma conta HubSpot com permissões adequadas.
- Sua conta HubSpot conectada pela [página de Integrações](https://app.crewai.com/crewai_plus/connectors).
@@ -21,7 +21,7 @@ Antes de utilizar a integração com o HubSpot, certifique-se de que você possu
### 1. Conecte Sua Conta HubSpot
1. Navegue até [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors).
1. Navegue até [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors).
2. Encontre **HubSpot** 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 gerenciamento de empresas e contatos.
@@ -36,7 +36,8 @@ 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.
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
@@ -115,6 +116,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `web_technologies` (string, opcional): Tecnologias web utilizadas. Deve ser um dos valores predefinidos.
- `website` (string, opcional): URL do site.
- `founded_year` (string, opcional): Ano de fundação.
</Accordion>
<Accordion title="hubspot/create_contact">
@@ -214,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `hs_whatsapp_phone_number` (string, opcional): Número do WhatsApp.
- `work_email` (string, opcional): E-mail corporativo.
- `hs_googleplusid` (string, opcional): googleplus ID.
</Accordion>
<Accordion title="hubspot/create_deal">
@@ -229,6 +232,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `dealtype` (string, opcional): Tipo do negócio. Valores disponíveis: `newbusiness`, `existingbusiness`.
- `description` (string, opcional): Descrição do negócio.
- `hs_priority` (string, opcional): Prioridade do negócio. Valores disponíveis: `low`, `medium`, `high`.
</Accordion>
<Accordion title="hubspot/create_record_engagements">
@@ -246,6 +250,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `hs_meeting_body` (string, opcional): Descrição da reunião. (Utilizado para `MEETING`)
- `hs_meeting_start_time` (string, opcional): Horário de início da reunião. (Utilizado para `MEETING`)
- `hs_meeting_end_time` (string, opcional): Horário de término da reunião. (Utilizado para `MEETING`)
</Accordion>
<Accordion title="hubspot/update_company">
@@ -263,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `numberofemployees` (number, opcional): Número de funcionários.
- `annualrevenue` (number, opcional): Receita anual.
- `description` (string, opcional): Descrição.
</Accordion>
<Accordion title="hubspot/create_record_any">
@@ -271,6 +277,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.
- Parâmetros adicionais dependem do esquema do objeto personalizado.
</Accordion>
<Accordion title="hubspot/update_contact">
@@ -285,6 +292,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `company` (string, opcional): Nome da empresa.
- `jobtitle` (string, opcional): Cargo.
- `lifecyclestage` (string, opcional): Estágio no ciclo de vida.
</Accordion>
<Accordion title="hubspot/update_deal">
@@ -298,6 +306,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `pipeline` (string, opcional): Pipeline ao qual o negócio pertence.
- `closedate` (string, opcional): Data prevista de fechamento.
- `dealtype` (string, opcional): Tipo de negócio.
</Accordion>
<Accordion title="hubspot/update_record_engagements">
@@ -309,6 +318,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `hs_task_subject` (string, opcional): Título da tarefa.
- `hs_task_body` (string, opcional): Notas da tarefa.
- `hs_task_status` (string, opcional): Status da tarefa.
</Accordion>
<Accordion title="hubspot/update_record_any">
@@ -318,6 +328,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `recordId` (string, obrigatório): ID do registro a ser atualizado.
- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.
- Parâmetros adicionais dependem do esquema do objeto personalizado.
</Accordion>
<Accordion title="hubspot/list_companies">
@@ -325,6 +336,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/list_contacts">
@@ -332,6 +344,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/list_deals">
@@ -339,6 +352,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/get_records_engagements">
@@ -347,6 +361,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `objectName` (string, obrigatório): O tipo de engajamento a ser buscado (ex.: "notes").
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/get_records_any">
@@ -355,6 +370,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): O ID do tipo de objeto personalizado.
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/get_company">
@@ -362,6 +378,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID da empresa a ser consultada.
</Accordion>
<Accordion title="hubspot/get_contact">
@@ -369,6 +386,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do contato a ser consultado.
</Accordion>
<Accordion title="hubspot/get_deal">
@@ -376,6 +394,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do negócio a ser consultado.
</Accordion>
<Accordion title="hubspot/get_record_by_id_engagements">
@@ -383,6 +402,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do engajamento a ser consultado.
</Accordion>
<Accordion title="hubspot/get_record_by_id_any">
@@ -391,6 +411,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.
- `recordId` (string, obrigatório): ID do registro a ser consultado.
</Accordion>
<Accordion title="hubspot/search_companies">
@@ -399,6 +420,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/search_contacts">
@@ -407,6 +429,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/search_deals">
@@ -415,6 +438,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `filterFormula` (object, opcional): Filtro em forma normal disjuntiva (OU de E).
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/search_records_engagements">
@@ -423,6 +447,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `engagementFilterFormula` (object, opcional): Filtro para engajamentos.
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/search_records_any">
@@ -432,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `recordType` (string, obrigatório): O ID do tipo de objeto para pesquisa.
- `filterFormula` (string, opcional): Fórmula de filtro a aplicar.
- `paginationParameters` (object, opcional): Use `pageCursor` para buscar páginas subsequentes.
</Accordion>
<Accordion title="hubspot/delete_record_companies">
@@ -439,6 +465,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID da empresa a ser excluída.
</Accordion>
<Accordion title="hubspot/delete_record_contacts">
@@ -446,6 +473,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do contato a ser excluído.
</Accordion>
<Accordion title="hubspot/delete_record_deals">
@@ -453,6 +481,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do negócio a ser excluído.
</Accordion>
<Accordion title="hubspot/delete_record_engagements">
@@ -460,6 +489,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do engajamento a ser excluído.
</Accordion>
<Accordion title="hubspot/delete_record_any">
@@ -468,6 +498,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): ID do tipo de objeto personalizado.
- `recordId` (string, obrigatório): ID do registro a ser excluído.
</Accordion>
<Accordion title="hubspot/get_contacts_by_list_id">
@@ -476,6 +507,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listId` (string, obrigatório): ID da lista da qual obter os contatos.
- `paginationParameters` (object, opcional): Use `pageCursor` para páginas subsequentes.
</Accordion>
<Accordion title="hubspot/describe_action_schema">
@@ -484,6 +516,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): ID do tipo de objeto (ex.: 'companies').
- `operation` (string, obrigatório): Tipo de operação (ex.: 'CREATE_RECORD').
</Accordion>
</AccordionGroup>
@@ -580,5 +613,6 @@ crew.kickoff()
### Precisa de Ajuda?
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência na configuração ou solução de problemas com a integração HubSpot.
Entre em contato com nossa equipe de suporte para assistência na configuração
ou solução de problemas com a integração HubSpot.
</Card>

25
docs/pt-BR/enterprise/integrations/jira.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem problemas, projetos e fluxos de trabalho pelo
Antes de usar a integração com o Jira, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Jira com permissões adequadas para o projeto
- Sua conta Jira conectada pela [Página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Jira, certifique-se de ter:
### 1. Conectar Sua Conta Jira
1. Acesse [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Jira** na seção de Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo do OAuth
4. Conceda as permissões necessárias para gestão de issues e projetos
@@ -54,6 +54,7 @@ uv add crewai-tools
"customfield_10001": "value"
}
```
</Accordion>
<Accordion title="jira/update_issue">
@@ -69,6 +70,7 @@ uv add crewai-tools
- Opções: `description`, `descriptionJSON`
- `description` (string, opcional): Descrição - Descrição detalhada da issue. Este campo aparece apenas se 'descriptionType' = 'description'.
- `additionalFields` (string, opcional): Campos Adicionais - Especifique outros campos em formato JSON.
</Accordion>
<Accordion title="jira/get_issue_by_key">
@@ -76,6 +78,7 @@ uv add crewai-tools
**Parâmetros:**
- `issueKey` (string, obrigatório): Chave da Issue (exemplo: "TEST-1234").
</Accordion>
<Accordion title="jira/filter_issues">
@@ -102,6 +105,7 @@ uv add crewai-tools
```
Operadores disponíveis: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`
- `limit` (string, opcional): Limitar resultados - Limite máximo de issues retornados. Padrão para 10 se estiver em branco.
</Accordion>
<Accordion title="jira/search_by_jql">
@@ -115,12 +119,14 @@ uv add crewai-tools
"pageCursor": "cursor_string"
}
```
</Accordion>
<Accordion title="jira/update_issue_any">
**Descrição:** Atualiza qualquer issue no Jira. Use DESCRIBE_ACTION_SCHEMA para obter o schema de propriedades dessa função.
**Parâmetros:** Nenhum parâmetro específico - use JIRA_DESCRIBE_ACTION_SCHEMA primeiro para obter o schema esperado.
</Accordion>
<Accordion title="jira/describe_action_schema">
@@ -130,6 +136,7 @@ uv add crewai-tools
- `issueTypeId` (string, obrigatório): ID do Tipo de Issue.
- `projectKey` (string, obrigatório): Chave do projeto.
- `operation` (string, obrigatório): Tipo de Operação, por exemplo CREATE_ISSUE ou UPDATE_ISSUE.
</Accordion>
<Accordion title="jira/get_projects">
@@ -142,6 +149,7 @@ uv add crewai-tools
"pageCursor": "cursor_string"
}
```
</Accordion>
<Accordion title="jira/get_issue_types_by_project">
@@ -149,12 +157,14 @@ uv add crewai-tools
**Parâmetros:**
- `project` (string, obrigatório): Chave do projeto.
</Accordion>
<Accordion title="jira/get_issue_types">
**Descrição:** Obtém todos os tipos de issues no Jira.
**Parâmetros:** Nenhum obrigatório.
</Accordion>
<Accordion title="jira/get_issue_status_by_project">
@@ -162,6 +172,7 @@ uv add crewai-tools
**Parâmetros:**
- `project` (string, obrigatório): Chave do projeto.
</Accordion>
<Accordion title="jira/get_all_assignees_by_project">
@@ -169,6 +180,7 @@ uv add crewai-tools
**Parâmetros:**
- `project` (string, obrigatório): Chave do projeto.
</Accordion>
</AccordionGroup>
@@ -337,31 +349,37 @@ crew.kickoff()
### Problemas Comuns
**Erros de Permissão**
- Certifique-se de que sua conta Jira tem as permissões necessárias nos projetos alvo
- Verifique se a conexão OAuth inclui os escopos necessários da API Jira
- Confira se você possui permissões de criar/editar issues nos projetos especificados
**Chaves de Projeto ou Issue Inválidas**
- Confira o formato das chaves dos projetos e issues (ex: "PROJ-123")
- Verifique se os projetos existem e são acessíveis pela sua conta
- Certifique-se de que chaves de issues referenciam issues existentes
**Problemas de Tipo ou Status de Issue**
- Use JIRA_GET_ISSUE_TYPES_BY_PROJECT para obter tipos válidos de issue para um projeto
- Use JIRA_GET_ISSUE_STATUS_BY_PROJECT para obter status válidos
- Certifique-se de que tipos e status de issue estão disponíveis no projeto alvo
**Problemas com Queries JQL**
- Teste as queries JQL na busca de issues do Jira antes de utilizar em chamadas de API
- Certifique-se de que os nomes dos campos em JQL estejam corretos e existam em sua instância do Jira
- Use a sintaxe correta de JQL para queries complexas
**Problemas com Campos Customizados e Schemas**
- Use JIRA_DESCRIBE_ACTION_SCHEMA para obter o schema correto para tipos de issues complexas
- Certifique-se de que os IDs dos campos customizados estão corretos (ex: "customfield_10001")
- Verifique se esses campos estão disponíveis no projeto e tipo de issue alvo
**Problemas de Fórmulas de Filtro**
- Garanta que as fórmulas de filtro sigam a estrutura JSON correta para forma normal disjuntiva
- Use apenas campos válidos conforme configuração do seu Jira
- Teste filtros simples antes de construir queries complexas com múltiplas condições
@@ -369,5 +387,6 @@ crew.kickoff()
### Obtenha Ajuda
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Jira.
Entre em contato com nosso time de suporte para obter assistência na
configuração ou solução de problemas da integração Jira.
</Card>

30
docs/pt-BR/enterprise/integrations/linear.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem issues, projetos e fluxos de trabalho de dese
Antes de utilizar a integração com o Linear, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa
- Uma conta Linear com permissões apropriadas no workspace
- Conectou sua conta Linear através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Linear, certifique-se de que você possui
### 1. Conecte sua Conta Linear
1. Navegue até [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue até [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Linear** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de issues e projetos
@@ -36,7 +36,8 @@ 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.
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
@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]
}
```
</Accordion>
<Accordion title="linear/update_issue">
@@ -90,6 +92,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"labelIds": ["a70bdf0f-530a-4887-857d-46151b52b47c"]
}
```
</Accordion>
<Accordion title="linear/get_issue_by_id">
@@ -97,6 +100,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser buscada. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/get_issue_by_issue_identifier">
@@ -104,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `externalId` (string, obrigatório): ID Externo - Especifique o identificador legível da issue a ser buscada. (exemplo: "ABC-1").
</Accordion>
<Accordion title="linear/search_issue">
@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
```
Campos disponíveis: `title`, `number`, `project`, `createdAt`
Operadores disponíveis: `$stringExactlyMatches`, `$stringDoesNotExactlyMatch`, `$stringIsIn`, `$stringIsNotIn`, `$stringStartsWith`, `$stringDoesNotStartWith`, `$stringEndsWith`, `$stringDoesNotEndWith`, `$stringContains`, `$stringDoesNotContain`, `$stringGreaterThan`, `$stringLessThan`, `$numberGreaterThanOrEqualTo`, `$numberLessThanOrEqualTo`, `$numberGreaterThan`, `$numberLessThan`, `$dateTimeAfter`, `$dateTimeBefore`
</Accordion>
<Accordion title="linear/delete_issue">
@@ -138,6 +144,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser excluída. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/archive_issue">
@@ -145,6 +152,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `issueId` (string, obrigatório): ID da Issue - Especifique o ID do registro da issue a ser arquivada. (exemplo: "90fbc706-18cd-42c9-ae66-6bd344cc8977").
</Accordion>
<Accordion title="linear/create_sub_issue">
@@ -161,6 +169,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"lead": "linear_user_id"
}
```
</Accordion>
<Accordion title="linear/create_project">
@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"description": ""
}
```
</Accordion>
<Accordion title="linear/update_project">
@@ -199,6 +209,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
"description": ""
}
```
</Accordion>
<Accordion title="linear/get_project_by_id">
@@ -206,6 +217,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `projectId` (string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser buscado. (exemplo: "a6634484-6061-4ac7-9739-7dc5e52c796b").
</Accordion>
<Accordion title="linear/delete_project">
@@ -213,6 +225,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `projectId` (string, obrigatório): ID do Projeto - Especifique o ID do projeto a ser excluído. (exemplo: "a6634484-6061-4ac7-9739-7dc5e52c796b").
</Accordion>
<Accordion title="linear/search_teams">
@@ -238,6 +251,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
```
Campos disponíveis: `id`, `name`
</Accordion>
</AccordionGroup>
@@ -406,37 +420,44 @@ crew.kickoff()
### Problemas Comuns
**Erros de Permissão**
- Certifique-se de que sua conta Linear possui as permissões necessárias no workspace de destino
- Verifique se a conexão OAuth inclui os escopos requeridos pela API do Linear
- Confirme se você tem permissões para criar/editar issues e projetos no workspace
**IDs e Referências Inválidas**
- Verifique os IDs de equipes, IDs de issues e IDs de projetos para garantir o formato UUID correto
- Assegure que as entidades referenciadas (equipes, projetos, ciclos) existem e estão acessíveis
- Verifique se os identificadores de issues seguem o formato correto (ex: "ABC-1")
**Problemas de Associação entre Equipe e Projeto**
- Use LINEAR_SEARCH_TEAMS para obter IDs de equipe válidos antes de criar issues ou projetos
- Certifique-se de que as equipes existem e estão ativas no seu workspace
- Verifique se os IDs das equipes estão devidamente formatados como UUIDs
**Problemas com Status e Prioridade das Issues**
- Verifique se os IDs de status referenciam estados de workflow válidos para a equipe
- Certifique-se de que os valores de prioridade estão dentro do intervalo válido para sua configuração do Linear
- Confirme que campos personalizados e labels existem antes de referenciá-los
**Problemas com Formato de Data e Hora**
- Use o formato ISO 8601 para datas de vencimento e timestamps
- Certifique-se de que os fusos horários estão corretos para cálculos de datas de vencimento
- Verifique se os valores de data são válidos e posteriores à data atual para datas de vencimento
**Problemas de Pesquisa e Filtros**
- Garanta que as consultas de busca estejam formatadas corretamente e não estejam vazias
- Utilize nomes de campos válidos nas fórmulas de filtro: `title`, `number`, `project`, `createdAt`
- Teste filtros simples antes de montar consultas complexas com múltiplas condições
- Verifique se os tipos de operadores correspondem aos tipos de dados dos campos filtrados
**Problemas na Criação de Sub-issues**
- Certifique-se de que os IDs das issues pai são válidos e acessíveis
- Verifique se o ID da equipe para as sub-issues corresponde ou é compatível com o da issue pai
- Assegure-se de que as issues pai não estejam arquivadas ou excluídas
@@ -444,5 +465,6 @@ crew.kickoff()
### 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 na configuração ou solução de problemas da integração com o Linear.
Entre em contato com nossa equipe de suporte para assistência na configuração
ou solução de problemas da integração com o Linear.
</Card>

28
docs/pt-BR/enterprise/integrations/microsoft_excel.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes criem e gerenciem pastas de trabalho, planilhas, tabela
Antes de usar a integração Microsoft Excel, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Microsoft 365 com acesso ao Excel e OneDrive/SharePoint
- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Excel, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Microsoft Excel** 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 e pastas de trabalho do Excel
@@ -36,7 +36,8 @@ 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.
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
@@ -58,6 +59,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_path` (string, obrigatório): Caminho onde criar a pasta de trabalho (ex: 'MinhaPastaDeTrabalho.xlsx')
- `worksheets` (array, opcional): Planilhas iniciais para criar. Cada item é um objeto com `name` (string, nome da planilha).
</Accordion>
<Accordion title="microsoft_excel/get_workbooks">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `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_excel/get_worksheets">
@@ -81,6 +84,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `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_excel/create_worksheet">
@@ -89,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `name` (string, obrigatório): Nome da nova planilha.
</Accordion>
<Accordion title="microsoft_excel/get_range_data">
@@ -98,6 +103,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `range` (string, obrigatório): Endereço do intervalo (ex: 'A1:C10').
</Accordion>
<Accordion title="microsoft_excel/update_range_data">
@@ -108,6 +114,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `range` (string, obrigatório): Endereço do intervalo (ex: 'A1:C10').
- `values` (array, obrigatório): Array 2D de valores para definir no intervalo. Cada array interno representa uma linha, e elementos podem ser string, number ou integer.
</Accordion>
<Accordion title="microsoft_excel/add_table">
@@ -118,6 +125,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `range` (string, obrigatório): Intervalo para a tabela (ex: 'A1:D10').
- `has_headers` (boolean, opcional): Se a primeira linha contém cabeçalhos. Padrão: true.
</Accordion>
<Accordion title="microsoft_excel/get_tables">
@@ -126,6 +134,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha.
</Accordion>
<Accordion title="microsoft_excel/add_table_row">
@@ -136,6 +145,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `table_name` (string, obrigatório): Nome da tabela.
- `values` (array, obrigatório): Array de valores para a nova linha. Elementos podem ser string, number ou integer.
</Accordion>
<Accordion title="microsoft_excel/create_chart">
@@ -147,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `chart_type` (string, obrigatório): Tipo de gráfico (ex: 'ColumnClustered', 'Line', 'Pie').
- `source_data` (string, obrigatório): Intervalo de dados para o gráfico (ex: 'A1:B10').
- `series_by` (string, opcional): Como interpretar os dados ('Auto', 'Columns' ou 'Rows'). Padrão: 'Auto'.
</Accordion>
<Accordion title="microsoft_excel/get_cell">
@@ -157,6 +168,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `row` (integer, obrigatório): Número da linha (baseado em 0).
- `column` (integer, obrigatório): Número da coluna (baseado em 0).
</Accordion>
<Accordion title="microsoft_excel/get_used_range">
@@ -165,6 +177,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha.
</Accordion>
<Accordion title="microsoft_excel/list_charts">
@@ -173,6 +186,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha.
</Accordion>
<Accordion title="microsoft_excel/delete_worksheet">
@@ -181,6 +195,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha a excluir.
</Accordion>
<Accordion title="microsoft_excel/delete_table">
@@ -190,6 +205,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `file_id` (string, obrigatório): O ID do arquivo Excel.
- `worksheet_name` (string, obrigatório): Nome da planilha.
- `table_name` (string, obrigatório): Nome da tabela a excluir.
</Accordion>
<Accordion title="microsoft_excel/list_names">
@@ -197,6 +213,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do arquivo Excel.
</Accordion>
</AccordionGroup>
@@ -236,15 +253,18 @@ crew.kickoff()
### 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 pastas de trabalho, certifique-se de que o `file_path` termine com extensão `.xlsx`.
- 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 Excel.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Microsoft Excel.
</Card>

23
docs/pt-BR/enterprise/integrations/microsoft_onedrive.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes façam upload, download e gerenciem arquivos e pastas n
Antes de usar a integração Microsoft OneDrive, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Microsoft com acesso ao OneDrive
- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft OneDrive, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Microsoft OneDrive** 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
@@ -36,7 +36,8 @@ 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.
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
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `top` (integer, opcional): Número de itens a recuperar (máx 1000). Padrão: 50.
- `orderby` (string, opcional): Ordenar por campo (ex: "name asc", "lastModifiedDateTime desc"). Padrão: "name asc".
- `filter` (string, opcional): Expressão de filtro OData.
</Accordion>
<Accordion title="microsoft_onedrive/get_file_info">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `item_id` (string, obrigatório): O ID do arquivo ou pasta.
</Accordion>
<Accordion title="microsoft_onedrive/download_file">
@@ -73,6 +76,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `item_id` (string, obrigatório): O ID do arquivo a baixar.
</Accordion>
<Accordion title="microsoft_onedrive/upload_file">
@@ -81,6 +85,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_name` (string, obrigatório): Nome do arquivo a fazer upload.
- `content` (string, obrigatório): Conteúdo do arquivo codificado em Base64.
</Accordion>
<Accordion title="microsoft_onedrive/create_folder">
@@ -88,6 +93,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `folder_name` (string, obrigatório): Nome da pasta a criar.
</Accordion>
<Accordion title="microsoft_onedrive/delete_item">
@@ -95,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `item_id` (string, obrigatório): O ID do arquivo ou pasta a excluir.
</Accordion>
<Accordion title="microsoft_onedrive/copy_item">
@@ -104,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `item_id` (string, obrigatório): O ID do arquivo ou pasta a copiar.
- `parent_id` (string, opcional): O ID da pasta de destino (opcional, padrão para raiz).
- `new_name` (string, opcional): Novo nome para o item copiado (opcional).
</Accordion>
<Accordion title="microsoft_onedrive/move_item">
@@ -113,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `item_id` (string, obrigatório): O ID do arquivo ou pasta a mover.
- `parent_id` (string, obrigatório): O ID da pasta de destino.
- `new_name` (string, opcional): Novo nome para o item (opcional).
</Accordion>
<Accordion title="microsoft_onedrive/search_files">
@@ -121,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `query` (string, obrigatório): String de consulta de pesquisa.
- `top` (integer, opcional): Número de resultados a retornar (máx 1000). Padrão: 50.
</Accordion>
<Accordion title="microsoft_onedrive/share_item">
@@ -130,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `item_id` (string, obrigatório): O ID do arquivo ou pasta a compartilhar.
- `type` (string, opcional): Tipo de link de compartilhamento. Opções: view, edit, embed. Padrão: view.
- `scope` (string, opcional): Escopo do link de compartilhamento. Opções: anonymous, organization. Padrão: anonymous.
</Accordion>
<Accordion title="microsoft_onedrive/get_thumbnails">
@@ -137,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `item_id` (string, obrigatório): O ID do arquivo.
</Accordion>
</AccordionGroup>
@@ -176,10 +188,12 @@ crew.kickoff()
### 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`, `Files.ReadWrite`).
- Verifique se a conexão OAuth inclui todos os escopos necessários.
**Problemas de Upload de Arquivos**
- Certifique-se de que `file_name` e `content` sejam fornecidos para uploads de arquivos.
- O conteúdo deve ser codificado em Base64 para arquivos binários.
- Verifique se você tem permissões de escrita no OneDrive.
@@ -187,5 +201,6 @@ crew.kickoff()
### 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 OneDrive.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Microsoft OneDrive.
</Card>

18
docs/pt-BR/enterprise/integrations/microsoft_outlook.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem emails, eventos de calendário e co
Antes de usar a integração Microsoft Outlook, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Microsoft com acesso ao Outlook
- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Outlook, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Microsoft Outlook** 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 email, calendário e contatos
@@ -36,7 +36,8 @@ 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.
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
@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `orderby` (string, opcional): Ordenar por campo (ex: "receivedDateTime desc"). Padrão: "receivedDateTime desc".
- `select` (string, opcional): Selecionar propriedades específicas para retornar.
- `expand` (string, opcional): Expandir recursos relacionados inline.
</Accordion>
<Accordion title="microsoft_outlook/send_email">
@@ -77,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `importance` (string, opcional): Nível de importância da mensagem. Opções: low, normal, high. Padrão: normal.
- `reply_to` (array, opcional): Array de endereços de email para resposta.
- `save_to_sent_items` (boolean, opcional): Se deve salvar a mensagem na pasta Itens Enviados. Padrão: true.
</Accordion>
<Accordion title="microsoft_outlook/get_calendar_events">
@@ -87,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `skip` (integer, opcional): Número de eventos a pular. Padrão: 0.
- `filter` (string, opcional): Expressão de filtro OData (ex: "start/dateTime ge '2024-01-01T00:00:00Z'").
- `orderby` (string, opcional): Ordenar por campo (ex: "start/dateTime asc"). Padrão: "start/dateTime asc".
</Accordion>
<Accordion title="microsoft_outlook/create_calendar_event">
@@ -100,6 +104,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `timezone` (string, opcional): Fuso horário (ex: 'Pacific Standard Time'). Padrão: UTC.
- `location` (string, opcional): Local do evento.
- `attendees` (array, opcional): Array de endereços de email dos participantes.
</Accordion>
<Accordion title="microsoft_outlook/get_contacts">
@@ -110,6 +115,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `skip` (integer, opcional): Número de contatos a pular. Padrão: 0.
- `filter` (string, opcional): Expressão de filtro OData.
- `orderby` (string, opcional): Ordenar por campo (ex: "displayName asc"). Padrão: "displayName asc".
</Accordion>
<Accordion title="microsoft_outlook/create_contact">
@@ -124,6 +130,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `homePhones` (array, opcional): Array de números de telefone residenciais.
- `jobTitle` (string, opcional): Cargo do contato.
- `companyName` (string, opcional): Nome da empresa do contato.
</Accordion>
</AccordionGroup>
@@ -163,15 +170,18 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a email, calendário e contatos.
- Escopos necessários incluem: `Mail.Read`, `Mail.Send`, `Calendars.Read`, `Calendars.ReadWrite`, `Contacts.Read`, `Contacts.ReadWrite`.
**Problemas de Envio de Email**
- Certifique-se de que `to_recipients`, `subject` e `body` sejam fornecidos para `send_email`.
- Verifique se os endereços de email estão formatados corretamente.
### 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 Outlook.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Microsoft Outlook.
</Card>

23
docs/pt-BR/enterprise/integrations/microsoft_sharepoint.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes acessem e gerenciem sites, listas e bibliotecas de docu
Antes de usar a integração Microsoft SharePoint, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Microsoft com acesso ao SharePoint
- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft SharePoint, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Microsoft SharePoint** 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 sites e arquivos do SharePoint
@@ -36,7 +36,8 @@ 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.
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
@@ -63,6 +64,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `top` (integer, opcional): Número de itens a retornar (mín 1, máx 999).
- `skip` (integer, opcional): Número de itens a pular (mín 0).
- `orderby` (string, opcional): Ordenar resultados por propriedades especificadas (ex: 'displayName desc').
</Accordion>
<Accordion title="microsoft_sharepoint/get_site">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `select` (string, opcional): Selecionar propriedades específicas para retornar (ex: 'displayName,id,webUrl,drives').
- `expand` (string, opcional): Expandir recursos relacionados inline (ex: 'drives,lists').
</Accordion>
<Accordion title="microsoft_sharepoint/get_site_lists">
@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `site_id` (string, obrigatório): O ID do site do SharePoint.
</Accordion>
<Accordion title="microsoft_sharepoint/get_list">
@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `list_id` (string, obrigatório): O ID da lista.
</Accordion>
<Accordion title="microsoft_sharepoint/get_list_items">
@@ -96,6 +101,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `list_id` (string, obrigatório): O ID da lista.
- `expand` (string, opcional): Expandir dados relacionados (ex: 'fields').
</Accordion>
<Accordion title="microsoft_sharepoint/create_list_item">
@@ -105,6 +111,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `list_id` (string, obrigatório): O ID da lista.
- `fields` (object, obrigatório): Os valores de campo para o novo item.
</Accordion>
<Accordion title="microsoft_sharepoint/update_list_item">
@@ -115,6 +122,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `list_id` (string, obrigatório): O ID da lista.
- `item_id` (string, obrigatório): O ID do item a atualizar.
- `fields` (object, obrigatório): Os valores de campo a atualizar.
</Accordion>
<Accordion title="microsoft_sharepoint/delete_list_item">
@@ -124,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `list_id` (string, obrigatório): O ID da lista.
- `item_id` (string, obrigatório): O ID do item a excluir.
</Accordion>
<Accordion title="microsoft_sharepoint/upload_file_to_library">
@@ -133,6 +142,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `file_path` (string, obrigatório): O caminho onde fazer upload do arquivo (ex: 'pasta/nomeDoArquivo.txt').
- `content` (string, obrigatório): O conteúdo do arquivo a fazer upload.
</Accordion>
<Accordion title="microsoft_sharepoint/get_drive_items">
@@ -140,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `site_id` (string, obrigatório): O ID do site do SharePoint.
</Accordion>
<Accordion title="microsoft_sharepoint/delete_drive_item">
@@ -148,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `site_id` (string, obrigatório): O ID do site do SharePoint.
- `item_id` (string, obrigatório): O ID do arquivo ou pasta a excluir.
</Accordion>
</AccordionGroup>
@@ -187,15 +199,18 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso ao SharePoint (ex: `Sites.Read.All`, `Sites.ReadWrite.All`).
- Verifique se a conexão OAuth inclui todos os escopos necessários.
**Problemas de ID de Site/Lista/Item**
- Verifique novamente os IDs de site, lista e item para correção.
- Certifique-se de que os recursos referenciados existem e estão acessíveis.
### 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 SharePoint.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Microsoft SharePoint.
</Card>

18
docs/pt-BR/enterprise/integrations/microsoft_teams.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes acessem dados do Teams, enviem mensagens, criem reuniõ
Antes de usar a integração Microsoft Teams, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Microsoft com acesso ao Teams
- Conectado sua conta Microsoft através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Teams, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Navegue para [Integrações CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Microsoft Teams** 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 ao Teams
@@ -36,7 +36,8 @@ 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.
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
@@ -57,6 +58,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- Nenhum parâmetro necessário.
</Accordion>
<Accordion title="microsoft_teams/get_channels">
@@ -64,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `team_id` (string, obrigatório): O ID da equipe.
</Accordion>
<Accordion title="microsoft_teams/send_message">
@@ -74,6 +77,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `channel_id` (string, obrigatório): O ID do canal.
- `message` (string, obrigatório): O conteúdo da mensagem.
- `content_type` (string, opcional): Tipo de conteúdo (html ou text). Opções: html, text. Padrão: text.
</Accordion>
<Accordion title="microsoft_teams/get_messages">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `team_id` (string, obrigatório): O ID da equipe.
- `channel_id` (string, obrigatório): O ID do canal.
- `top` (integer, opcional): Número de mensagens a recuperar (máx 50). Padrão: 20.
</Accordion>
<Accordion title="microsoft_teams/create_meeting">
@@ -92,6 +97,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `subject` (string, obrigatório): Assunto/título da reunião.
- `startDateTime` (string, obrigatório): Hora de início da reunião (formato ISO 8601 com fuso horário).
- `endDateTime` (string, obrigatório): Hora de término da reunião (formato ISO 8601 com fuso horário).
</Accordion>
<Accordion title="microsoft_teams/search_online_meetings_by_join_url">
@@ -99,6 +105,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `join_web_url` (string, obrigatório): A URL de participação na web da reunião a pesquisar.
</Accordion>
</AccordionGroup>
@@ -138,15 +145,18 @@ crew.kickoff()
### Problemas Comuns
**Erros de Autenticação**
- Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso ao Teams.
- Escopos necessários incluem: `Team.ReadBasic.All`, `Channel.ReadBasic.All`, `ChannelMessage.Send`, `ChannelMessage.Read.All`, `OnlineMeetings.ReadWrite`, `OnlineMeetings.Read`.
**Acesso a Equipes e Canais**
- Certifique-se de que você é membro das equipes que está tentando acessar.
- Verifique novamente os IDs de equipe e canal para correção.
### 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 Teams.
Entre em contato com nossa equipe de suporte para assistência com configuração
ou solução de problemas da integração Microsoft Teams.
</Card>

17
docs/pt-BR/enterprise/integrations/microsoft_word.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes criem, leiam e gerenciem documentos do Word e arquivos
Antes de usar a integração Microsoft Word, certifique-se de ter:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- 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)
@@ -21,7 +21,7 @@ Antes de usar a integração Microsoft Word, certifique-se de ter:
### 1. Conecte sua Conta Microsoft
1. Navegue para [Integrações CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
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
@@ -36,7 +36,8 @@ 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.
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
@@ -61,6 +62,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `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">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**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">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do documento.
</Accordion>
<Accordion title="microsoft_word/get_document_properties">
@@ -83,6 +87,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do documento.
</Accordion>
<Accordion title="microsoft_word/delete_document">
@@ -90,6 +95,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `file_id` (string, obrigatório): O ID do documento a excluir.
</Accordion>
</AccordionGroup>
@@ -129,15 +135,18 @@ crew.kickoff()
### 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.
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>

27
docs/pt-BR/enterprise/integrations/notion.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem páginas, bancos de dados e conteúdos atrav
Antes de usar a integração com o Notion, certifique-se de que você tem:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Notion com permissões adequadas no workspace
- Sua conta Notion conectada através da [página de Integrações](https://app.crewai.com/crewai_plus/connectors)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Notion, certifique-se de que você tem:
### 1. Conecte sua Conta Notion
1. Acesse [Integrações do CrewAI AOP](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [Integrações do CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. Procure por **Notion** na seção de Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo de OAuth
4. Conceda as permissões necessárias para gerenciamento de páginas e bancos de dados
@@ -36,7 +36,8 @@ 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.
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
@@ -107,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/update_page">
@@ -141,6 +143,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/get_page_by_id">
@@ -148,6 +151,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `pageId` (string, obrigatório): Page ID - Especifique o ID da Página a ser buscada. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/archive_page">
@@ -155,6 +159,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `pageId` (string, obrigatório): Page ID - Especifique o ID da Página a ser arquivada. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/search_pages">
@@ -180,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
```
Campos disponíveis: `query`, `filter.value`, `direction`, `page_size`
</Accordion>
<Accordion title="notion/get_page_content">
@@ -187,6 +193,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `blockId` (string, obrigatório): Page ID - Especifique o ID de um Bloco ou Página para receber todos os seus blocos filhos na ordem correta. (exemplo: "59833787-2cf9-4fdf-8782-e53db20768a5").
</Accordion>
<Accordion title="notion/update_block">
@@ -274,6 +281,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
}
}
```
</Accordion>
<Accordion title="notion/get_block_by_id">
@@ -281,6 +289,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `blockId` (string, obrigatório): Block ID - Especifique o ID do Bloco a ser buscado. (exemplo: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").
</Accordion>
<Accordion title="notion/delete_block">
@@ -288,6 +297,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `blockId` (string, obrigatório): Block ID - Especifique o ID do Bloco a ser excluído. (exemplo: "9bc30ad4-9373-46a5-84ab-0a7845ee52e6").
</Accordion>
</AccordionGroup>
@@ -452,41 +462,49 @@ crew.kickoff()
### Problemas Comuns
**Erros de Permissão**
- Certifique-se de que sua conta Notion possui acesso de edição ao workspace desejado
- Verifique se a conexão OAuth inclui os escopos necessários para a API do Notion
- Confira se as páginas e bancos de dados estão compartilhados com a integração autenticada
**IDs de Página e Bloco Inválidos**
- Revise os IDs de página e bloco para garantir que estejam no formato UUID correto
- Garanta que as páginas e blocos referenciados existem e são acessíveis
- Verifique se os IDs da página ou banco de dados pai são válidos ao criar novas páginas
**Problemas com Schema de Propriedades**
- Assegure que as propriedades da página correspondem ao schema do banco de dados ao criar páginas em bancos de dados
- Verifique se os nomes e tipos das propriedades estão corretos para o banco de dados alvo
- Confirme que as propriedades obrigatórias estão incluídas ao criar ou atualizar páginas
**Estrutura dos Blocos de Conteúdo**
- Assegure que o conteúdo dos blocos segue as especificações de rich text do Notion
- Verifique se estruturas aninhadas de blocos estão devidamente formatadas
- Confira se URLs de mídias são acessíveis e estão corretamente formatadas
**Problemas de Pesquisa e Filtros**
- Certifique-se de que as queries de pesquisa estão devidamente formatadas e não estão vazias
- Use nomes de campos válidos em fórmulas de filtro: `query`, `filter.value`, `direction`, `page_size`
- Teste pesquisas simples antes de construir condições de filtro mais complexas
**Relacionamentos Pai-Filho**
- Verifique se a página ou banco de dados pai existe antes de criar páginas filhas
- Assegure que existam permissões apropriadas para o container pai
- Confirme que os schemas do banco permitem definir as propriedades desejadas
**Rich Text e Conteúdo de Mídia**
- Assegure que URLs para imagens externas, PDFs e bookmarks sejam acessíveis
- Verifique se a formatação rich text segue as especificações da API do Notion
- Confira se os tipos de linguagem nos blocos de código são suportados pelo Notion
**Operações de Arquivamento e Exclusão**
- Entenda a diferença entre arquivar (reversível) e excluir (permanente)
- Certifique-se de ter permissões para arquivar ou excluir o conteúdo desejado
- Tenha cuidado com operações em massa que possam afetar múltiplas páginas ou blocos
@@ -494,5 +512,6 @@ crew.kickoff()
### Obtendo Ajuda
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas com a integração Notion.
Entre em contato com nosso time de suporte para auxílio na configuração ou
solução de problemas com a integração Notion.
</Card>

49
docs/pt-BR/enterprise/integrations/salesforce.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem relacionamentos com clientes, processos de ve
Antes de usar a integração Salesforce, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Uma conta Salesforce com permissões apropriadas
- Sua conta Salesforce conectada via a [página de Integrações](https://app.crewai.com/integrations)
@@ -21,7 +21,7 @@ Antes de usar a integração Salesforce, certifique-se de que você possui:
### 1. Conecte sua Conta Salesforce
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Salesforce** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de CRM e vendas
@@ -36,7 +36,8 @@ 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.
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
@@ -65,6 +66,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Title` (string, opcional): Cargo do contato, como CEO ou Vice-presidente
- `Description` (string, opcional): Descrição do contato
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato
</Accordion>
<Accordion title="salesforce/create_record_lead">
@@ -81,6 +83,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Status` (string, opcional): Status do Lead - Use as Configurações de Workflow do Connect Portal para selecionar o status do Lead
- `Description` (string, opcional): Descrição do lead
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead
</Accordion>
<Accordion title="salesforce/create_record_opportunity">
@@ -96,6 +99,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `OwnerId` (string, opcional): Usuário Salesforce designado para esta Oportunidade
- `NextStep` (string, opcional): Descrição da próxima tarefa no fechamento da Oportunidade
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade
</Accordion>
<Accordion title="salesforce/create_record_task">
@@ -114,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `isReminderSet` (boolean, opcional): Se o lembrete está definido
- `reminderDateTime` (string, opcional): Data/Hora do lembrete no formato ISO
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa
</Accordion>
<Accordion title="salesforce/create_record_account">
@@ -126,12 +131,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Phone` (string, opcional): Número de telefone
- `Description` (string, opcional): Descrição da conta
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta
</Accordion>
<Accordion title="salesforce/create_record_any">
**Descrição:** Crie um registro de qualquer tipo de objeto no Salesforce.
**Nota:** Esta é uma ferramenta flexível para criar registros de tipos de objetos personalizados ou desconhecidos.
</Accordion>
</AccordionGroup>
@@ -150,6 +157,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Title` (string, opcional): Cargo do contato
- `Description` (string, opcional): Descrição do contato
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Contato
</Accordion>
<Accordion title="salesforce/update_record_lead">
@@ -167,6 +175,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Status` (string, opcional): Status do Lead
- `Description` (string, opcional): Descrição do lead
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Lead
</Accordion>
<Accordion title="salesforce/update_record_opportunity">
@@ -183,6 +192,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `OwnerId` (string, opcional): Usuário Salesforce responsável por esta Oportunidade
- `NextStep` (string, opcional): Descrição da próxima tarefa no fechamento da Oportunidade
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Oportunidade
</Accordion>
<Accordion title="salesforce/update_record_task">
@@ -201,6 +211,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `isReminderSet` (boolean, opcional): Se o lembrete está definido
- `reminderDateTime` (string, opcional): Data/Hora do lembrete em formato ISO
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Tarefa
</Accordion>
<Accordion title="salesforce/update_record_account">
@@ -214,12 +225,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `Phone` (string, opcional): Número de telefone
- `Description` (string, opcional): Descrição da conta
- `additionalFields` (object, opcional): Campos adicionais no formato JSON para campos personalizados de Conta
</Accordion>
<Accordion title="salesforce/update_record_any">
**Descrição:** Atualize um registro de qualquer tipo de objeto no Salesforce.
**Nota:** Esta é uma ferramenta flexível para atualizar registros de tipos de objetos personalizados ou desconhecidos.
</Accordion>
</AccordionGroup>
@@ -231,6 +244,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do registro do Contato
</Accordion>
<Accordion title="salesforce/get_record_by_id_lead">
@@ -238,6 +252,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do registro do Lead
</Accordion>
<Accordion title="salesforce/get_record_by_id_opportunity">
@@ -245,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do registro da Oportunidade
</Accordion>
<Accordion title="salesforce/get_record_by_id_task">
@@ -252,6 +268,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do registro da Tarefa
</Accordion>
<Accordion title="salesforce/get_record_by_id_account">
@@ -259,6 +276,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordId` (string, obrigatório): ID do registro da Conta
</Accordion>
<Accordion title="salesforce/get_record_by_id_any">
@@ -267,6 +285,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `recordType` (string, obrigatório): Tipo do registro (ex.: "CustomObject__c")
- `recordId` (string, obrigatório): ID do registro
</Accordion>
</AccordionGroup>
@@ -282,6 +301,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/search_records_lead">
@@ -293,6 +313,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/search_records_opportunity">
@@ -304,6 +325,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/search_records_task">
@@ -315,6 +337,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/search_records_account">
@@ -326,6 +349,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `sortDirection` (string, opcional): Direção da ordenação - Opções: ASC, DESC
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/search_records_any">
@@ -336,6 +360,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `filterFormula` (string, opcional): Critérios de busca por filtro
- `includeAllFields` (boolean, opcional): Incluir todos os campos nos resultados
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
</AccordionGroup>
@@ -348,6 +373,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_lead">
@@ -356,6 +382,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_opportunity">
@@ -364,6 +391,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_task">
@@ -372,6 +400,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_account">
@@ -380,6 +409,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_any">
@@ -389,6 +419,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `recordType` (string, obrigatório): Tipo do registro
- `listViewId` (string, obrigatório): ID do List View
- `paginationParameters` (object, opcional): Configurações de paginação com pageCursor
</Accordion>
</AccordionGroup>
@@ -409,6 +440,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `description` (string, opcional): Descrição do campo
- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse
- `defaultFieldValue` (string, opcional): Valor padrão do campo
</Accordion>
<Accordion title="salesforce/create_custom_field_lead">
@@ -425,6 +457,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `description` (string, opcional): Descrição do campo
- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse
- `defaultFieldValue` (string, opcional): Valor padrão do campo
</Accordion>
<Accordion title="salesforce/create_custom_field_opportunity">
@@ -441,6 +474,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `description` (string, opcional): Descrição do campo
- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse
- `defaultFieldValue` (string, opcional): Valor padrão do campo
</Accordion>
<Accordion title="salesforce/create_custom_field_task">
@@ -457,6 +491,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `description` (string, opcional): Descrição do campo
- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse
- `defaultFieldValue` (string, opcional): Valor padrão do campo
</Accordion>
<Accordion title="salesforce/create_custom_field_account">
@@ -473,12 +508,14 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `description` (string, opcional): Descrição do campo
- `helperText` (string, opcional): Texto de ajuda exibido ao passar o mouse
- `defaultFieldValue` (string, opcional): Valor padrão do campo
</Accordion>
<Accordion title="salesforce/create_custom_field_any">
**Descrição:** Crie campos personalizados para qualquer tipo de objeto.
**Nota:** Esta é uma ferramenta flexível para criar campos personalizados para tipos de objetos personalizados ou desconhecidos.
</Accordion>
</AccordionGroup>
@@ -490,6 +527,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `query` (string, obrigatório): Consulta SOQL (ex.: "SELECT Id, Name FROM Account WHERE Name = 'Exemplo'")
</Accordion>
<Accordion title="salesforce/create_custom_object">
@@ -500,6 +538,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `pluralLabel` (string, obrigatório): Rótulo plural (ex.: "Contas")
- `description` (string, opcional): Uma descrição do Objeto Personalizado
- `recordName` (string, obrigatório): Nome do registro exibido em layouts e buscas (ex.: "Nome da Conta")
</Accordion>
<Accordion title="salesforce/describe_action_schema">
@@ -510,6 +549,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `operation` (string, obrigatório): Tipo de Operação (ex.: "CREATE_RECORD" ou "UPDATE_RECORD")
**Nota:** Use esta função primeiro ao trabalhar com objetos personalizados para entender seu schema antes de realizar operações.
</Accordion>
</AccordionGroup>
@@ -644,5 +684,6 @@ Esta documentação abrangente cobre todas as ferramentas Salesforce organizadas
### Precisa de ajuda?
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência na configuração da integração com Salesforce ou para resolução de problemas.
Entre em contato com nossa equipe de suporte para assistência na configuração
da integração com Salesforce ou para resolução de problemas.
</Card>

24
docs/pt-BR/enterprise/integrations/shopify.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem operações de e-commerce através do Shopify
Antes de utilizar a integração com o Shopify, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa
- Uma loja Shopify com permissões administrativas adequadas
- Sua loja Shopify conectada através da [página de Integrações](https://app.crewai.com/integrations)
@@ -21,7 +21,7 @@ Antes de utilizar a integração com o Shopify, certifique-se de que você possu
### 1. Conecte sua Loja Shopify
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Shopify** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de loja e produtos
@@ -36,7 +36,8 @@ 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.
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
@@ -64,6 +65,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `updatedAtMin` (string, opcional): Retorna somente clientes atualizados após esta data (ISO ou timestamp Unix)
- `updatedAtMax` (string, opcional): Retorna somente clientes atualizados antes desta data (ISO ou timestamp Unix)
- `limit` (string, opcional): Número máximo de clientes a retornar (padrão 250)
</Accordion>
<Accordion title="shopify/search_customers">
@@ -72,6 +74,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `filterFormula` (object, opcional): Filtro avançado em forma normal disjuntiva com operadores específicos de campo
- `limit` (string, opcional): Número máximo de clientes a retornar (padrão 250)
</Accordion>
<Accordion title="shopify/create_customer">
@@ -93,6 +96,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `note` (string, opcional): Observação sobre o cliente
- `sendEmailInvite` (boolean, opcional): Se deve enviar convite por e-mail
- `metafields` (object, opcional): Metacampos adicionais em formato JSON
</Accordion>
<Accordion title="shopify/update_customer">
@@ -115,6 +119,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `note` (string, opcional): Observação sobre o cliente
- `sendEmailInvite` (boolean, opcional): Se deve enviar convite por e-mail
- `metafields` (object, opcional): Metacampos adicionais em formato JSON
</Accordion>
</AccordionGroup>
@@ -131,6 +136,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `updatedAtMin` (string, opcional): Retorna somente pedidos atualizados após esta data (ISO ou timestamp Unix)
- `updatedAtMax` (string, opcional): Retorna somente pedidos atualizados antes desta data (ISO ou timestamp Unix)
- `limit` (string, opcional): Número máximo de pedidos a retornar (padrão 250)
</Accordion>
<Accordion title="shopify/create_order">
@@ -144,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `financialStatus` (string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
- `inventoryBehaviour` (string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policy
- `note` (string, opcional): Observação do pedido
</Accordion>
<Accordion title="shopify/update_order">
@@ -158,6 +165,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `financialStatus` (string, opcional): Status financeiro - Opções: pending, authorized, partially_paid, paid, partially_refunded, refunded, voided
- `inventoryBehaviour` (string, opcional): Comportamento de inventário - Opções: bypass, decrement_ignoring_policy, decrement_obeying_policy
- `note` (string, opcional): Observação do pedido
</Accordion>
<Accordion title="shopify/get_abandoned_carts">
@@ -170,6 +178,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `createdAtMin` (string, opcional): Retorna somente carrinhos criados após esta data (ISO ou timestamp Unix)
- `createdAtMax` (string, opcional): Retorna somente carrinhos criados antes desta data (ISO ou timestamp Unix)
- `limit` (string, opcional): Número máximo de carrinhos a retornar (padrão 250)
</Accordion>
</AccordionGroup>
@@ -190,6 +199,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `updatedAtMin` (string, opcional): Retorna somente produtos atualizados após esta data (ISO ou timestamp Unix)
- `updatedAtMax` (string, opcional): Retorna somente produtos atualizados antes desta data (ISO ou timestamp Unix)
- `limit` (string, opcional): Número máximo de produtos a retornar (padrão 250)
</Accordion>
<Accordion title="shopify/create_product">
@@ -206,6 +216,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `imageUrl` (string, opcional): URL da imagem do produto
- `isPublished` (boolean, opcional): Se o produto está publicado
- `publishToPointToSale` (boolean, opcional): Se deve publicar no ponto de venda
</Accordion>
<Accordion title="shopify/update_product">
@@ -223,6 +234,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `imageUrl` (string, opcional): URL da imagem do produto
- `isPublished` (boolean, opcional): Se o produto está publicado
- `publishToPointToSale` (boolean, opcional): Se deve publicar no ponto de venda
</Accordion>
</AccordionGroup>
@@ -234,6 +246,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `productFilterFormula` (object, opcional): Filtro avançado em forma normal disjuntiva com suporte a campos como id, title, vendor, status, handle, tag, created_at, updated_at, published_at
</Accordion>
<Accordion title="shopify/create_product_graphql">
@@ -247,6 +260,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `tags` (string, opcional): Tags do produto como array ou lista separada por vírgula
- `media` (object, opcional): Objetos de mídia com texto alternativo, tipo de conteúdo e URL de origem
- `additionalFields` (object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard
</Accordion>
<Accordion title="shopify/update_product_graphql">
@@ -261,6 +275,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `tags` (string, opcional): Tags do produto como array ou lista separada por vírgula
- `media` (object, opcional): Objetos de mídia atualizados com texto alternativo, tipo de conteúdo e URL de origem
- `additionalFields` (object, opcional): Campos adicionais do produto como status, requiresSellingPlan, giftCard
</Accordion>
</AccordionGroup>
@@ -388,5 +403,6 @@ crew.kickoff()
### Precisa de Ajuda?
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para assistência na configuração ou resolução de problemas de integração com o Shopify.
Entre em contato com nossa equipe de suporte para assistência na configuração
ou resolução de problemas de integração com o Shopify.
</Card>

19
docs/pt-BR/enterprise/integrations/slack.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem a comunicação da equipe pelo Slack. Envie m
Antes de usar a integração com o Slack, certifique-se de que você tenha:
- Uma conta [CrewAI AOP](https://app.crewai.com) com assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com assinatura ativa
- Um workspace do Slack com permissões apropriadas
- Seu workspace do Slack conectado por meio da [página de Integrações](https://app.crewai.com/integrations)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Slack, certifique-se de que você tenha:
### 1. Conecte seu Workspace do Slack
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Slack** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para comunicação em equipe
@@ -36,7 +36,8 @@ 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.
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
@@ -59,6 +60,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- Nenhum parâmetro necessário – recupera todos os membros do canal
</Accordion>
<Accordion title="slack/get_user_by_email">
@@ -66,6 +68,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `email` (string, obrigatório): O endereço de e-mail de um usuário do workspace
</Accordion>
<Accordion title="slack/get_users_by_name">
@@ -76,6 +79,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `displayName` (string, obrigatório): Nome de exibição do usuário para a pesquisa
- `paginationParameters` (object, opcional): Configurações de paginação
- `pageCursor` (string, opcional): Cursor de página para paginação
</Accordion>
</AccordionGroup>
@@ -87,6 +91,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- Nenhum parâmetro necessário – recupera todos os canais acessíveis
</Accordion>
</AccordionGroup>
@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `botIcon` (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: ":dog:")
- `blocks` (object, opcional): JSON do Slack Block Kit para mensagens ricas com anexos e elementos interativos
- `authenticatedUser` (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack ao invés do aplicativo (por padrão é falso)
</Accordion>
<Accordion title="slack/send_direct_message">
@@ -115,6 +121,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `botIcon` (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: ":dog:")
- `blocks` (object, opcional): JSON do Slack Block Kit para formatação rica com anexos e elementos interativos
- `authenticatedUser` (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack (padrão é falso)
</Accordion>
</AccordionGroup>
@@ -132,6 +139,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `from:@john in:#general` – Busca mensagens do John no canal #general
- `has:link after:2023-01-01` – Busca mensagens com links após 1º de janeiro de 2023
- `in:@channel before:yesterday` – Busca mensagens em um canal específico antes de ontem
</Accordion>
</AccordionGroup>
@@ -140,6 +148,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
O Block Kit do Slack permite criar mensagens ricas e interativas. Veja alguns exemplos de como usar o parâmetro `blocks`:
### Texto Simples com Anexo
```json
[
{
@@ -154,6 +163,7 @@ O Block Kit do Slack permite criar mensagens ricas e interativas. Veja alguns ex
```
### Formatação Rica com Seções
```json
[
{
@@ -299,5 +309,6 @@ crew.kickoff()
## Fale com o Suporte
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
Entre em contato com nossa equipe de suporte para obter ajuda na configuração ou solução de problemas da integração com o Slack.
Entre em contato com nossa equipe de suporte para obter ajuda na configuração
ou solução de problemas da integração com o Slack.
</Card>

18
docs/pt-BR/enterprise/integrations/stripe.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem pagamentos, assinaturas e faturamento de clie
Antes de usar a integração com o Stripe, certifique-se de que você tem:
- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa
- Uma conta Stripe com permissões apropriadas de API
- Sua conta Stripe conectada através da [página de Integrações](https://app.crewai.com/integrations)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Stripe, certifique-se de que você tem:
### 1. Conecte sua Conta Stripe
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Stripe** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para processamento de pagamentos
@@ -36,7 +36,8 @@ 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.
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
@@ -62,6 +63,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `name` (string, opcional): Nome completo do cliente
- `description` (string, opcional): Descrição do cliente para referência interna
- `metadataCreateCustomer` (objeto, opcional): Metadados adicionais como pares chave-valor (exemplo: `{"field1": 1, "field2": 2}`)
</Accordion>
<Accordion title="stripe/get_customer_by_id">
@@ -69,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `idGetCustomer` (string, obrigatório): O ID do cliente Stripe a ser recuperado
</Accordion>
<Accordion title="stripe/get_customers">
@@ -79,6 +82,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `createdAfter` (string, opcional): Filtra clientes criados após esta data (timestamp Unix)
- `createdBefore` (string, opcional): Filtra clientes criados antes desta data (timestamp Unix)
- `limitGetCustomers` (string, opcional): Número máximo de clientes a retornar (padrão: 10)
</Accordion>
<Accordion title="stripe/update_customer">
@@ -90,6 +94,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `name` (string, opcional): Novo nome do cliente
- `description` (string, opcional): Nova descrição do cliente
- `metadataUpdateCustomer` (objeto, opcional): Novos metadados como pares chave-valor
</Accordion>
</AccordionGroup>
@@ -103,6 +108,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `customerIdCreateSubscription` (string, obrigatório): O ID do cliente para o qual a assinatura será criada
- `plan` (string, obrigatório): O ID do plano para assinatura - Use as Configurações do Workflow do Portal Connect para permitir que usuários selecionem um plano
- `metadataCreateSubscription` (objeto, opcional): Metadados adicionais para a assinatura
</Accordion>
<Accordion title="stripe/get_subscriptions">
@@ -112,6 +118,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `customerIdGetSubscriptions` (string, opcional): Filtra assinaturas por ID do cliente
- `subscriptionStatus` (string, opcional): Filtra por status da assinatura - Opções: incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid
- `limitGetSubscriptions` (string, opcional): Número máximo de assinaturas a retornar (padrão: 10)
</Accordion>
</AccordionGroup>
@@ -125,6 +132,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `productName` (string, obrigatório): Nome do produto
- `description` (string, opcional): Descrição do produto
- `metadataProduct` (objeto, opcional): Metadados adicionais do produto como pares chave-valor
</Accordion>
<Accordion title="stripe/get_product_by_id">
@@ -132,6 +140,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `productId` (string, obrigatório): O ID do produto Stripe a ser recuperado
</Accordion>
<Accordion title="stripe/get_products">
@@ -141,6 +150,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `createdAfter` (string, opcional): Filtra produtos criados após esta data (timestamp Unix)
- `createdBefore` (string, opcional): Filtra produtos criados antes desta data (timestamp Unix)
- `limitGetProducts` (string, opcional): Número máximo de produtos a retornar (padrão: 10)
</Accordion>
</AccordionGroup>
@@ -154,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `balanceTransactionType` (string, opcional): Filtra por tipo de transação - Opções: charge, refund, payment, payment_refund
- `paginationParameters` (objeto, opcional): Configurações de paginação
- `pageCursor` (string, opcional): Cursor da página para paginação
</Accordion>
<Accordion title="stripe/get_plans">
@@ -163,6 +174,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `isPlanActive` (boolean, opcional): Filtra por status do plano - true para planos ativos, false para inativos
- `paginationParameters` (objeto, opcional): Configurações de paginação
- `pageCursor` (string, opcional): Cursor da página para paginação
</Accordion>
</AccordionGroup>

18
docs/pt-BR/enterprise/integrations/zendesk.mdx
View File

@@ -13,7 +13,7 @@ Permita que seus agentes gerenciem operações de suporte ao cliente através do
Antes de usar a integração com o Zendesk, certifique-se de que você possui:
- Uma conta [CrewAI AOP](https://app.crewai.com) com uma assinatura ativa
- Uma conta [CrewAI AMP](https://app.crewai.com) com uma assinatura ativa
- Uma conta Zendesk com permissões apropriadas de API
- Sua conta Zendesk conectada através da [página de Integrações](https://app.crewai.com/integrations)
@@ -21,7 +21,7 @@ Antes de usar a integração com o Zendesk, certifique-se de que você possui:
### 1. Conecte sua Conta Zendesk
1. Acesse [CrewAI AOP Integrações](https://app.crewai.com/crewai_plus/connectors)
1. Acesse [CrewAI AMP Integrações](https://app.crewai.com/crewai_plus/connectors)
2. Encontre **Zendesk** na seção Integrações de Autenticação
3. Clique em **Conectar** e complete o fluxo OAuth
4. Conceda as permissões necessárias para gerenciamento de tickets e usuários
@@ -36,7 +36,8 @@ 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.
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
@@ -70,6 +71,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `ticketTags` (string, opcional): Array de tags a aplicar (ex.: `["enterprise", "outra_tag"]`)
- `ticketExternalId` (string, opcional): ID externo para vincular tickets a registros locais
- `ticketCustomFields` (object, opcional): Valores de campos personalizados em formato JSON
</Accordion>
<Accordion title="zendesk/update_ticket">
@@ -88,6 +90,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `ticketTags` (string, opcional): Array de tags atualizadas
- `ticketExternalId` (string, opcional): Novo ID externo
- `ticketCustomFields` (object, opcional): Valores atualizados dos campos personalizados
</Accordion>
<Accordion title="zendesk/get_ticket_by_id">
@@ -95,6 +98,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `ticketId` (string, obrigatório): ID do ticket a ser recuperado (ex.: "35436")
</Accordion>
<Accordion title="zendesk/add_comment_to_ticket">
@@ -105,6 +109,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `commentBody` (string, obrigatório): Mensagem do comentário (aceita texto simples ou HTML, ex.: "Obrigado pela sua ajuda!")
- `isInternalNote` (boolean, opcional): Defina como verdadeiro para notas internas ao invés de respostas públicas (padrão é falso)
- `isPublic` (boolean, opcional): Verdadeiro para comentários públicos, falso para notas internas
</Accordion>
<Accordion title="zendesk/search_tickets">
@@ -126,6 +131,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `dueDate` (object, opcional): Filtrar por data de vencimento com operador e valor
- `sort_by` (string, opcional): Campo de ordenação - Opções: created_at, updated_at, priority, status, ticket_type
- `sort_order` (string, opcional): Direção da ordenação - Opções: asc, desc
</Accordion>
</AccordionGroup>
@@ -143,6 +149,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `externalId` (string, opcional): Identificador único de outro sistema
- `details` (string, opcional): Detalhes adicionais do usuário
- `notes` (string, opcional): Notas internas sobre o usuário
</Accordion>
<Accordion title="zendesk/update_user">
@@ -157,6 +164,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `externalId` (string, opcional): Novo ID externo
- `details` (string, opcional): Novos detalhes do usuário
- `notes` (string, opcional): Novas notas internas
</Accordion>
<Accordion title="zendesk/get_user_by_id">
@@ -164,6 +172,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `userId` (string, obrigatório): ID do usuário a ser recuperado
</Accordion>
<Accordion title="zendesk/search_users">
@@ -176,6 +185,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `externalId` (string, opcional): Filtrar por ID externo
- `sort_by` (string, opcional): Campo de ordenação - Opções: created_at, updated_at
- `sort_order` (string, opcional): Direção de ordenação - Opções: asc, desc
</Accordion>
</AccordionGroup>
@@ -188,6 +198,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
**Parâmetros:**
- `paginationParameters` (object, opcional): Configurações de paginação
- `pageCursor` (string, opcional): Cursor de página para paginação
</Accordion>
<Accordion title="zendesk/get_ticket_audits">
@@ -197,6 +208,7 @@ CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token
- `ticketId` (string, opcional): Obtenha auditorias para um ticket específico (se vazio, recupera auditorias de todos os tickets não arquivados, ex.: "1234")
- `paginationParameters` (object, opcional): Configurações de paginação
- `pageCursor` (string, opcional): Cursor de página para paginação
</Accordion>
</AccordionGroup>

26
docs/pt-BR/enterprise/introduction.mdx
View File

@@ -1,5 +1,5 @@
---
title: "CrewAI AOP"
title: "CrewAI AMP"
description: "Implemente, monitore e escale seus fluxos de trabalho de agentes de IA"
icon: "globe"
mode: "wide"
@@ -7,22 +7,27 @@ mode: "wide"
## Introdução
CrewAI AOP(Agent Operation Platform) fornece uma plataforma para implementar, monitorar e escalar seus crews e agentes em um ambiente de produção.
CrewAI AMP(Agent Management Platform) fornece uma plataforma para implementar, monitorar e escalar seus crews e agentes em um ambiente de produção.
<Frame>
<img src="/images/enterprise/crewai-enterprise-dashboard.png" alt="CrewAI AOP Dashboard" />
<img
src="/images/enterprise/crewai-enterprise-dashboard.png"
alt="CrewAI AMP Dashboard"
/>
</Frame>
CrewAI AOP expande o poder do framework open-source com funcionalidades projetadas para implantações em produção, colaboração e escalabilidade. Implemente seus crews em uma infraestrutura gerenciada e monitore sua execução em tempo real.
CrewAI AMP expande o poder do framework open-source com funcionalidades projetadas para implantações em produção, colaboração e escalabilidade. Implemente seus crews em uma infraestrutura gerenciada e monitore sua execução em tempo real.
## Principais Funcionalidades
<CardGroup cols={2}>
<Card title="Implantação de Crews" icon="rocket">
Implemente seus crews em uma infraestrutura gerenciada com apenas alguns cliques
Implemente seus crews em uma infraestrutura gerenciada com apenas alguns
cliques
</Card>
<Card title="Acesso via API" icon="code">
Acesse seus crews implantados via REST API para integração com sistemas existentes
Acesse seus crews implantados via REST API para integração com sistemas
existentes
</Card>
<Card title="Observabilidade" icon="chart-line">
Monitore seus crews com rastreamentos de execução e logs detalhados
@@ -42,7 +47,8 @@ CrewAI AOP expande o poder do framework open-source com funcionalidades projetad
<CardGroup cols={3}>
<Card title="Integração com GitHub" icon="github">
Conecte-se diretamente aos seus repositórios do GitHub para implementar código
Conecte-se diretamente aos seus repositórios do GitHub para implementar
código
</Card>
<Card title="Crew Studio" icon="palette">
Implemente crews criados pela interface no-code do Crew Studio
@@ -57,11 +63,7 @@ CrewAI AOP expande o poder do framework open-source com funcionalidades projetad
<Steps>
<Step title="Cadastre-se para uma conta">
Crie sua conta em [app.crewai.com](https://app.crewai.com)
<Card
title="Cadastre-se"
icon="user"
href="https://app.crewai.com/signup"
>
<Card title="Cadastre-se" icon="user" href="https://app.crewai.com/signup">
Cadastre-se
</Card>
</Step>

3
docs/pt-BR/enterprise/resources/frequently-asked-questions.mdx
View File

@@ -1,6 +1,6 @@
---
title: FAQs
description: "Perguntas frequentes sobre CrewAI AOP"
description: "Perguntas frequentes sobre CrewAI AMP"
icon: "circle-question"
mode: "wide"
---
@@ -148,4 +148,5 @@ mode: "wide"
<Accordion title="Como controlar o número máximo de solicitações por minuto que toda a crew pode realizar?">
O atributo `max_rpm` define o número máximo de solicitações por minuto que a crew pode realizar para evitar limites de taxa, e irá sobrescrever as definições de `max_rpm` dos agentes individuais se você defini-lo.
</Accordion>
</AccordionGroup>

27
docs/pt-BR/installation.mdx
View File

@@ -6,6 +6,7 @@ mode: "wide"
---
## Tutorial em Vídeo
Assista a este tutorial em vídeo para uma demonstração passo a passo do processo de instalação:
<iframe
@@ -18,15 +19,18 @@ Assista a este tutorial em vídeo para uma demonstração passo a passo do proce
></iframe>
## Tutorial em Texto
<Note>
**Requisitos de Versão do Python**
CrewAI requer `Python >=3.10 e <3.14`. Veja como verificar sua versão:
```bash
python3 --version
```
CrewAI requer `Python >=3.10 e <3.14`. Veja como verificar sua versão:
```bash
python3 --version
```
Se você precisar atualizar o Python, acesse [python.org/downloads](https://python.org/downloads)
Se você precisar atualizar o Python, acesse [python.org/downloads](https://python.org/downloads)
</Note>
CrewAI utiliza o `uv` como ferramenta de gerenciamento de dependências e pacotes. Ele simplifica a configuração e execução do projeto, oferecendo uma experiência fluida.
@@ -89,6 +93,7 @@ Se você ainda não instalou o `uv`, siga o **passo 1** para instalá-lo rapidam
```
<Check>Instalação realizada com sucesso! Você está pronto para criar seu primeiro crew! 🎉</Check>
</Step>
</Steps>
# Criando um Projeto CrewAI
@@ -124,6 +129,7 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut
└── tasks.yaml
```
</Frame>
</Step>
<Step title="Personalize Seu Projeto">
@@ -140,6 +146,7 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut
- Comece editando `agents.yaml` e `tasks.yaml` para definir o comportamento do seu crew.
- Mantenha informações sensíveis como chaves de API no arquivo `.env`.
</Step>
<Step title="Execute seu Crew">
@@ -163,13 +170,15 @@ Recomendamos utilizar o template de scaffolding `YAML` para uma abordagem estrut
<Note type="info">
Para equipes e organizações, o CrewAI oferece opções de implantação corporativa que eliminam a complexidade da configuração:
### CrewAI AOP (SaaS)
### CrewAI AMP (SaaS)
- Zero instalação necessária - basta se cadastrar gratuitamente em [app.crewai.com](https://app.crewai.com)
- Atualizações e manutenção automáticas
- Infraestrutura e escalabilidade gerenciadas
- Construa crews sem código
### CrewAI Factory (Auto-Hospedado)
- Implantação containerizada para sua infraestrutura
- Compatível com qualquer hyperscaler, incluindo ambientes on-premises
- Integração com seus sistemas de segurança existentes
@@ -187,13 +196,15 @@ Para equipes e organizações, o CrewAI oferece opções de implantação corpor
icon="code"
href="/pt-BR/quickstart"
>
Siga nosso guia de início rápido para criar seu primeiro agente CrewAI e obter experiência prática.
Siga nosso guia de início rápido para criar seu primeiro agente CrewAI e
obter experiência prática.
</Card>
<Card
title="Junte-se à Comunidade"
icon="comments"
href="https://community.crewai.com"
>
Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas experiências com o CrewAI.
Conecte-se com outros desenvolvedores, obtenha ajuda e compartilhe suas
experiências com o CrewAI.
</Card>
</CardGroup>

171
docs/pt-BR/learn/llm-selection-guide.mdx
View File

@@ -1,7 +1,7 @@
---
title: 'Guia Estratégico de Seleção de LLMs'
description: 'Framework estratégico para escolher o LLM certo para seus agentes CrewAI e escrever definições eficazes de tarefas e agentes'
icon: 'brain-circuit'
title: "Guia Estratégico de Seleção de LLMs"
description: "Framework estratégico para escolher o LLM certo para seus agentes CrewAI e escrever definições eficazes de tarefas e agentes"
icon: "brain-circuit"
mode: "wide"
---
@@ -10,23 +10,36 @@ mode: "wide"
Em vez de recomendações prescritivas de modelos, defendemos um **framework de pensamento** que ajude você a tomar decisões informadas com base no seu caso de uso, restrições e requisitos específicos. O cenário de LLMs evolui rapidamente, com novos modelos surgindo regularmente e os existentes sendo atualizados frequentemente. O que mais importa é desenvolver uma abordagem sistemática de avaliação que permaneça relevante independentemente dos modelos disponíveis no momento.
<Note>
Este guia foca em pensamento estratégico em vez de recomendações de modelos específicos, já que o cenário dos LLMs evolui rapidamente.
Este guia foca em pensamento estratégico em vez de recomendações de modelos
específicos, já que o cenário dos LLMs evolui rapidamente.
</Note>
## Framework de Decisão Rápida
<Steps>
<Step title="Analise Suas Tarefas">
Comece entendendo profundamente o que suas tarefas realmente exigem. Considere a complexidade cognitiva envolvida, a profundidade de raciocínio necessária, o formato dos resultados esperados e a quantidade de contexto que o modelo precisará processar. Essa análise fundamental guiará todas as decisões seguintes.
Comece entendendo profundamente o que suas tarefas realmente exigem.
Considere a complexidade cognitiva envolvida, a profundidade de raciocínio
necessária, o formato dos resultados esperados e a quantidade de contexto
que o modelo precisará processar. Essa análise fundamental guiará todas as
decisões seguintes.
</Step>
<Step title="Mapeie as Capacidades dos Modelos">
Assim que você compreende seus requisitos, mapeie-os para as forças dos modelos. Diferentes famílias de modelos se destacam em diferentes tipos de trabalho; alguns são otimizados para raciocínio e análise, outros para criatividade e geração de conteúdo, e outros para velocidade e eficiência.
Assim que você compreende seus requisitos, mapeie-os para as forças dos
modelos. Diferentes famílias de modelos se destacam em diferentes tipos de
trabalho; alguns são otimizados para raciocínio e análise, outros para
criatividade e geração de conteúdo, e outros para velocidade e eficiência.
</Step>
<Step title="Considere Restrições">
Leve em conta suas reais restrições operacionais, incluindo limitações orçamentárias, requisitos de latência, necessidades de privacidade de dados e capacidades de infraestrutura. O melhor modelo teoricamente pode não ser a melhor escolha prática para sua situação.
Leve em conta suas reais restrições operacionais, incluindo limitações
orçamentárias, requisitos de latência, necessidades de privacidade de dados
e capacidades de infraestrutura. O melhor modelo teoricamente pode não ser a
melhor escolha prática para sua situação.
</Step>
<Step title="Teste e Itere">
Comece com modelos confiáveis e bem conhecidos e otimize com base no desempenho real no seu caso de uso. Os resultados práticos frequentemente diferem dos benchmarks teóricos, então testes empíricos são cruciais.
Comece com modelos confiáveis e bem conhecidos e otimize com base no
desempenho real no seu caso de uso. Os resultados práticos frequentemente
diferem dos benchmarks teóricos, então testes empíricos são cruciais.
</Step>
</Steps>
@@ -43,6 +56,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment
- **Tarefas Complexas** exigem raciocínio de múltiplas etapas, pensamento estratégico e a capacidade de lidar com informações ambíguas ou incompletas. Podem envolver análise de múltiplas fontes de dados, desenvolvimento de estratégias abrangentes ou resolução de problemas que precisam ser decompostos em componentes menores. O modelo deve manter o contexto ao longo de várias etapas de raciocínio e frequentemente precisa inferir informações não explicitamente declaradas.
- **Tarefas Criativas** exigem um tipo diferente de capacidade cognitiva, focada em gerar conteúdo novo, envolvente e adequado ao contexto. Isso inclui storytelling, criação de textos de marketing e solução criativa de problemas. O modelo deve compreender nuances, tom e público, produzindo conteúdo autêntico e envolvente, não apenas fórmulas.
</Tab>
<Tab title="Requisitos de Saída">
@@ -51,6 +65,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment
- **Conteúdo Criativo** requer equilíbrio entre competência técnica e criatividade. O modelo precisa compreender o público, tom e voz da marca, ao mesmo tempo em que produz conteúdo que engaja leitores e atinge objetivos comunicativos específicos. A qualidade aqui é mais subjetiva e exige modelos capazes de adaptar o estilo de escrita a diferentes contextos e propósitos.
- **Conteúdo Técnico** situa-se entre dados estruturados e conteúdo criativo, demandando precisão e clareza. Documentação, geração de código e análises técnicas precisam ser exatas e completas, mas ainda assim acessíveis ao público-alvo. O modelo deve entender conceitos técnicos complexos e comunicá-los de forma eficaz.
</Tab>
<Tab title="Necessidades de Contexto">
@@ -59,6 +74,7 @@ O passo mais crítico na seleção de LLMs é entender o que sua tarefa realment
- **Contexto Longo** é necessário ao lidar com documentos substanciais, conversas extensas ou tarefas complexas de múltiplas partes. O modelo precisa manter coerência ao longo de milhares de tokens, referenciando informações anteriores com precisão. Essencial para análise de documentos, pesquisa abrangente e sistemas de diálogo sofisticados.
- **Contexto Muito Longo** ultrapassa os limites do possível hoje, com processamento de documentos massivos, síntese de pesquisas extensas ou interações multi-sessão. São casos que exigem modelos projetados especificamente para lidar com contexto estendido e envolvem trade-offs entre extensão e velocidade.
</Tab>
</Tabs>
@@ -73,6 +89,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
O ponto forte é manter consistência lógica em cadeias longas de raciocínio e decompor problemas complexos em partes gerenciáveis. São especialmente valiosos para planejamento estratégico, análise complexa e situações onde a qualidade do raciocínio importa mais que a velocidade.
Entretanto, há trade-offs em termos de custo e velocidade. Podem ser menos adequados para tarefas criativas ou operações simples, onde suas capacidades avançadas não são necessárias. Considere-os quando as tarefas realmente se beneficiarem dessa análise detalhada.
</Accordion>
<Accordion title="Modelos de Uso Geral" icon="microchip">
@@ -81,6 +98,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
A principal vantagem é a confiabilidade previsível em diversos trabalhos: pesquisa, análise, criação de conteúdo, processamento de dados. São ótimas opções iniciais para equipes que buscam consistência ao lidar com fluxos variados.
Embora não atinjam picos de desempenho como modelos especializados, oferecem simplicidade operacional e baixa complexidade na gestão. São o melhor ponto de partida para novos projetos, permitindo descobertas de necessidades antes de avançar para otimizações.
</Accordion>
<Accordion title="Modelos Rápidos & Eficientes" icon="bolt">
@@ -89,6 +107,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
Brilham em operações rotineiras, processamento simples de dados, chamadas de funções e tarefas de alto volume. Aplicações que processam muitos pedidos rapidamente ou operam sob restrições orçamentárias se beneficiam desses modelos.
O ponto crucial é garantir que suas capacidades atendam às exigências da tarefa. Podem não atender tarefas que exijam entendimento profundo, raciocínio complexo ou geração de conteúdo sofisticado. São ideais para tarefas rotineiras bem definidas.
</Accordion>
<Accordion title="Modelos Criativos" icon="pen">
@@ -97,6 +116,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
O ponto forte está em adaptar o estilo para diferentes públicos, manter voz e tom consistentes e engajar leitores. Performam melhor em storytelling, textos publicitários, comunicações de marca e outras tarefas com criatividade como foco.
Ao selecionar esses modelos, considere não apenas a habilidade de gerar texto, mas a compreensão de público, contexto e objetivo. Os melhores modelos criativos adaptam a saída à voz da marca, diferentes segmentos e mantêm consistência em peças longas.
</Accordion>
<Accordion title="Modelos Open Source" icon="code">
@@ -105,6 +125,7 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
Os principais benefícios incluem eliminação de custos por token, possibilidade de fine-tuning, privacidade total e independência de fornecedores externos. Perfeitos para organizações com necessidade de privacidade, orçamento limitado ou desejo de customização.
Contudo, requerem maior expertise técnica para implantar e manter. Considere custos de infraestrutura, complexidade de gestão e esforços contínuos de atualização e otimização ao avaliar modelos open source. O custo total pode ser maior que o de alternativas em nuvem devido a esse overhead.
</Accordion>
</AccordionGroup>
@@ -113,7 +134,8 @@ Entender as capacidades dos modelos exige ir além do marketing e dos benchmarks
### a. Abordagem Multi-Modelo
<Tip>
Use diferentes modelos para diferentes propósitos dentro da mesma crew para otimizar desempenho e custos.
Use diferentes modelos para diferentes propósitos dentro da mesma crew para
otimizar desempenho e custos.
</Tip>
As implementações CrewAI mais sofisticadas empregam múltiplos modelos estrategicamente, designando-os conforme as funções e necessidades dos agentes. Assim, é possível otimizar desempenho e custos usando o modelo mais adequado para cada tipo de tarefa.
@@ -177,6 +199,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os a
LLMs de manager eficazes exigem forte raciocínio para delegar bem, desempenho consistente para coordenar previsivelmente e excelente gestão de contexto para acompanhar o estado dos agentes. O modelo deve entender capacidades e limitações dos agentes enquanto otimiza a alocação de tarefas.
O custo é especialmente relevante, já que este LLM participa de todas as operações. O modelo precisa entregar capacidades suficientes, sem o preço premium de opções sofisticadas demais, buscando sempre o equilíbrio entre performance e valor.
</Tab>
<Tab title="Function Calling LLM">
@@ -185,6 +208,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os a
As características mais importantes são precisão e confiabilidade, não criatividade ou raciocínio avançado. O modelo deve extrair parâmetros corretos de comandos em linguagem natural consistentemente e processar respostas de ferramentas adequadamente. Velocidade também importa, pois o uso de ferramentas pode envolver múltiplas idas e vindas de informação.
Muitas equipes descobrem que modelos especializados em function calling ou de uso geral com forte suporte a ferramentas funcionam melhor do que modelos criativos ou de raciocínio nesse papel. O fundamental é assegurar que o modelo consiga converter instruções em chamadas estruturadas sem falhas.
</Tab>
<Tab title="Sobrescritas Específicas de Agente">
@@ -193,6 +217,7 @@ O segredo do sucesso na implementação multi-modelo está em entender como os a
Considere sobrescritas quando a função do agente exige capacidades distintas. Por exemplo, um agente de redação criativa pode se beneficiar de um LLM otimizado para geração de conteúdo, enquanto um analista de dados pode preferir um modelo voltado ao raciocínio.
O desafio é balancear otimização com complexidade operacional. Cada modelo adicional aumenta a complexidade de deployment, monitoramento e custos. Foque em sobrescritas apenas quando a melhoria justificar essa complexidade.
</Tab>
</Tabs>
@@ -209,6 +234,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m
Descrições eficazes incluem contexto relevante e restrições, ajudando o agente a entender o propósito maior e quaisquer limitações. Divida trabalhos complexos em etapas gerenciáveis em vez de objetivos genéricos e sobrecarregados.
Erros comuns incluem objetivos vagos, falta de contexto, critérios de sucesso mal definidos ou mistura de tarefas totalmente distintas em um mesmo texto. O objetivo é passar informação suficiente para o sucesso, mas mantendo foco no resultado claro.
</Accordion>
<Accordion title="Diretrizes para a Saída Esperada" icon="bullseye">
@@ -217,6 +243,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m
As melhores diretrizes incluem exemplos concretos de indicadores de qualidade e critérios claros de conclusão, de modo que agente e revisores humanos possam avaliar o resultado facilmente. Isso reduz ambiguidades e garante resultados consistentes.
Evite descrições genéricas que serviriam para qualquer tarefa, ausência de especificações de formato, padrões vagos ou falta de exemplos/modelos que ajudem o agente a entender as expectativas.
</Accordion>
</AccordionGroup>
@@ -229,6 +256,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m
Para implementar bem, use o parâmetro de contexto para encadear tarefas, desenvolvendo gradualmente a complexidade. Cada tarefa deve gerar saídas que alimentam as próximas. O objetivo é manter um fluxo lógico entre as tarefas dependentes, evitando gargalos desnecessários.
Funciona melhor quando há progressão lógica evidente e quando a saída de uma tarefa realmente agrega valor nas etapas seguintes. Cuidado com os gargalos; foque nas dependências essenciais.
</Tab>
<Tab title="Execução Paralela">
@@ -237,6 +265,7 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m
Para isso, identifique tarefas realmente independentes, agrupe fluxos de trabalho distintos e planeje a integração dos resultados posteriormente. O ponto-chave é garantir que tarefas paralelas não gerem conflitos ou redundâncias.
Considere o paralelo em múltiplos fluxos independentes, diferentes tipos de análise autônoma, ou criação de conteúdo que pode ser feita ao mesmo tempo. Mas atente-se à alocação de recursos, evitando sobrecarga de modelos ou estouro no orçamento.
</Tab>
</Tabs>
@@ -245,7 +274,8 @@ Definir bem as tarefas é frequentemente mais importante do que a seleção do m
### a. Seleção de LLM Guiada pelo Papel
<Warning>
Funções genéricas de agentes tornam impossível escolher o LLM certo. Funções específicas permitem otimização do modelo conforme a função.
Funções genéricas de agentes tornam impossível escolher o LLM certo. Funções
específicas permitem otimização do modelo conforme a função.
</Warning>
A especificidade das funções dos agentes determina quais capacidades de LLM mais importam para alto desempenho, criando oportunidade estratégica de alinhar forças do modelo ao papel do agente.
@@ -253,6 +283,7 @@ A especificidade das funções dos agentes determina quais capacidades de LLM ma
**Impacto de Funções Genéricas vs. Específicas:**
Ao definir funções, pense no conhecimento do domínio, estilo de trabalho e frameworks decisórios mais valiosos para o tipo de tarefa do agente. Quanto mais específica e contextualizada a função, melhor o modelo incorporará esse papel.
```python
# ✅ Função específica - requisitos claros de LLM
specific_agent = Agent(
@@ -273,7 +304,8 @@ specific_agent = Agent(
### b. Backstory como Amplificador de Contexto do Modelo
<Info>
Backstories estratégicos maximizam a eficácia do LLM ao contextualizar as respostas de forma que prompts genéricos não conseguem.
Backstories estratégicos maximizam a eficácia do LLM ao contextualizar as
respostas de forma que prompts genéricos não conseguem.
</Info>
Um bom backstory transforma a escolha do LLM de genérica a especializada. Isso é crucial para otimizar custos: um modelo eficiente com contexto certo pode superar um premium sem contexto.
@@ -300,6 +332,7 @@ domain_expert = Agent(
```
**Elementos de Backstory que Potencializam a Performance de LLMs:**
- **Experiência de Domínio**: "10+ anos em vendas enterprise SaaS"
- **Expertise Específica**: "Especialista em due diligence técnica para Série B+"
- **Estilo de Trabalho**: "Decisões orientadas a dados, documentação clara"
@@ -332,6 +365,7 @@ tech_writer = Agent(
```
**Checklist de Alinhamento:**
- ✅ **Função Específica**: Domínio e responsabilidades claras
- ✅ **Correspondência do LLM**: Forças do modelo conectadas à função
- ✅ **Profundidade do Backstory**: Contexto de domínio disponível pro modelo
@@ -353,6 +387,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
- Algum agente depende fortemente de ferramentas?
**Ação**: Documente funções dos agentes e identifique oportunidades de otimização.
</Step>
<Step title="Implemente Estratégia no Nível da Crew" icon="users-gear">
@@ -369,6 +404,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
```
**Ação**: Defina o LLM padrão da crew antes de otimizar agentes individuais.
</Step>
<Step title="Otimize Agentes de Maior Impacto" icon="star">
@@ -390,16 +426,18 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
```
**Ação**: Faça upgrade dos 20% dos agentes que tratam 80% da complexidade.
</Step>
<Step title="Valide com Testes Empresariais" icon="test-tube">
**Após colocar os agentes em produção:**
- Use [CrewAI AOP platform](https://app.crewai.com) para testar seleções de modelo A/B
- Use [CrewAI AMP platform](https://app.crewai.com) para testar seleções de modelo A/B
- Execute múltiplas iterações com inputs reais para medir consistência e performance
- Compare custo vs performance na configuração otimizada
- Compartilhe resultados com o time para tomada coletiva de decisão
**Ação**: Substitua achismos por validação com dados reais usando a plataforma de testes.
</Step>
</Steps>
@@ -412,6 +450,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
Considere-os para desenvolvimento de estratégias de negócios, análise de dados combinados de múltiplas fontes, resolução de problemas dependente de etapas sucessivas e planejamento estratégico envolvendo múltiplas variáveis.
Entretanto, esses modelos são mais caros e lentos, devendo ser reservados para tarefas onde suas capacidades agregam valor real — evite usá-los apenas para operações simples.
</Tab>
<Tab title="Modelos Criativos">
@@ -420,6 +459,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
Use-os em redação de posts, criação de artigos, textos de marketing com viés persuasivo, storytelling e comunicações da marca. Costumam captar nuances e contexto melhor do que generalistas.
Podem ser menos adequados para tarefas técnicas ou analíticas, onde precisão supera criatividade. Use-os quando aspectos comunicativos são fatores críticos de sucesso.
</Tab>
<Tab title="Modelos Eficientes">
@@ -428,6 +468,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
Considere-os para processamento e transformação de dados, formatação simples, chamadas de funções (function calling) e operações em alto volume onde custo importa mais.
O ponto crítico é verificar adequação à tarefa. Funcionam para muitos fluxos rotineiros, mas podem falhar se a tarefa exigir compreensão técnica ou raciocínio.
</Tab>
<Tab title="Modelos Open Source">
@@ -436,6 +477,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
Considere para ferramentas internas de empresas, aplicações sensíveis, projetos onde não é possível usar APIs externas, casos com orçamento apertado ou requisitos de customização.
Mas lembre-se: exigem mais expertise, manutenção e investimentos em infraestrutura. Avalie o custo total da operação ao avaliar esses modelos.
</Tab>
</Tabs>
@@ -455,6 +497,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
# Agente de processamento recebe modelo eficiente
processor = Agent(role="Data Processor", llm=LLM(model="gpt-4o-mini"))
```
</Accordion>
<Accordion title="Ignorar Hierarquia de LLM entre Crew e Agente" icon="shuffle">
@@ -474,6 +517,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
# Agentes herdam o LLM da crew, salvo sobrescrita
agent1 = Agent(llm=LLM(model="claude-3-5-sonnet"))
```
</Accordion>
<Accordion title="Incompatibilidade para Function Calling" icon="screwdriver-wrench">
@@ -492,6 +536,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
llm=LLM(model="claude-3-5-sonnet")
)
```
</Accordion>
<Accordion title="Otimização Prematura sem Teste" icon="gear">
@@ -507,6 +552,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
# Teste a performance e só depois otimize agentes específicos
# Use testes Enterprise para validar melhorias
```
</Accordion>
<Accordion title="Ignorar Limites de Contexto e Memória" icon="brain">
@@ -515,6 +561,7 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
**Exemplo real**: Usar modelo de contexto curto para agentes que precisam manter histórico ao longo de múltiplas iterações ou equipes com comunicação extensiva agent-to-agent.
**Solução CrewAI**: Alinhe capacidades de contexto ao padrão de comunicação da crew.
</Accordion>
</AccordionGroup>
@@ -522,26 +569,36 @@ Em vez de repetir o framework estratégico, segue um checklist tático para impl
<Steps>
<Step title="Comece Simples" icon="play">
Comece com modelos de uso geral, confiáveis e amplamente suportados. Isso estabelece base estável para entender necessidades e expectativas de desempenho antes de otimizar para demandas especializadas.
Comece com modelos de uso geral, confiáveis e amplamente suportados. Isso
estabelece base estável para entender necessidades e expectativas de
desempenho antes de otimizar para demandas especializadas.
</Step>
<Step title="Meça o que Importa" icon="chart-line">
Desenvolva métricas alinhadas ao seu caso de uso e metas de negócio, não apenas benchmarks gerais. Foque na mensuração de resultados relevantes ao seu sucesso.
Desenvolva métricas alinhadas ao seu caso de uso e metas de negócio, não
apenas benchmarks gerais. Foque na mensuração de resultados relevantes ao
seu sucesso.
</Step>
<Step title="Itere Baseado em Resultados" icon="arrows-rotate">
Faça mudanças baseadas no desempenho observado no seu contexto, não apenas considerações teóricas ou recomendações genéricas. O desempenho prático costuma ser bem diferente dos benchmarks.
Faça mudanças baseadas no desempenho observado no seu contexto, não apenas
considerações teóricas ou recomendações genéricas. O desempenho prático
costuma ser bem diferente dos benchmarks.
</Step>
<Step title="Considere o Custo Total" icon="calculator">
Avalie todo custo de operação, incluindo modelo, tempo de desenvolvimento, manutenção e complexidade. O modelo mais barato por token pode não ser o mais econômico ao considerar todos os fatores.
Avalie todo custo de operação, incluindo modelo, tempo de desenvolvimento,
manutenção e complexidade. O modelo mais barato por token pode não ser o
mais econômico ao considerar todos os fatores.
</Step>
</Steps>
<Tip>
Foque em entender seus requisitos primeiro, e então escolha modelos que melhor correspondam a essas necessidades. O melhor LLM é aquele que consistentemente entrega os resultados esperados dentro das suas restrições.
Foque em entender seus requisitos primeiro, e então escolha modelos que melhor
correspondam a essas necessidades. O melhor LLM é aquele que consistentemente
entrega os resultados esperados dentro das suas restrições.
</Tip>
### Validação de Modelos em Nível Enterprise
Para equipes sérias sobre otimização, a **plataforma CrewAI AOP** oferece testes sofisticados que vão além do CLI. Ela permite avaliação completa para decisões orientadas por dados na estratégia de LLM.
Para equipes sérias sobre otimização, a **plataforma CrewAI AMP** oferece testes sofisticados que vão além do CLI. Ela permite avaliação completa para decisões orientadas por dados na estratégia de LLM.
<Frame>
![Enterprise Testing Interface](/images/enterprise/enterprise-testing.png)
@@ -562,7 +619,9 @@ Para equipes sérias sobre otimização, a **plataforma CrewAI AOP** oferece tes
Acesse [app.crewai.com](https://app.crewai.com) para começar!
<Info>
A plataforma Enterprise transforma a seleção de modelos de um "palpite" para um processo orientado por dados, permitindo validar os princípios deste guia com seus próprios casos de uso.
A plataforma Enterprise transforma a seleção de modelos de um "palpite" para
um processo orientado por dados, permitindo validar os princípios deste guia
com seus próprios casos de uso.
</Info>
## Resumo dos Princípios-Chave
@@ -572,21 +631,27 @@ A plataforma Enterprise transforma a seleção de modelos de um "palpite" para u
Escolha os modelos pelo que sua tarefa realmente requer, não por reputação ou capacidades teóricas.
</Card>
<Card title="Combinação de Capacidades" icon="puzzle-piece">
Alinhe forças do modelo a papéis e responsabilidades dos agentes para melhor desempenho.
</Card>
{" "}
<Card title="Combinação de Capacidades" icon="puzzle-piece">
Alinhe forças do modelo a papéis e responsabilidades dos agentes para melhor
desempenho.
</Card>
<Card title="Consistência Estratégica" icon="link">
Mantenha uma estratégia coerente de seleção de modelos em fluxos e componentes relacionados.
</Card>
{" "}
<Card title="Consistência Estratégica" icon="link">
Mantenha uma estratégia coerente de seleção de modelos em fluxos e componentes
relacionados.
</Card>
<Card title="Testes Práticos" icon="flask">
Valide escolhas em uso real, não apenas em benchmarks.
</Card>
{" "}
<Card title="Testes Práticos" icon="flask">
Valide escolhas em uso real, não apenas em benchmarks.
</Card>
<Card title="Iteração Contínua" icon="arrow-up">
Comece simples e otimize com base na performance e necessidade práticas.
</Card>
{" "}
<Card title="Iteração Contínua" icon="arrow-up">
Comece simples e otimize com base na performance e necessidade práticas.
</Card>
<Card title="Equilíbrio Operacional" icon="scale-balanced">
Equilibre performance requerida, custo e complexidade.
@@ -594,13 +659,19 @@ A plataforma Enterprise transforma a seleção de modelos de um "palpite" para u
</CardGroup>
<Check>
Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que você precisa dentro de suas restrições. Conheça seu requisito primeiro, depois selecione o modelo mais adequado.
Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que
você precisa dentro de suas restrições. Conheça seu requisito primeiro, depois
selecione o modelo mais adequado.
</Check>
## Panorama Atual dos Modelos (Junho/2025)
<Warning>
**Retrato do Momento**: Os rankings a seguir representam o estado da arte em Junho de 2025, compilados do [LMSys Arena](https://arena.lmsys.org/), [Artificial Analysis](https://artificialanalysis.ai/) e outros benchmarks líderes. Performance, disponibilidade e preço mudam rapidamente. Sempre valide com seus dados e casos reais.
**Retrato do Momento**: Os rankings a seguir representam o estado da arte em
Junho de 2025, compilados do [LMSys Arena](https://arena.lmsys.org/),
[Artificial Analysis](https://artificialanalysis.ai/) e outros benchmarks
líderes. Performance, disponibilidade e preço mudam rapidamente. Sempre valide
com seus dados e casos reais.
</Warning>
### Principais Modelos por Categoria
@@ -608,7 +679,9 @@ Lembre-se: o melhor LLM é o que entrega consistentemente os resultados de que v
As tabelas abaixo mostram uma amostra dos modelos de maior destaque em cada categoria, junto de orientação sobre aplicação em agentes CrewAI:
<Note>
Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muitos outros excelentes. O objetivo é ilustrar exemplos de capacidades buscadas em vez de apresentar um catálogo completo.
Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem
muitos outros excelentes. O objetivo é ilustrar exemplos de capacidades
buscadas em vez de apresentar um catálogo completo.
</Note>
<Tabs>
@@ -624,6 +697,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
| **Qwen3 235B (Reasoning)** | 62 | $2.63 | Moderada | Alternativa open source para raciocínio |
Esses modelos se destacam em raciocínio multi-etapas e são ideais para agentes que desenvolvem estratégias, coordenam outros agentes ou analisam informações complexas.
</Tab>
<Tab title="Codificação & Técnica">
@@ -638,6 +712,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
| **Llama 3.1 405B** | Bom | 81.1% | $3.50 | LLM para function calling em workflows intensivos em ferramentas |
Otimizados para geração de código, debugging e solução técnica, ideais para equipes de desenvolvimento.
</Tab>
<Tab title="Velocidade & Eficiência">
@@ -652,6 +727,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
| **Nova Micro** | Alto | 0.30s | $0.04 | Execução rápida de tarefas simples |
Priorizam velocidade e eficiência, perfeitos para agentes em operações de rotina ou resposta ágil. **Dica:** Usar provedores de inference rápidos como Groq potencializa open source como Llama.
</Tab>
<Tab title="Performance Equilibrada">
@@ -666,6 +742,7 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
| **Qwen3 32B** | 44 | Boa | $1.23 | Versatilidade econômica |
Oferecem bom desempenho geral, adequados para crews com demandas amplas.
</Tab>
</Tabs>
@@ -676,24 +753,28 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
**Priorizando performance**: Use modelos topo de linha como **o3**, **Gemini 2.5 Pro** ou **Claude 4 Sonnet** para managers e agentes críticos. Excelentes em raciocínio e coordenação, porém mais caros.
**Estratégia**: Implemente abordagem multi-modelo, reservando premium para raciocínio estratégico e eficientes para operações rotineiras.
</Accordion>
<Accordion title="Crews de Baixo Custo" icon="dollar-sign">
**Foco no orçamento**: Foque em modelos como **DeepSeek R1**, **Llama 4 Scout** ou **Gemini 2.0 Flash**, que trazem ótimo desempenho com investimento reduzido.
**Estratégia**: Use modelos econômicos para maioria dos agentes, reservando premium apenas para funções críticas.
</Accordion>
<Accordion title="Workflows Especializados" icon="screwdriver-wrench">
**Para expertise específica**: Escolha modelos otimizados para seu principal caso de uso: **Claude 4** em código, **Gemini 2.5 Pro** em pesquisa, **Llama 405B** em function calling.
**Estratégia**: Selecione conforme a principal função da crew, garantindo alinhamento de capacidade e modelo.
</Accordion>
<Accordion title="Empresa & Privacidade" icon="shield">
**Para operações sensíveis**: Avalie modelos open source como **Llama 4** series, **DeepSeek V3** ou **Qwen3** para deployment privado, mantendo performance competitiva.
**Estratégia**: Use open source em infraestrutura própria e aceite possíveis trade-offs por controle dos dados.
</Accordion>
</AccordionGroup>
@@ -704,7 +785,9 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
- **Viabilidade Open Source**: A distância entre open source e proprietários diminui a cada mês, com Llama 4 Maverick e DeepSeek V3 entregando performance competitiva a preços atrativos. Inferência rápida via Groq maximiza custo-benefício nesses casos.
<Info>
**Testes são essenciais**: Rankings servem de orientação geral, mas seu caso de uso, prompt e critério podem gerar resultados distintos. Sempre teste modelos candidatos com suas tarefas e dados reais antes de decidir.
**Testes são essenciais**: Rankings servem de orientação geral, mas seu caso
de uso, prompt e critério podem gerar resultados distintos. Sempre teste
modelos candidatos com suas tarefas e dados reais antes de decidir.
</Info>
### Estratégia Prática de Implementação
@@ -714,13 +797,19 @@ Estas tabelas exibem apenas alguns modelos líderes por categoria. Existem muito
Inicie com opções consagradas como **GPT-4.1**, **Claude 3.7 Sonnet** ou **Gemini 2.0 Flash**, que oferecem bom desempenho e ampla validação.
</Step>
<Step title="Identifique Demandas Especializadas">
Descubra se sua crew possui requisitos específicos (código, raciocínio, velocidade) que justifiquem modelos como **Claude 4 Sonnet** para desenvolvimento ou **o3** para análise. Para aplicações críticas em velocidade, considere Groq aliado à seleção do modelo.
</Step>
{" "}
<Step title="Identifique Demandas Especializadas">
Descubra se sua crew possui requisitos específicos (código, raciocínio,
velocidade) que justifiquem modelos como **Claude 4 Sonnet** para
desenvolvimento ou **o3** para análise. Para aplicações críticas em
velocidade, considere Groq aliado à seleção do modelo.
</Step>
<Step title="Implemente Estratégia Multi-Modelo">
Use modelos diferentes para agentes distintos conforme o papel. Modelos de alta capacidade para managers e tarefas complexas, eficientes para rotinas.
</Step>
{" "}
<Step title="Implemente Estratégia Multi-Modelo">
Use modelos diferentes para agentes distintos conforme o papel. Modelos de
alta capacidade para managers e tarefas complexas, eficientes para rotinas.
</Step>
<Step title="Monitore e Otimize">
Acompanhe métricas relevantes ao seu caso e esteja pronto para ajustar modelos conforme lançamentos ou mudanças de preços.

10
docs/pt-BR/mcp/dsl-integration.mdx
View File

@@ -10,7 +10,9 @@ mode: "wide"
A integração DSL (Domain Specific Language) MCP do CrewAI oferece a **forma mais simples** de conectar seus agentes aos servidores MCP (Model Context Protocol). Basta adicionar um campo `mcps` ao seu agente e o CrewAI cuida de toda a complexidade automaticamente.
<Info>
Esta é a **abordagem recomendada** para a maioria dos casos de uso de MCP. Para cenários avançados que requerem gerenciamento manual de conexão, veja [MCPServerAdapter](/pt-BR/mcp/overview#advanced-mcpserveradapter).
Esta é a **abordagem recomendada** para a maioria dos casos de uso de MCP.
Para cenários avançados que requerem gerenciamento manual de conexão, veja
[MCPServerAdapter](/pt-BR/mcp/overview#advanced-mcpserveradapter).
</Info>
## Uso Básico
@@ -60,9 +62,9 @@ Use a sintaxe `#` para selecionar ferramentas específicas de um servidor:
"https://mcp.exa.ai/mcp?api_key=sua_chave#web_search_exa"
```
### Marketplace CrewAI AOP
### Marketplace CrewAI AMP
Acesse ferramentas do marketplace CrewAI AOP:
Acesse ferramentas do marketplace CrewAI AMP:
```python
# Serviço completo com todas as ferramentas
@@ -97,7 +99,7 @@ agente_multi_fonte = Agent(
"https://mcp.exa.ai/mcp?api_key=sua_chave_exa&profile=pesquisa",
"https://weather.api.com/mcp#get_current_conditions",
# Marketplace CrewAI AOP
# Marketplace CrewAI AMP
"crewai-amp:financial-insights",
"crewai-amp:academic-research#pubmed_search",
"crewai-amp:market-intelligence#competitor_analysis"

46
docs/pt-BR/mcp/overview.mdx
View File

@@ -1,6 +1,6 @@
---
title: 'Servidores MCP como Ferramentas no CrewAI'
description: 'Aprenda como integrar servidores MCP como ferramentas nos seus agentes CrewAI usando a biblioteca `crewai-tools`.'
title: "Servidores MCP como Ferramentas no CrewAI"
description: "Aprenda como integrar servidores MCP como ferramentas nos seus agentes CrewAI usando a biblioteca `crewai-tools`."
icon: plug
mode: "wide"
---
@@ -25,7 +25,7 @@ agent = Agent(
mcps=[
"https://mcp.exa.ai/mcp?api_key=sua_chave", # Servidor MCP externo
"https://api.weather.com/mcp#get_forecast", # Ferramenta específica do servidor
"crewai-amp:financial-data", # Marketplace CrewAI AOP
"crewai-amp:financial-data", # Marketplace CrewAI AMP
"crewai-amp:research-tools#pubmed_search" # Ferramenta AMP específica
]
)
@@ -43,6 +43,7 @@ Atualmente, suportamos os seguintes mecanismos de transporte:
- **Streamable HTTP**: para servidores remotos (comunicação flexível e potencialmente bidirecional via HTTP, geralmente utilizando SSE para streams do servidor para o cliente)
## Tutorial em Vídeo
Assista a este tutorial em vídeo para um guia abrangente sobre a integração do MCP com o CrewAI:
<iframe
@@ -120,6 +121,7 @@ with MCPServerAdapter(server_params, connect_timeout=60) as mcp_tools:
)
# ... restante da configuração do seu crew ...
```
Este padrão geral mostra como integrar ferramentas. Para exemplos específicos para cada transporte, consulte os guias detalhados abaixo.
## Filtrando Ferramentas
@@ -182,6 +184,7 @@ Quando uma classe é decorada com `@CrewBase`, o ciclo de vida do adaptador é c
- Se `mcp_server_params` não estiver definido, `get_mcp_tools()` retorna uma lista vazia, permitindo manter o mesmo fluxo de código com ou sem MCP configurado.
Assim, é seguro chamar `get_mcp_tools()` em vários agentes ou habilitar/desabilitar MCP dependendo do ambiente.
</Tip>
### Configuração de Timeout de Conexão
@@ -238,6 +241,7 @@ class CrewWithCustomTimeout:
tools=self.get_mcp_tools("tool_1", "tool_2") # ferramentas específicas com timeout personalizado
)
```
## Explore Integrações MCP
<CardGroup cols={2}>
@@ -247,7 +251,8 @@ class CrewWithCustomTimeout:
href="/pt-BR/mcp/stdio"
color="#3B82F6"
>
Conecte-se a servidores MCP locais via entrada/saída padrão. Ideal para scripts e executáveis locais.
Conecte-se a servidores MCP locais via entrada/saída padrão. Ideal para
scripts e executáveis locais.
</Card>
<Card
title="Transporte SSE"
@@ -255,7 +260,8 @@ class CrewWithCustomTimeout:
href="/pt-BR/mcp/sse"
color="#10B981"
>
Integre com servidores MCP remotos usando Server-Sent Events para streaming de dados em tempo real.
Integre com servidores MCP remotos usando Server-Sent Events para streaming
de dados em tempo real.
</Card>
<Card
title="Transporte HTTP Streamable"
@@ -263,7 +269,8 @@ class CrewWithCustomTimeout:
href="/pt-BR/mcp/streamable-http"
color="#F59E0B"
>
Utilize HTTP Streamable para uma comunicação robusta com servidores MCP remotos.
Utilize HTTP Streamable para uma comunicação robusta com servidores MCP
remotos.
</Card>
<Card
title="Conectando a Múltiplos Servidores"
@@ -271,7 +278,8 @@ class CrewWithCustomTimeout:
href="/pt-BR/mcp/multiple-servers"
color="#8B5CF6"
>
Agregue ferramentas de vários servidores MCP simultaneamente usando um único adaptador.
Agregue ferramentas de vários servidores MCP simultaneamente usando um único
adaptador.
</Card>
<Card
title="Considerações de Segurança"
@@ -279,27 +287,30 @@ class CrewWithCustomTimeout:
href="/pt-BR/mcp/security"
color="#EF4444"
>
Revise práticas importantes de segurança para integração MCP e mantenha seus agentes protegidos.
Revise práticas importantes de segurança para integração MCP e mantenha seus
agentes protegidos.
</Card>
</CardGroup>
Confira este repositório para demonstrações completas e exemplos de integração MCP com CrewAI! 👇
<Card
title="Repositório GitHub"
icon="github"
href="https://github.com/tonykipkemboi/crewai-mcp-demo"
target="_blank"
title="Repositório GitHub"
icon="github"
href="https://github.com/tonykipkemboi/crewai-mcp-demo"
target="_blank"
>
Demo MCP do CrewAI
Demo MCP do CrewAI
</Card>
## Segurança ao Usar MCP
<Warning>
Sempre assegure-se de confiar no servidor MCP antes de utilizá-lo.
Sempre assegure-se de confiar no servidor MCP antes de utilizá-lo.
</Warning>
#### Aviso de Segurança: Ataques de DNS Rebinding
Transportes SSE podem ser vulneráveis a ataques de DNS rebinding se não forem devidamente protegidos.
Para prevenir isso:
@@ -312,6 +323,7 @@ Sem essas proteções, invasores podem usar DNS rebinding para interagir com ser
Para mais detalhes, consulte a [documentação de Segurança de Transporte da MCP da Anthropic](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations).
### Limitações
* **Primitivas Suportadas**: Atualmente, o `MCPServerAdapter` suporta principalmente a adaptação de `tools` MCP.
Outras primitivas MCP como `prompts` ou `resources` não são integradas diretamente como componentes CrewAI através deste adaptador por enquanto.
* **Manipulação de Saída**: O adaptador normalmente processa a saída principal de texto de uma ferramenta MCP (por exemplo, `.content[0].text`). Saídas complexas ou multimodais podem exigir tratamento customizado caso não se encaixem nesse padrão.
- **Primitivas Suportadas**: Atualmente, o `MCPServerAdapter` suporta principalmente a adaptação de `tools` MCP.
Outras primitivas MCP como `prompts` ou `resources` não são integradas diretamente como componentes CrewAI através deste adaptador por enquanto.
- **Manipulação de Saída**: O adaptador normalmente processa a saída principal de texto de uma ferramenta MCP (por exemplo, `.content[0].text`). Saídas complexas ou multimodais podem exigir tratamento customizado caso não se encaixem nesse padrão.

23
docs/pt-BR/observability/tracing.mdx
View File

@@ -1,6 +1,6 @@
---
title: CrewAI Tracing
description: Rastreamento integrado para Crews e Flows do CrewAI com a plataforma CrewAI AOP
description: Rastreamento integrado para Crews e Flows do CrewAI com a plataforma CrewAI AMP
icon: magnifying-glass-chart
mode: "wide"
---
@@ -9,7 +9,7 @@ mode: "wide"
O CrewAI fornece recursos de rastreamento integrados que permitem monitorar e depurar seus Crews e Flows em tempo real. Este guia demonstra como habilitar o rastreamento para **Crews** e **Flows** usando a plataforma de observabilidade integrada do CrewAI.
> **O que é o CrewAI Tracing?** O rastreamento integrado do CrewAI fornece observabilidade abrangente para seus agentes de IA, incluindo decisões de agentes, cronogramas de execução de tarefas, uso de ferramentas e chamadas de LLM - tudo acessível através da [plataforma CrewAI AOP](https://app.crewai.com).
> **O que é o CrewAI Tracing?** O rastreamento integrado do CrewAI fornece observabilidade abrangente para seus agentes de IA, incluindo decisões de agentes, cronogramas de execução de tarefas, uso de ferramentas e chamadas de LLM - tudo acessível através da [plataforma CrewAI AMP](https://app.crewai.com).
![CrewAI Tracing Interface](/images/crewai-tracing.png)
@@ -17,7 +17,7 @@ O CrewAI fornece recursos de rastreamento integrados que permitem monitorar e de
Antes de usar o rastreamento do CrewAI, você precisa:
1. **Conta CrewAI AOP**: Cadastre-se para uma conta gratuita em [app.crewai.com](https://app.crewai.com)
1. **Conta CrewAI AMP**: Cadastre-se para uma conta gratuita em [app.crewai.com](https://app.crewai.com)
2. **Autenticação CLI**: Use a CLI do CrewAI para autenticar seu ambiente local
```bash
@@ -26,9 +26,9 @@ crewai login
## Instruções de Configuração
### Passo 1: Crie sua Conta CrewAI AOP
### Passo 1: Crie sua Conta CrewAI AMP
Visite [app.crewai.com](https://app.crewai.com) e crie sua conta gratuita. Isso lhe dará acesso à plataforma CrewAI AOP, onde você pode visualizar rastreamentos, métricas e gerenciar seus crews.
Visite [app.crewai.com](https://app.crewai.com) e crie sua conta gratuita. Isso lhe dará acesso à plataforma CrewAI AMP, onde você pode visualizar rastreamentos, métricas e gerenciar seus crews.
### Passo 2: Instale a CLI do CrewAI e Autentique
@@ -38,16 +38,17 @@ Se você ainda não o fez, instale o CrewAI com as ferramentas CLI:
uv add crewai[tools]
```
Em seguida, autentique sua CLI com sua conta CrewAI AOP:
Em seguida, autentique sua CLI com sua conta CrewAI AMP:
```bash
crewai login
```
Este comando irá:
1. Abrir seu navegador na página de autenticação
2. Solicitar que você insira um código de dispositivo
3. Autenticar seu ambiente local com sua conta CrewAI AOP
3. Autenticar seu ambiente local com sua conta CrewAI AMP
4. Habilitar recursos de rastreamento para seu desenvolvimento local
### Passo 3: Habilite o Rastreamento em seu Crew
@@ -147,13 +148,12 @@ flow = ExampleFlow(tracing=True)
result = flow.kickoff()
```
### Passo 5: Visualize os Rastreamentos no Painel CrewAI AOP
### Passo 5: Visualize os Rastreamentos no Painel CrewAI AMP
Após executar o crew ou flow, você pode visualizar os rastreamentos gerados pela sua aplicação CrewAI no painel CrewAI AOP. Você verá etapas detalhadas das interações dos agentes, usos de ferramentas e chamadas de LLM.
Após executar o crew ou flow, você pode visualizar os rastreamentos gerados pela sua aplicação CrewAI no painel CrewAI AMP. Você verá etapas detalhadas das interações dos agentes, usos de ferramentas e chamadas de LLM.
Basta clicar no link abaixo para visualizar os rastreamentos ou ir para a aba de rastreamentos no painel [aqui](https://app.crewai.com/crewai_plus/trace_batches)
![CrewAI Tracing Interface](/images/view-traces.png)
### Alternativa: Configuração de Variável de Ambiente
Você também pode habilitar o rastreamento globalmente definindo uma variável de ambiente:
@@ -172,7 +172,7 @@ Quando esta variável de ambiente estiver definida, todos os Crews e Flows terã
## Visualizando seus Rastreamentos
### Acesse o Painel CrewAI AOP
### Acesse o Painel CrewAI AMP
1. Visite [app.crewai.com](https://app.crewai.com) e faça login em sua conta
2. Navegue até o painel do seu projeto
@@ -190,6 +190,7 @@ O rastreamento do CrewAI fornece visibilidade abrangente sobre:
- **Rastreamento de Erros**: Informações detalhadas de erros e rastreamentos de pilha
### Recursos de Rastreamento
- **Cronograma de Execução**: Clique através de diferentes estágios de execução
- **Logs Detalhados**: Acesse logs abrangentes para depuração
- **Análise de Desempenho**: Analise padrões de execução e otimize o desempenho

80
docs/pt-BR/quickstart.mdx
View File

@@ -54,6 +54,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
backstory: >
Você é um analista meticuloso com um olhar atento aos detalhes. É conhecido por sua capacidade de transformar dados complexos em relatórios claros e concisos, facilitando o entendimento e a tomada de decisão por parte dos outros.
```
</Step>
<Step title="Modifique seu arquivo `tasks.yaml`">
```yaml tasks.yaml
@@ -76,6 +77,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
agent: reporting_analyst
output_file: report.md
```
</Step>
<Step title="Modifique seu arquivo `crew.py`">
```python crew.py
@@ -131,6 +133,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
verbose=True,
)
```
</Step>
<Step title="[Opcional] Adicione funções de pré e pós execução da tripulação">
```python crew.py
@@ -155,6 +158,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
# ... remaining code
```
</Step>
<Step title="Fique à vontade para passar entradas personalizadas para sua tripulação">
Por exemplo, você pode passar o input `topic` para sua tripulação para personalizar a pesquisa e o relatório.
@@ -173,6 +177,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
}
LatestAiDevelopmentCrew().crew().kickoff(inputs=inputs)
```
</Step>
<Step title="Defina suas variáveis de ambiente">
Antes de executar sua tripulação, certifique-se de ter as seguintes chaves configuradas como variáveis de ambiente no seu arquivo `.env`:
@@ -204,24 +209,24 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
</Step>
<Step title="Alternativa para Empresas: Crie no Crew Studio">
Para usuários do CrewAI AOP, você pode criar a mesma tripulação sem escrever código:
Para usuários do CrewAI AMP, você pode criar a mesma tripulação sem escrever código:
1. Faça login na sua conta CrewAI AOP (crie uma conta gratuita em [app.crewai.com](https://app.crewai.com))
2. Abra o Crew Studio
3. Digite qual automação deseja construir
4. Crie suas tarefas visualmente e conecte-as em sequência
5. Configure seus inputs e clique em "Download Code" ou "Deploy"
1. Faça login na sua conta CrewAI AMP (crie uma conta gratuita em [app.crewai.com](https://app.crewai.com))
2. Abra o Crew Studio
3. Digite qual automação deseja construir
4. Crie suas tarefas visualmente e conecte-as em sequência
5. Configure seus inputs e clique em "Download Code" ou "Deploy"
![Crew Studio Quickstart](/images/enterprise/crew-studio-interface.png)
![Crew Studio Quickstart](/images/enterprise/crew-studio-interface.png)
<Card title="Experimente o CrewAI AOP" icon="rocket" href="https://app.crewai.com">
Comece sua conta gratuita no CrewAI AOP
<Card title="Experimente o CrewAI AMP" icon="rocket" href="https://app.crewai.com">
Comece sua conta gratuita no CrewAI AMP
</Card>
</Step>
<Step title="Veja seu relatório final">
Você verá a saída no console e o arquivo `report.md` deve ser criado na raiz do seu projeto com o relatório final.
Veja um exemplo de como o relatório deve ser:
Veja um exemplo de como o relatório deve ser:
<CodeGroup>
```markdown output/report.md
@@ -284,6 +289,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
## 8. Conclusion
The emergence of AI agents is undeniably reshaping the workplace landscape in 5. With their ability to automate tasks, enhance efficiency, and improve decision-making, AI agents are critical in driving operational success. Organizations must embrace and adapt to AI developments to thrive in an increasingly digital business environment.
```
</CodeGroup>
</Step>
</Steps>
@@ -292,6 +298,7 @@ Siga os passos abaixo para começar a tripular! 🚣‍♂️
Parabéns!
Você configurou seu projeto de tripulação com sucesso e está pronto para começar a construir seus próprios fluxos de trabalho baseados em agentes!
</Check>
### Observação sobre Consistência nos Nomes
@@ -303,41 +310,44 @@ Essa consistência de nomes permite que a CrewAI conecte automaticamente suas co
#### Exemplos de Referências
<Tip>
Observe como usamos o mesmo nome para o agente no arquivo `agents.yaml` (`email_summarizer`) e no método do arquivo `crew.py` (`email_summarizer`).
Observe como usamos o mesmo nome para o agente no arquivo `agents.yaml`
(`email_summarizer`) e no método do arquivo `crew.py` (`email_summarizer`).
</Tip>
```yaml agents.yaml
email_summarizer:
role: >
Email Summarizer
goal: >
Summarize emails into a concise and clear summary
backstory: >
You will create a 5 bullet point summary of the report
llm: provider/model-id # Add your choice of model here
role: >
Email Summarizer
goal: >
Summarize emails into a concise and clear summary
backstory: >
You will create a 5 bullet point summary of the report
llm: provider/model-id # Add your choice of model here
```
<Tip>
Observe como usamos o mesmo nome para a tarefa no arquivo `tasks.yaml` (`email_summarizer_task`) e no método no arquivo `crew.py` (`email_summarizer_task`).
Observe como usamos o mesmo nome para a tarefa no arquivo `tasks.yaml`
(`email_summarizer_task`) e no método no arquivo `crew.py`
(`email_summarizer_task`).
</Tip>
```yaml tasks.yaml
email_summarizer_task:
description: >
Summarize the email into a 5 bullet point summary
expected_output: >
A 5 bullet point summary of the email
agent: email_summarizer
context:
- reporting_task
- research_task
description: >
Summarize the email into a 5 bullet point summary
expected_output: >
A 5 bullet point summary of the email
agent: email_summarizer
context:
- reporting_task
- research_task
```
## Fazendo o Deploy da Sua Tripulação
A forma mais fácil de fazer deploy da sua tripulação em produção é através da [CrewAI AOP](http://app.crewai.com).
A forma mais fácil de fazer deploy da sua tripulação em produção é através da [CrewAI AMP](http://app.crewai.com).
Assista a este vídeo tutorial para uma demonstração detalhada de como fazer deploy da sua tripulação na [CrewAI AOP](http://app.crewai.com) usando a CLI.
Assista a este vídeo tutorial para uma demonstração detalhada de como fazer deploy da sua tripulação na [CrewAI AMP](http://app.crewai.com) usando a CLI.
<iframe
className="w-full aspect-video rounded-xl"
@@ -349,18 +359,16 @@ Assista a este vídeo tutorial para uma demonstração detalhada de como fazer d
></iframe>
<CardGroup cols={2}>
<Card
title="Deploy no Enterprise"
icon="rocket"
href="http://app.crewai.com"
>
Comece com o CrewAI AOP e faça o deploy da sua tripulação em ambiente de produção com apenas alguns cliques.
<Card title="Deploy no Enterprise" icon="rocket" href="http://app.crewai.com">
Comece com o CrewAI AMP e faça o deploy da sua tripulação em ambiente de
produção com apenas alguns cliques.
</Card>
<Card
title="Junte-se à Comunidade"
icon="comments"
href="https://community.crewai.com"
>
Participe da nossa comunidade open source para discutir ideias, compartilhar seus projetos e conectar-se com outros desenvolvedores CrewAI.
Participe da nossa comunidade open source para discutir ideias, compartilhar
seus projetos e conectar-se com outros desenvolvedores CrewAI.
</Card>
</CardGroup>