mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-09 08:08:32 +00:00
Add pt-BR docs translation (#3039)
* docs: add pt-br translations Powered by a CrewAI Flow https://github.com/danielfsbarreto/docs_translator * Update mcp/overview.mdx brazilian docs Its en-US counterpart was updated after I did a pass, so now it includes the new section about @CrewBase
This commit is contained in:
Daniel Barreto
179
docs/pt-BR/enterprise/features/integrations.mdx
Normal file
179
docs/pt-BR/enterprise/features/integrations.mdx
Normal file
@@ -0,0 +1,179 @@
|
||||
---
|
||||
title: Integrações
|
||||
description: "Aplicativos conectados para que seus agentes possam tomar ações."
|
||||
icon: "plug"
|
||||
---
|
||||
|
||||
## Visão Geral
|
||||
|
||||
Permita que seus agentes autentiquem com qualquer provedor habilitado para OAuth e tomem ações. Do Salesforce e HubSpot ao Google e GitHub, você conta com mais de 16 serviços integrados.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Integrações Suportadas
|
||||
|
||||
### **Comunicação & Colaboração**
|
||||
- **Gmail** - Gerencie e-mails e rascunhos
|
||||
- **Slack** - Notificações e alertas do workspace
|
||||
- **Microsoft** - Integração com Office 365 e Teams
|
||||
|
||||
### **Gerenciamento de Projetos**
|
||||
- **Jira** - Rastreamento de issues e gerenciamento de projetos
|
||||
- **ClickUp** - Gerenciamento de tarefas e produtividade
|
||||
- **Asana** - Coordenação de tarefas e projetos de equipe
|
||||
- **Notion** - Gerenciamento de páginas e bases de dados
|
||||
- **Linear** - Gerenciamento de projetos de software e bugs
|
||||
- **GitHub** - Gerenciamento de repositórios e issues
|
||||
|
||||
### **Gestão de Relacionamento com o Cliente**
|
||||
- **Salesforce** - Gerenciamento de contas e oportunidades de CRM
|
||||
- **HubSpot** - Gestão de pipeline de vendas e contatos
|
||||
- **Zendesk** - Administração de chamados de suporte ao cliente
|
||||
|
||||
### **Negócios & Finanças**
|
||||
- **Stripe** - Processamento de pagamentos e gerenciamento de clientes
|
||||
- **Shopify** - Gestão de loja de e-commerce e produtos
|
||||
|
||||
### **Produtividade & Armazenamento**
|
||||
- **Google Sheets** - Sincronização de dados de planilhas
|
||||
- **Google Calendar** - Gerenciamento de eventos e agendas
|
||||
- **Box** - Armazenamento de arquivos e gerenciamento de documentos
|
||||
|
||||
e mais estão por vir!
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
Antes de usar as Integrações de Autenticação, certifique-se de que você possui:
|
||||
|
||||
- Uma conta [CrewAI Enterprise](https://app.crewai.com). Você pode começar com uma avaliação gratuita.
|
||||
|
||||
## Configurando Integrações
|
||||
|
||||
### 1. Conecte sua Conta
|
||||
|
||||
1. Acesse o [CrewAI Enterprise](https://app.crewai.com)
|
||||
2. Vá até a aba **Integrações** - https://app.crewai.com/crewai_plus/connectors
|
||||
3. Clique em **Conectar** no serviço desejado na seção Integrações de Autenticação
|
||||
4. Complete o fluxo de autenticação OAuth
|
||||
5. Conceda as permissões necessárias para seu caso de uso
|
||||
6. Obtenha seu Token Enterprise na sua página de conta do [CrewAI Enterprise](https://app.crewai.com) - https://app.crewai.com/crewai_plus/settings/account
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### 2. Instale as Ferramentas de Integração
|
||||
|
||||
Tudo o que você precisa é da versão mais recente do pacote `crewai-tools`.
|
||||
|
||||
```bash
|
||||
uv add crewai-tools
|
||||
```
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### Uso Básico
|
||||
<Tip>
|
||||
Todos os serviços nos quais você estiver autenticado estarão disponíveis como ferramentas. Portanto, tudo que você precisa fazer é adicionar o `CrewaiEnterpriseTools` ao seu agente e pronto.
|
||||
</Tip>
|
||||
|
||||
```python
|
||||
from crewai import Agent, Task, Crew
|
||||
from crewai_tools import CrewaiEnterpriseTools
|
||||
|
||||
# Obtenha ferramentas enterprise (a ferramenta Gmail será incluída)
|
||||
enterprise_tools = CrewaiEnterpriseTools(
|
||||
enterprise_token="your_enterprise_token"
|
||||
)
|
||||
# imprima as ferramentas
|
||||
print(enterprise_tools)
|
||||
|
||||
# Crie um agente com capacidades do Gmail
|
||||
email_agent = Agent(
|
||||
role="Email Manager",
|
||||
goal="Manage and organize email communications",
|
||||
backstory="An AI assistant specialized in email management and communication.",
|
||||
tools=enterprise_tools
|
||||
)
|
||||
|
||||
# Tarefa para enviar um e-mail
|
||||
email_task = Task(
|
||||
description="Draft and send a follow-up email to john@example.com about the project update",
|
||||
agent=email_agent,
|
||||
expected_output="Confirmation that email was sent successfully"
|
||||
)
|
||||
|
||||
# Execute a tarefa
|
||||
crew = Crew(
|
||||
agents=[email_agent],
|
||||
tasks=[email_task]
|
||||
)
|
||||
|
||||
# Execute o crew
|
||||
crew.kickoff()
|
||||
```
|
||||
|
||||
### Filtrando Ferramentas
|
||||
|
||||
```python
|
||||
from crewai_tools import CrewaiEnterpriseTools
|
||||
|
||||
enterprise_tools = CrewaiEnterpriseTools(
|
||||
actions_list=["gmail_find_email"] # apenas a ferramenta gmail_find_email estará disponível
|
||||
)
|
||||
gmail_tool = enterprise_tools["gmail_find_email"]
|
||||
|
||||
gmail_agent = Agent(
|
||||
role="Gmail Manager",
|
||||
goal="Manage gmail communications and notifications",
|
||||
backstory="An AI assistant that helps coordinate gmail communications.",
|
||||
tools=[gmail_tool]
|
||||
)
|
||||
|
||||
notification_task = Task(
|
||||
description="Find the email from john@example.com",
|
||||
agent=gmail_agent,
|
||||
expected_output="Email found from john@example.com"
|
||||
)
|
||||
|
||||
# Execute a tarefa
|
||||
crew = Crew(
|
||||
agents=[slack_agent],
|
||||
tasks=[notification_task]
|
||||
)
|
||||
```
|
||||
|
||||
## Melhores Práticas
|
||||
|
||||
### Segurança
|
||||
- **Princípio do Menor Privilégio**: Conceda apenas as permissões mínimas exigidas para as tarefas dos seus agentes
|
||||
- **Auditorias Regulares**: Revise periodicamente as integrações conectadas e suas permissões
|
||||
- **Credenciais Seguras**: Nunca insira credenciais diretamente no código; utilize o fluxo seguro de autenticação do CrewAI
|
||||
|
||||
### Filtrando Ferramentas
|
||||
Em um crew implantado, você pode especificar quais ações estão disponíveis para cada integração a partir da página de configurações do serviço ao qual você se conectou.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### Implantações com Escopo para organizações multiusuário
|
||||
Você pode implantar seu crew e associar cada integração a um usuário específico. Por exemplo, um crew que se conecta ao Google pode usar a conta do Gmail de um usuário específico.
|
||||
|
||||
<Tip>
|
||||
Isso é útil para organizações multiusuário, onde você deseja direcionar a integração para um usuário específico.
|
||||
</Tip>
|
||||
|
||||
Use o `user_bearer_token` para direcionar a integração a um usuário específico; assim, quando o crew for iniciado, ele usará o bearer token desse usuário para autenticar com a integração. Se o usuário não estiver logado, o crew não utilizará nenhuma integração conectada. Use o bearer token padrão para autenticar com as integrações que estão sendo implantadas com o crew.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### Precisa de Ajuda?
|
||||
|
||||
<Card title="Precisa de ajuda?" icon="headset" href="mailto:support@crewai.com">
|
||||
Entre em contato com nosso time de suporte para assistência com a configuração de integrações ou solução de problemas.
|
||||
</Card>
|
||||
Reference in New Issue
Block a user