mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-10 08:38:30 +00:00
chore(docs): bring AMP doc refresh from release/v1.0.0 into main (#3637)
Some checks failed
Some checks failed
* WIP: v1 docs (#3626) (cherry picked from commit d46e20fa09bcd2f5916282f5553ddeb7183bd92c) * docs: parity for all translations * docs: full name of acronym AMP * docs: fix lingering unused code * docs: expand contextual options in docs.json * docs: add contextual action to request feature on GitHub * chore: tidy docs formatting
This commit is contained in:
Tony Kipkemboi
156
docs/pt-BR/enterprise/features/agent-repositories.mdx
Normal file
156
docs/pt-BR/enterprise/features/agent-repositories.mdx
Normal file
@@ -0,0 +1,156 @@
|
||||
---
|
||||
title: 'Repositórios de Agentes'
|
||||
description: 'Aprenda a usar Repositórios de Agentes para compartilhar e reutilizar seus agentes entre equipes e projetos'
|
||||
icon: 'database'
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
Repositórios de Agentes permitem que usuários do enterprise armazenem, compartilhem e reutilizem definições de agentes entre equipes e projetos. Esse recurso possibilita manter uma biblioteca centralizada de agentes padronizados, promovendo consistência e reduzindo a duplicidade de esforços.
|
||||
|
||||
## Benefícios dos Repositórios de Agentes
|
||||
|
||||
- **Padronização**: Mantenha definições de agentes consistentes em toda a sua organização
|
||||
- **Reutilização**: Crie um agente uma vez e use-o em vários crews e projetos
|
||||
- **Governança**: Implemente políticas organizacionais para configurações de agentes
|
||||
- **Colaboração**: Permita que equipes compartilhem e evoluam o trabalho umas das outras
|
||||
|
||||
## Usando Repositórios de Agentes
|
||||
|
||||
### Pré-requisitos
|
||||
|
||||
1. Você deve ter uma conta na CrewAI, experimente o [plano gratuito](https://app.crewai.com).
|
||||
2. Você precisa estar autenticado usando o CLI da CrewAI.
|
||||
3. Se você tiver mais de uma organização, garanta que alternou para a organização correta usando o comando do CLI:
|
||||
|
||||
```bash
|
||||
crewai org switch <org_id>
|
||||
```
|
||||
|
||||
### Criando e gerenciando agentes em repositórios
|
||||
|
||||
Para criar e gerenciar agentes em repositórios, utilize o Painel do Enterprise.
|
||||
|
||||
### Carregando agentes de repositórios
|
||||
|
||||
Você pode carregar agentes de repositórios no seu código usando o parâmetro `from_repository`:
|
||||
|
||||
```python
|
||||
from crewai import Agent
|
||||
|
||||
# Crie um agente carregando-o de um repositório
|
||||
# O agente é carregado com todas as suas configurações predefinidas
|
||||
researcher = Agent(
|
||||
from_repository="market-research-agent"
|
||||
)
|
||||
|
||||
```
|
||||
|
||||
### Sobrescrevendo configurações do repositório
|
||||
|
||||
Você pode sobrescrever configurações específicas do repositório informando-as na configuração do agente:
|
||||
|
||||
```python
|
||||
researcher = Agent(
|
||||
from_repository="market-research-agent",
|
||||
goal="Pesquisar as tendências mais recentes em desenvolvimento de IA", # Sobrescreve o goal do repositório
|
||||
verbose=True # Adiciona uma configuração que não está no repositório
|
||||
)
|
||||
```
|
||||
|
||||
### Exemplo: criando um Crew com agentes do repositório
|
||||
|
||||
```python
|
||||
from crewai import Crew, Agent, Task
|
||||
|
||||
# Carregue agentes dos repositórios
|
||||
researcher = Agent(
|
||||
from_repository="market-research-agent"
|
||||
)
|
||||
|
||||
writer = Agent(
|
||||
from_repository="content-writer-agent"
|
||||
)
|
||||
|
||||
# Crie tarefas
|
||||
research_task = Task(
|
||||
description="Pesquise as tendências mais recentes em IA",
|
||||
agent=researcher
|
||||
)
|
||||
|
||||
writing_task = Task(
|
||||
description="Escreva um relatório abrangente com base na pesquisa",
|
||||
agent=writer
|
||||
)
|
||||
|
||||
# Crie o crew
|
||||
crew = Crew(
|
||||
agents=[researcher, writer],
|
||||
tasks=[research_task, writing_task],
|
||||
verbose=True
|
||||
)
|
||||
|
||||
# Execute o crew
|
||||
result = crew.kickoff()
|
||||
```
|
||||
|
||||
### Exemplo: usando `kickoff()` com agentes do repositório
|
||||
|
||||
Você também pode usar agentes de repositório diretamente com o método `kickoff()` para interações mais simples:
|
||||
|
||||
```python
|
||||
from crewai import Agent
|
||||
from pydantic import BaseModel
|
||||
from typing import List
|
||||
|
||||
# Defina um formato de saída estruturado
|
||||
class MarketAnalysis(BaseModel):
|
||||
key_trends: List[str]
|
||||
opportunities: List[str]
|
||||
recommendation: str
|
||||
|
||||
# Carregue um agente do repositório
|
||||
analyst = Agent(
|
||||
from_repository="market-analyst-agent",
|
||||
verbose=True
|
||||
)
|
||||
|
||||
# Obtenha uma resposta livre (texto)
|
||||
result = analyst.kickoff("Analise o mercado de IA em 2025")
|
||||
print(result.raw) # Acessa a resposta bruta
|
||||
|
||||
# Obtenha saída estruturada
|
||||
structured_result = analyst.kickoff(
|
||||
"Forneça uma análise estruturada do mercado de IA em 2025",
|
||||
response_format=MarketAnalysis
|
||||
)
|
||||
|
||||
# Acesse os dados estruturados
|
||||
print(f"Principais Tendências: {structured_result.pydantic.key_trends}")
|
||||
print(f"Recomendação: {structured_result.pydantic.recommendation}")
|
||||
```
|
||||
|
||||
## Boas práticas
|
||||
|
||||
1. **Convenção de nomes**: Use nomes claros e descritivos para seus agentes de repositório
|
||||
2. **Documentação**: Inclua descrições abrangentes para cada agente
|
||||
3. **Gestão de ferramentas**: Garanta que as ferramentas referenciadas pelos agentes do repositório estejam disponíveis no seu ambiente
|
||||
4. **Controle de acesso**: Gerencie permissões para que apenas membros autorizados possam modificar agentes do repositório
|
||||
|
||||
## Gerenciamento de organização
|
||||
|
||||
Para alternar entre organizações ou ver sua organização atual, use o CLI da CrewAI:
|
||||
|
||||
```bash
|
||||
# Ver organização atual
|
||||
crewai org current
|
||||
|
||||
# Alternar para outra organização
|
||||
crewai org switch <org_id>
|
||||
|
||||
# Listar todas as organizações disponíveis
|
||||
crewai org list
|
||||
```
|
||||
|
||||
<Note>
|
||||
Ao carregar agentes de repositórios, você deve estar autenticado e ter alternado para a organização correta. Se você receber erros, verifique seu status de autenticação e as configurações de organização usando os comandos do CLI acima.
|
||||
</Note>
|
||||
103
docs/pt-BR/enterprise/features/automations.mdx
Normal file
103
docs/pt-BR/enterprise/features/automations.mdx
Normal file
@@ -0,0 +1,103 @@
|
||||
---
|
||||
title: "Automações"
|
||||
description: "Gerencie, implante e monitore seus crews (automações) em um só lugar."
|
||||
icon: "rocket"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## Visão geral
|
||||
|
||||
Automações é o hub operacional para seus crews implantados. Use para implantar via GitHub ou arquivo ZIP, gerenciar variáveis de ambiente, reimplantar quando necessário e monitorar o status de cada automação.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Métodos de implantação
|
||||
|
||||
### Implantar via GitHub
|
||||
|
||||
Use para projetos versionados e implantação contínua.
|
||||
|
||||
<Steps>
|
||||
<Step title="Conectar GitHub">
|
||||
Clique em <b>Configure GitHub</b> e autorize o acesso.
|
||||
</Step>
|
||||
<Step title="Selecionar Repositório & Branch">
|
||||
Escolha o <b>Repositório</b> e a <b>Branch</b> que deseja implantar.
|
||||
</Step>
|
||||
<Step title="Ativar Auto‑deploy (opcional)">
|
||||
Ative <b>Automatically deploy new commits</b> para publicar a cada push.
|
||||
</Step>
|
||||
<Step title="Adicionar Variáveis de Ambiente">
|
||||
Adicione segredos individualmente ou use <b>Bulk View</b> para múltiplas variáveis.
|
||||
</Step>
|
||||
<Step title="Implantar">
|
||||
Clique em <b>Deploy</b> para criar sua automação.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### Implantar via ZIP
|
||||
|
||||
Envie rapidamente sem Git — faça upload de um pacote ZIP do projeto.
|
||||
|
||||
<Steps>
|
||||
<Step title="Escolher arquivo">
|
||||
Selecione o arquivo ZIP do seu computador.
|
||||
</Step>
|
||||
<Step title="Adicionar Variáveis de Ambiente">
|
||||
Informe as variáveis necessárias.
|
||||
</Step>
|
||||
<Step title="Implantar">
|
||||
Clique em <b>Deploy</b> para criar sua automação.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Painel de Automações
|
||||
|
||||
A tabela lista todas as automações com detalhes chave:
|
||||
|
||||
- **CREW**: Nome da automação
|
||||
- **STATUS**: Online / Failed / In Progress
|
||||
- **URL**: Endpoint para kickoff/status
|
||||
- **TOKEN**: Token da automação
|
||||
- **ACTIONS**: Re‑deploy, delete e outros
|
||||
|
||||
Use os controles no canto superior direito para filtrar e pesquisar:
|
||||
|
||||
- Pesquisar por nome
|
||||
- Filtrar por <b>Status</b>
|
||||
- Filtrar por <b>Source</b> (GitHub / Studio / ZIP)
|
||||
|
||||
Após implantar, você pode ver os detalhes da automação e usar o menu **Options** para `chat with this crew`, `Export React Component` e `Export as MCP`.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Boas práticas
|
||||
|
||||
- Prefira implantações via GitHub para controle de versão e CI/CD
|
||||
- Use re‑deploy para avançar após mudanças de código/config ou habilite auto‑deploy a cada push
|
||||
|
||||
## Relacionados
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Implantar um Crew" href="/pt-BR/enterprise/guides/deploy-crew" icon="rocket">
|
||||
Implante um Crew via GitHub ou arquivo ZIP.
|
||||
</Card>
|
||||
<Card title="Gatilhos de Automação" href="/pt-BR/enterprise/guides/automation-triggers" icon="trigger">
|
||||
Dispare automações por webhooks ou API.
|
||||
</Card>
|
||||
<Card title="Automação com Webhook" href="/pt-BR/enterprise/guides/webhook-automation" icon="webhook">
|
||||
Transmita eventos e atualizações em tempo real.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
88
docs/pt-BR/enterprise/features/crew-studio.mdx
Normal file
88
docs/pt-BR/enterprise/features/crew-studio.mdx
Normal file
@@ -0,0 +1,88 @@
|
||||
---
|
||||
title: "Crew Studio"
|
||||
description: "Crie novas automações com assistência de IA, editor visual e testes integrados."
|
||||
icon: "pencil"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## Visão geral
|
||||
|
||||
O Crew Studio é um espaço interativo com assistência de IA para criar novas automações do zero usando linguagem natural e um editor visual de fluxo de trabalho.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Criação baseada em prompts
|
||||
|
||||
- Descreva a automação desejada; a IA gera agentes, tarefas e ferramentas.
|
||||
- Use entrada por voz pelo ícone de microfone se preferir.
|
||||
- Comece com prompts prontos para casos comuns.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Editor Visual
|
||||
|
||||
O canvas reflete o fluxo como nós e arestas com três painéis de suporte que permitem configurar o fluxo sem escrever código ("vibe coding AI Agents"):
|
||||
|
||||
- **AI Thoughts (esquerda)**: raciocínio em tempo real enquanto o fluxo é projetado
|
||||
- **Canvas (centro)**: agentes e tarefas como nós conectados
|
||||
- **Resources (direita)**: componentes de arrastar‑e‑soltar (agentes, tarefas, ferramentas)
|
||||
|
||||
Você pode arrastar e soltar agentes, tarefas e ferramentas no canvas ou usar a seção de chat para construir os agentes. Ambos compartilham estado e podem ser usados de forma intercambiável.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Execução & Depuração
|
||||
|
||||
Alterne para a visão <b>Execution</b> para executar e observar o fluxo:
|
||||
|
||||
- Linha do tempo de eventos
|
||||
- Logs detalhados (Details, Messages, Raw Data)
|
||||
- Execuções locais antes de publicar
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Publicar & Exportar
|
||||
|
||||
- <b>Publish</b> para implantar uma automação
|
||||
- <b>Download</b> do código‑fonte como ZIP para desenvolvimento local
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
Após publicar, você pode visualizar os detalhes da automação e usar o menu **Options** para `chat with this crew`, `Export React Component` e `Export as MCP`.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Boas práticas
|
||||
|
||||
- Itere rapidamente no Studio; publique apenas quando estiver estável
|
||||
- Restrinja permissões das ferramentas ao mínimo necessário
|
||||
- Use Traces para validar comportamento e desempenho
|
||||
|
||||
## Relacionados
|
||||
|
||||
<CardGroup cols={4}>
|
||||
<Card title="Habilitar o Crew Studio" href="/pt-BR/enterprise/guides/enable-crew-studio" icon="palette">
|
||||
Habilite o Crew Studio.
|
||||
</Card>
|
||||
<Card title="Criar um Crew" href="/pt-BR/enterprise/guides/build-crew" icon="paintbrush">
|
||||
Crie um Crew.
|
||||
</Card>
|
||||
<Card title="Implantar um Crew" href="/pt-BR/enterprise/guides/deploy-crew" icon="rocket">
|
||||
Implante um Crew via GitHub ou ZIP.
|
||||
</Card>
|
||||
<Card title="Exportar um Componente React" href="/pt-BR/enterprise/guides/react-component-export" icon="download">
|
||||
Exporte um componente React.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
@@ -1,180 +0,0 @@
|
||||
---
|
||||
title: Integrações
|
||||
description: "Aplicativos conectados para que seus agentes possam tomar ações."
|
||||
icon: "plug"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## 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. Pronto! Obtenha seu Token Enterprise do [CrewAI Enterprise](https://app.crewai.com) na aba **Integration**
|
||||
|
||||
<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)
|
||||
ferramentas_enterprise = CrewaiEnterpriseTools(
|
||||
enterprise_token="seu_token_enterprise"
|
||||
)
|
||||
# imprima as ferramentas
|
||||
printf(ferramentas_enterprise)
|
||||
|
||||
# Crie um agente com capacidades do Gmail
|
||||
agente_email = Agent(
|
||||
role="Gerente de E-mails",
|
||||
goal="Gerenciar e organizar comunicações por e-mail",
|
||||
backstory="Um assistente de IA especializado em gestão de e-mails e comunicação.",
|
||||
tools=ferramentas_enterprise
|
||||
)
|
||||
|
||||
# Tarefa para enviar um e-mail
|
||||
tarefa_email = Task(
|
||||
description="Redigir e enviar um e-mail de acompanhamento para john@example.com sobre a atualização do projeto",
|
||||
agent=agente_email,
|
||||
expected_output="Confirmação de que o e-mail foi enviado com sucesso"
|
||||
)
|
||||
|
||||
# Execute a tarefa
|
||||
crew = Crew(
|
||||
agents=[agente_email],
|
||||
tasks=[tarefa_email]
|
||||
)
|
||||
|
||||
# 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"]
|
||||
|
||||
agente_gmail = Agent(
|
||||
role="Gerente do Gmail",
|
||||
goal="Gerenciar comunicações e notificações do gmail",
|
||||
backstory="Um assistente de IA que ajuda a coordenar comunicações no gmail.",
|
||||
tools=[gmail_tool]
|
||||
)
|
||||
|
||||
tarefa_notificacao = Task(
|
||||
description="Encontrar o e-mail de john@example.com",
|
||||
agent=agente_gmail,
|
||||
expected_output="E-mail encontrado de john@example.com"
|
||||
)
|
||||
|
||||
# Execute a tarefa
|
||||
crew = Crew(
|
||||
agents=[agente_gmail],
|
||||
tasks=[tarefa_notificacao]
|
||||
)
|
||||
```
|
||||
|
||||
## 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>
|
||||
45
docs/pt-BR/enterprise/features/marketplace.mdx
Normal file
45
docs/pt-BR/enterprise/features/marketplace.mdx
Normal file
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: "Marketplace"
|
||||
description: "Descubra, instale e governe ativos reutilizáveis para seus crews enterprise."
|
||||
icon: "store"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## Visão geral
|
||||
|
||||
O Marketplace oferece uma superfície curada para descobrir integrações, ferramentas internas e ativos reutilizáveis que aceleram o desenvolvimento de crews.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Descoberta
|
||||
|
||||
- Navegue por categoria e capacidade
|
||||
- Pesquise por nome ou palavra‑chave
|
||||
|
||||
## Instalar & Habilitar
|
||||
|
||||
- Instalação com um clique para ativos aprovados
|
||||
- Habilite ou desabilite por crew conforme necessário
|
||||
- Configure variáveis de ambiente e escopos necessários
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
Você também pode baixar templates diretamente do marketplace clicando em `Download` para usar localmente ou personalizar conforme necessário.
|
||||
|
||||
## Relacionados
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Ferramentas & Integrações" href="/pt-BR/enterprise/features/tools-and-integrations" icon="wrench">
|
||||
Conecte apps externos e gerencie ferramentas internas que seus agentes podem usar.
|
||||
</Card>
|
||||
<Card title="Repositório de Ferramentas" href="/pt-BR/enterprise/features/tool-repository" icon="toolbox">
|
||||
Publique e instale ferramentas para ampliar as capacidades dos seus crews.
|
||||
</Card>
|
||||
<Card title="Repositório de Agentes" href="/pt-BR/enterprise/features/agent-repositories" icon="people-group">
|
||||
Armazene, compartilhe e reutilize definições de agentes entre equipes e projetos.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
@@ -7,11 +7,11 @@ mode: "wide"
|
||||
|
||||
## Visão Geral
|
||||
|
||||
O RBAC no CrewAI Enterprise 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 Enterprise" />
|
||||
|
||||
<img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI AMP" />
|
||||
|
||||
</Frame>
|
||||
|
||||
## Usuários e Funções
|
||||
@@ -28,7 +28,7 @@ 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 Enterprise.
|
||||
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.
|
||||
@@ -93,12 +93,10 @@ O owner sempre possui acesso. Em modo privado, somente usuários/funções na wh
|
||||
</Tip>
|
||||
|
||||
<Frame>
|
||||
<img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI Enterprise" />
|
||||
|
||||
<img src="/images/enterprise/visibility.png" alt="Configuração de visibilidade no CrewAI AMP" />
|
||||
|
||||
</Frame>
|
||||
|
||||
<Card title="Precisa de Ajuda?" icon="headset" href="mailto:support@crewai.com">
|
||||
Fale com o nosso time para suporte em configuração e auditoria de RBAC.
|
||||
</Card>
|
||||
|
||||
|
||||
|
||||
@@ -1,108 +0,0 @@
|
||||
---
|
||||
title: Repositório de Ferramentas
|
||||
description: "Usando o Repositório de Ferramentas para gerenciar suas ferramentas"
|
||||
icon: "toolbox"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## Visão geral
|
||||
|
||||
O Repositório de Ferramentas é um gerenciador de pacotes para ferramentas da CrewAI. Ele permite que usuários publiquem, instalem e gerenciem ferramentas que se integram com crews e flows da CrewAI.
|
||||
|
||||
As ferramentas podem ser:
|
||||
|
||||
- **Privadas**: acessíveis apenas dentro da sua organização (padrão)
|
||||
- **Públicas**: acessíveis a todos os usuários CrewAI se publicadas com a flag `--public`
|
||||
|
||||
O repositório não é um sistema de controle de versões. Use o Git para rastrear mudanças no código e permitir colaboração.
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
Antes de usar o Repositório de Ferramentas, certifique-se de que você possui:
|
||||
|
||||
- Uma conta [CrewAI Enterprise](https://app.crewai.com)
|
||||
- [CrewAI CLI](https://docs.crewai.com/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 Enterprise
|
||||
|
||||
## Instalando ferramentas
|
||||
|
||||
Para instalar uma ferramenta:
|
||||
|
||||
```bash
|
||||
crewai tool install <nome-da-ferramenta>
|
||||
```
|
||||
|
||||
Isso instala a ferramenta e a adiciona ao `pyproject.toml`.
|
||||
|
||||
## Criando e publicando ferramentas
|
||||
|
||||
Para criar um novo projeto de ferramenta:
|
||||
|
||||
```bash
|
||||
crewai tool create <nome-da-ferramenta>
|
||||
```
|
||||
|
||||
Isso gera um projeto de ferramenta estruturado localmente.
|
||||
|
||||
Após fazer alterações, inicialize um repositório Git e faça o commit do código:
|
||||
|
||||
```bash
|
||||
git init
|
||||
git add .
|
||||
git commit -m "Initial version"
|
||||
```
|
||||
|
||||
Para publicar a ferramenta:
|
||||
|
||||
```bash
|
||||
crewai tool publish
|
||||
```
|
||||
|
||||
Por padrão, as ferramentas são publicadas como privadas. Para tornar uma ferramenta pública:
|
||||
|
||||
```bash
|
||||
crewai tool publish --public
|
||||
```
|
||||
|
||||
Para mais detalhes sobre como construir ferramentas, acesse [Criando suas próprias ferramentas](https://docs.crewai.com/concepts/tools#creating-your-own-tools).
|
||||
|
||||
## Atualizando ferramentas
|
||||
|
||||
Para atualizar uma ferramenta publicada:
|
||||
|
||||
1. Modifique a ferramenta localmente
|
||||
2. Atualize a versão no `pyproject.toml` (por exemplo, de `0.1.0` para `0.1.1`)
|
||||
3. Faça o commit das alterações e publique
|
||||
|
||||
```bash
|
||||
git commit -m "Atualizar versão para 0.1.1"
|
||||
crewai tool publish
|
||||
```
|
||||
|
||||
## Excluindo ferramentas
|
||||
|
||||
Para excluir uma ferramenta:
|
||||
|
||||
1. Acesse o [CrewAI Enterprise](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.
|
||||
</Warning>
|
||||
|
||||
## Verificações de segurança
|
||||
|
||||
Cada versão publicada passa por verificações automáticas de segurança e só fica disponível para instalação após aprovação.
|
||||
|
||||
Você pode verificar o status das verificações de segurança de uma ferramenta em:
|
||||
|
||||
`CrewAI Enterprise > 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.
|
||||
</Card>
|
||||
234
docs/pt-BR/enterprise/features/tools-and-integrations.mdx
Normal file
234
docs/pt-BR/enterprise/features/tools-and-integrations.mdx
Normal file
@@ -0,0 +1,234 @@
|
||||
---
|
||||
title: "Ferramentas & Integrações"
|
||||
description: "Conecte apps externos e gerencie ferramentas internas que seus agentes podem usar."
|
||||
icon: "wrench"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
## Visão geral
|
||||
|
||||
Ferramentas & Integrações é o hub central para conectar aplicações de terceiros e gerenciar ferramentas internas que seus agentes podem usar em tempo de execução.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
## Explorar
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Integrações" icon="plug">
|
||||
|
||||
## Aplicativos para Agentes (Integrações)
|
||||
|
||||
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>
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### 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 na aba <b>Integração</b>
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
### Instalar ferramentas de integração
|
||||
|
||||
Para usar as integrações localmente, instale a versão mais recente do pacote `crewai-tools`.
|
||||
|
||||
```bash
|
||||
uv add crewai-tools
|
||||
```
|
||||
|
||||
### Exemplo de uso
|
||||
|
||||
<Tip>
|
||||
Todos os serviços autenticados ficam disponíveis como ferramentas. Adicione `CrewaiEnterpriseTools` ao agente e pronto.
|
||||
</Tip>
|
||||
|
||||
```python
|
||||
from crewai import Agent, Task, Crew
|
||||
from crewai_tools import CrewaiEnterpriseTools
|
||||
|
||||
enterprise_tools = CrewaiEnterpriseTools(
|
||||
enterprise_token="seu_enterprise_token"
|
||||
)
|
||||
print(enterprise_tools)
|
||||
|
||||
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",
|
||||
tools=enterprise_tools
|
||||
)
|
||||
|
||||
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()
|
||||
```
|
||||
|
||||
### Filtrando ferramentas
|
||||
|
||||
```python
|
||||
from crewai_tools import CrewaiEnterpriseTools
|
||||
|
||||
enterprise_tools = CrewaiEnterpriseTools(
|
||||
actions_list=["gmail_find_email"]
|
||||
)
|
||||
|
||||
gmail_tool = enterprise_tools["gmail_find_email"]
|
||||
|
||||
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",
|
||||
tools=[gmail_tool]
|
||||
)
|
||||
|
||||
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])
|
||||
```
|
||||
|
||||
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>
|
||||
|
||||
</Frame>
|
||||
|
||||
### 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).
|
||||
|
||||
<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.
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
<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
|
||||
|
||||
#### 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
|
||||
|
||||
#### CRM
|
||||
- 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
|
||||
|
||||
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 AMP:
|
||||
```bash
|
||||
crewai login
|
||||
```
|
||||
</Tip>
|
||||
|
||||
<Frame>
|
||||
|
||||
</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>
|
||||
|
||||
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
|
||||
|
||||
<Frame>
|
||||
|
||||
</Frame>
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Relacionados
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Repositório de Ferramentas" href="/pt-BR/enterprise/features/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">
|
||||
Automatize fluxos e integre com plataformas e serviços externos.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
@@ -11,7 +11,7 @@ Traces fornecem visibilidade abrangente sobre as execuções dos seus crews, aju
|
||||
|
||||
## O que são Traces?
|
||||
|
||||
Traces no CrewAI Enterprise 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
|
||||
@@ -28,9 +28,9 @@ Traces no CrewAI Enterprise são registros detalhados de execução que capturam
|
||||
|
||||
<Steps>
|
||||
<Step title="Navegue até a aba Traces">
|
||||
No seu painel do CrewAI Enterprise, 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">
|
||||
Você verá uma lista de todas as execuções do crew, ordenadas por data. Clique em qualquer execução para visualizar seu trace detalhado.
|
||||
</Step>
|
||||
@@ -112,7 +112,7 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
|
||||
<Steps>
|
||||
<Step title="Identifique Pontos de Falha">
|
||||
Quando uma execução de crew não produzir os resultados esperados, examine o trace para encontrar onde ocorreu o problema. Procure por:
|
||||
|
||||
|
||||
- Tarefas que falharam
|
||||
- Decisões inesperadas dos agentes
|
||||
- Erros no uso de ferramentas
|
||||
@@ -122,19 +122,19 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
|
||||
|
||||
</Frame>
|
||||
</Step>
|
||||
|
||||
|
||||
<Step title="Otimizar Desempenho">
|
||||
Use métricas de execução para identificar gargalos de desempenho:
|
||||
|
||||
|
||||
- Tarefas que demoraram mais do que o esperado
|
||||
- Uso excessivo de tokens
|
||||
- Operações redundantes de ferramentas
|
||||
- Chamadas de API desnecessárias
|
||||
</Step>
|
||||
|
||||
|
||||
<Step title="Melhore a Eficiência de Custos">
|
||||
Analise o uso de tokens e as estimativas de custo para otimizar a eficiência do seu crew:
|
||||
|
||||
|
||||
- Considere usar modelos menores para tarefas mais simples
|
||||
- Refine prompts para serem mais concisos
|
||||
- Faça cache de informações acessadas frequentemente
|
||||
@@ -143,5 +143,5 @@ Traces são indispensáveis para solucionar problemas nos seus crews:
|
||||
</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 Enterprise.
|
||||
</Card>
|
||||
Entre em contato com nossa equipe de suporte para assistência com análise de traces ou outros recursos do CrewAI AMP.
|
||||
</Card>
|
||||
|
||||
@@ -7,7 +7,7 @@ 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 Enterprise, 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
|
||||
|
||||
@@ -81,4 +81,4 @@ Você pode emitir seus próprios eventos personalizados, e eles serão entregues
|
||||
|
||||
<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.
|
||||
</Card>
|
||||
</Card>
|
||||
|
||||
Reference in New Issue
Block a user