mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-05-02 07:42:40 +00:00
WIP: v1 docs (#3626)
(cherry picked from commit d46e20fa09bcd2f5916282f5553ddeb7183bd92c)
This commit is contained in:
Tony Kipkemboi
158
docs/pt-BR/enterprise/features/agent-repositories.mdx
Normal file
158
docs/pt-BR/enterprise/features/agent-repositories.mdx
Normal file
@@ -0,0 +1,158 @@
|
||||
---
|
||||
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>
|
||||
|
||||
|
||||
105
docs/pt-BR/enterprise/features/automations.mdx
Normal file
105
docs/pt-BR/enterprise/features/automations.mdx
Normal file
@@ -0,0 +1,105 @@
|
||||
---
|
||||
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>
|
||||
|
||||
|
||||
90
docs/pt-BR/enterprise/features/crew-studio.mdx
Normal file
90
docs/pt-BR/enterprise/features/crew-studio.mdx
Normal file
@@ -0,0 +1,90 @@
|
||||
---
|
||||
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>
|
||||
|
||||
|
||||
47
docs/pt-BR/enterprise/features/marketplace.mdx
Normal file
47
docs/pt-BR/enterprise/features/marketplace.mdx
Normal file
@@ -0,0 +1,47 @@
|
||||
---
|
||||
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>
|
||||
|
||||
|
||||
236
docs/pt-BR/enterprise/features/tools-and-integrations.mdx
Normal file
236
docs/pt-BR/enterprise/features/tools-and-integrations.mdx
Normal file
@@ -0,0 +1,236 @@
|
||||
---
|
||||
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 Enterprise e use nos seus agentes.
|
||||
|
||||
<Tip>
|
||||
Antes de executar os comandos abaixo, faça login na sua conta CrewAI Enterprise:
|
||||
```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>
|
||||
|
||||
|
||||
@@ -1,75 +1,138 @@
|
||||
---
|
||||
title: "Triggers de Automação"
|
||||
description: "Execute automaticamente seus workflows CrewAI quando eventos específicos ocorrem em integrações conectadas"
|
||||
title: "Visão Geral de Triggers"
|
||||
description: "Entenda como os triggers da CrewAI Enterprise funcionam, como gerenciá-los e onde encontrar playbooks específicos de integração"
|
||||
icon: "bolt"
|
||||
mode: "wide"
|
||||
---
|
||||
|
||||
Os triggers de automação permitem executar automaticamente suas implantações CrewAI quando eventos específicos ocorrem em suas integrações conectadas, criando workflows poderosos orientados por eventos que respondem a mudanças em tempo real em seus sistemas de negócio.
|
||||
Os triggers da CrewAI Enterprise 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.
|
||||
|
||||
## Visão Geral
|
||||
<iframe
|
||||
className="w-full aspect-video rounded-xl"
|
||||
src="https://www.youtube.com/embed/TpQ45lAZh48"
|
||||
title="Visão geral dos triggers da CrewAI"
|
||||
frameBorder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowFullScreen
|
||||
></iframe>
|
||||
|
||||
Com triggers de automação, você pode:
|
||||
### Playbooks de Integração
|
||||
|
||||
- **Responder a eventos em tempo real** - Execute workflows automaticamente quando condições específicas forem atendidas
|
||||
- **Integrar com sistemas externos** - Conecte com plataformas como Gmail, Outlook, OneDrive, JIRA, Slack, Stripe e muito mais
|
||||
- **Escalar sua automação** - Lide com eventos de alto volume sem intervenção manual
|
||||
- **Manter contexto** - Acesse dados do trigger dentro de suas crews e flows
|
||||
Os guias abaixo explicam, em detalhe, como habilitar e testar cada integração:
|
||||
|
||||
## Gerenciando Triggers de Automação
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Trigger do Gmail" icon="envelope">
|
||||
<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 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 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 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 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>
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Capacidades dos Triggers
|
||||
|
||||
Com triggers você pode:
|
||||
|
||||
- **Responder em tempo real** – Executar workflows automaticamente quando condições forem atendidas
|
||||
- **Integrar com sistemas externos** – Conectar Gmail, Outlook, OneDrive, JIRA, Slack, Stripe e muito mais
|
||||
- **Escalar automações** – Lidar com alto volume de eventos sem intervenção manual
|
||||
- **Manter contexto** – Acessar dados do trigger dentro das suas crews e flows
|
||||
|
||||
## Gerenciando Triggers
|
||||
|
||||
### Visualizando Triggers Disponíveis
|
||||
|
||||
Para acessar e gerenciar seus triggers de automação:
|
||||
|
||||
1. Navegue até sua implantação no painel do CrewAI
|
||||
2. Clique na aba **Triggers** para visualizar todas as integrações de trigger disponíveis
|
||||
1. Abra sua automação no painel da CrewAI
|
||||
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 de automação disponíveis" />
|
||||
<img src="/images/enterprise/list-available-triggers.png" alt="Lista de triggers disponíveis" />
|
||||
</Frame>
|
||||
|
||||
Esta visualização mostra todas as integrações de trigger disponíveis para sua implantação, junto com seus status de conexão atuais.
|
||||
### Habilitando e Desabilitando
|
||||
|
||||
### Habilitando e Desabilitando Triggers
|
||||
|
||||
Cada trigger pode ser facilmente habilitado ou desabilitado usando o botão de alternância:
|
||||
Cada trigger possui uma chave de ativação:
|
||||
|
||||
<Frame>
|
||||
<img src="/images/enterprise/trigger-selected.png" alt="Habilitar ou desabilitar triggers com alternância" />
|
||||
<img src="/images/enterprise/trigger-selected.png" alt="Alternância de trigger habilitado" />
|
||||
</Frame>
|
||||
|
||||
- **Habilitado (alternância azul)**: O trigger está ativo e executará automaticamente sua implantação quando os eventos especificados ocorrerem
|
||||
- **Desabilitado (alternância cinza)**: O trigger está inativo e não responderá a eventos
|
||||
- **Habilitado (azul)** – Executa a automação quando o evento ocorrer
|
||||
- **Desabilitado (cinza)** – Ignora eventos
|
||||
|
||||
Simplesmente clique na alternância para mudar o estado do trigger. As alterações entram em vigor imediatamente.
|
||||
As alterações são aplicadas imediatamente.
|
||||
|
||||
### Monitorando Execuções de Trigger
|
||||
### Monitorando Execuções
|
||||
|
||||
Acompanhe o desempenho e histórico de suas execuções acionadas:
|
||||
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 automação" />
|
||||
<img src="/images/enterprise/list-executions.png" alt="Lista de execuções acionadas por triggers" />
|
||||
</Frame>
|
||||
|
||||
## Construindo Automação
|
||||
## Construindo Automações Orientadas por Trigger
|
||||
|
||||
Antes de construir sua automação, é útil entender a estrutura dos payloads de trigger que suas crews e flows receberão.
|
||||
### Checklist de Configuração
|
||||
|
||||
### Repositório de Amostras de Payload
|
||||
Antes de ativar em produção, confirme que você:
|
||||
|
||||
Mantemos um repositório abrangente com amostras de payload de várias fontes de trigger para ajudá-lo a construir e testar suas automações:
|
||||
- Conectou a integração em **Tools & Integrations** e concluiu OAuth ou configuração de API
|
||||
- Habilitou o trigger na automação correta
|
||||
- Definiu variáveis de ambiente necessárias (tokens, IDs de tenant, segredos)
|
||||
- Criou tarefas que analisam o payload no primeiro passo da crew/flow
|
||||
- Decidiu se usará `allow_crewai_trigger_context` para injetar contexto automaticamente
|
||||
- Configurou monitoramento (webhooks, históricos da CrewAI, alertas externos)
|
||||
|
||||
**🔗 [Amostras de Payload de Trigger CrewAI Enterprise](https://github.com/crewAIInc/crewai-enterprise-trigger-payload-samples)**
|
||||
### Repositório de Payloads e Crews de Exemplo
|
||||
|
||||
Este repositório contém:
|
||||
| Integração | Quando dispara | Amostras de payload | Crews de exemplo |
|
||||
| :-- | :-- | :-- | :-- |
|
||||
| Gmail | Novas mensagens, atualização de threads | [Payloads de alertas e threads](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/gmail) | [`new-email-crew.py`, `gmail-alert-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/gmail) |
|
||||
| Google Calendar | Evento criado/atualizado/iniciado/encerrado/cancelado | [Payloads de eventos](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_calendar) | [`calendar-event-crew.py`, `calendar-meeting-crew.py`, `calendar-working-location-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_calendar) |
|
||||
| Google Drive | Arquivo criado/atualizado/excluído | [Payloads de arquivos](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_drive) | [`drive-file-crew.py`, `drive-file-deletion-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/google_drive) |
|
||||
| Outlook | Novo e‑mail, evento removido | [Payloads do Outlook](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/outlook) | [`outlook-message-crew.py`, `outlook-event-removal-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/outlook) |
|
||||
| OneDrive | Operações de arquivo (criar, atualizar, compartilhar, excluir) | [Payloads do OneDrive](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/onedrive) | [`onedrive-file-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/onedrive) |
|
||||
| HubSpot | Registros criados/atualizados (contatos, empresas, negócios) | [Payloads do HubSpot](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/hubspot) | [`hubspot-company-crew.py`, `hubspot-contact-crew.py`, `hubspot-record-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/hubspot) |
|
||||
| Microsoft Teams | Chat criado | [Payload do Teams](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/microsoft-teams) | [`teams-chat-created-crew.py`](https://github.com/crewAIInc/crewai-enterprise-trigger-examples/tree/main/microsoft-teams) |
|
||||
|
||||
- **Exemplos reais de payload** de diferentes fontes de trigger (Gmail, Google Drive, etc.)
|
||||
- **Documentação da estrutura de payload** mostrando o formato e campos disponíveis
|
||||
Use essas amostras para ajustar o parsing, copiar a crew correspondente e substituir o payload de teste pelo dado real.
|
||||
|
||||
### Triggers com Crew
|
||||
### Triggers com Crews
|
||||
|
||||
Suas definições de crew existentes funcionam perfeitamente com triggers, você só precisa ter uma tarefa para analisar o payload recebido:
|
||||
Suas definições de crew funcionam naturalmente com triggers; basta ter uma tarefa que processe o payload recebido:
|
||||
|
||||
```python
|
||||
@CrewBase
|
||||
@@ -95,15 +158,13 @@ class MinhaCrewAutomatizada:
|
||||
)
|
||||
```
|
||||
|
||||
A crew receberá automaticamente e pode acessar o payload do trigger através dos mecanismos de contexto padrão do CrewAI.
|
||||
|
||||
### Integração com Flows
|
||||
|
||||
Para flows, você tem mais controle sobre como os dados do trigger são tratados:
|
||||
Flows oferecem controle adicional sobre o uso do payload:
|
||||
|
||||
#### Acessando Payload do Trigger
|
||||
#### Acessando o Payload
|
||||
|
||||
Todos os métodos `@start()` em seus flows aceitarão um parâmetro adicional chamado `crewai_trigger_payload`:
|
||||
Todos os métodos `@start()` podem receber `crewai_trigger_payload`:
|
||||
|
||||
```python
|
||||
from crewai.flow import Flow, start, listen
|
||||
@@ -111,62 +172,48 @@ from crewai.flow import Flow, start, listen
|
||||
class MeuFlowAutomatizado(Flow):
|
||||
@start()
|
||||
def lidar_com_trigger(self, crewai_trigger_payload: dict = None):
|
||||
"""
|
||||
Este método start pode receber dados do trigger
|
||||
"""
|
||||
if crewai_trigger_payload:
|
||||
# Processa os dados do trigger
|
||||
trigger_id = crewai_trigger_payload.get('id')
|
||||
dados_evento = crewai_trigger_payload.get('payload', {})
|
||||
|
||||
# Armazena no estado do flow para uso por outros métodos
|
||||
self.state.trigger_id = trigger_id
|
||||
self.state.trigger_type = dados_evento
|
||||
|
||||
return dados_evento
|
||||
|
||||
# Lida com execução manual
|
||||
return None
|
||||
|
||||
@listen(lidar_com_trigger)
|
||||
def processar_dados(self, dados_trigger):
|
||||
"""
|
||||
Processa os dados do trigger
|
||||
"""
|
||||
# ... processa o trigger
|
||||
```
|
||||
|
||||
#### Acionando Crews a partir de Flows
|
||||
|
||||
Ao iniciar uma crew dentro de um flow que foi acionado, passe o payload do trigger conforme ele:
|
||||
|
||||
```python
|
||||
@start()
|
||||
def delegar_para_crew(self, crewai_trigger_payload: dict = None):
|
||||
"""
|
||||
Delega processamento para uma crew especializada
|
||||
"""
|
||||
crew = MinhaCrewEspecializada()
|
||||
|
||||
# Passa o payload do trigger para a crew
|
||||
resultado = crew.crew().kickoff(
|
||||
inputs={
|
||||
'parametro_personalizado': "valor_personalizado",
|
||||
'crewai_trigger_payload': crewai_trigger_payload
|
||||
},
|
||||
)
|
||||
|
||||
return resultado
|
||||
```
|
||||
|
||||
## Solução de Problemas
|
||||
|
||||
**Trigger não está sendo disparado:**
|
||||
- Verifique se o trigger está habilitado
|
||||
- Verifique o status de conexão da integração
|
||||
**Trigger não dispara:**
|
||||
- Verifique se está habilitado
|
||||
- Confira o status da conexão
|
||||
|
||||
**Falhas de execução:**
|
||||
- Verifique os logs de execução para detalhes do erro
|
||||
- Se você está desenvolvendo, certifique-se de que as entradas incluem o parâmetro `crewai_trigger_payload` com o payload correto
|
||||
- Consulte os logs para entender o erro
|
||||
- Durante o desenvolvimento, garanta que `crewai_trigger_payload` está presente com o payload correto
|
||||
|
||||
Os triggers de automação transformam suas implantações CrewAI em sistemas responsivos orientados por eventos que podem se integrar perfeitamente com seus processos de negócio e ferramentas existentes.
|
||||
Os triggers transformam suas implantações CrewAI em sistemas orientados por eventos, integrando-se perfeitamente aos processos e ferramentas já usados pelo seu time.
|
||||
|
||||
<Callout icon="github" title="Exemplos na prática">
|
||||
<a href="https://github.com/crewAIInc/crewai-enterprise-trigger-examples">
|
||||
Repositório CrewAI Enterprise Trigger Examples
|
||||
</a>
|
||||
</Callout>
|
||||
|
||||
@@ -12,14 +12,12 @@ mode: "wide"
|
||||
## Primeiros Passos
|
||||
|
||||
<iframe
|
||||
width="100%"
|
||||
height="400"
|
||||
src="https://www.youtube.com/embed/-kSOTtYzgEw"
|
||||
title="Building Crews with CrewAI CLI"
|
||||
frameborder="0"
|
||||
style={{ borderRadius: '10px' }}
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowfullscreen
|
||||
className="w-full aspect-video rounded-xl"
|
||||
src="https://www.youtube.com/embed/-kSOTtYzgEw"
|
||||
title="Building crews with the CrewAI CLI"
|
||||
frameBorder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowFullScreen
|
||||
></iframe>
|
||||
|
||||
### Instalação e Configuração
|
||||
|
||||
@@ -18,9 +18,14 @@ O Salesforce é uma das principais plataformas de gestão de relacionamento com
|
||||
|
||||
## Demonstração
|
||||
|
||||
<Frame>
|
||||
<iframe width="100%" height="400" src="https://www.youtube.com/embed/oJunVqjjfu4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||
</Frame>
|
||||
<iframe
|
||||
className="w-full aspect-video rounded-xl"
|
||||
src="https://www.youtube.com/embed/oJunVqjjfu4"
|
||||
title="Demonstração de trigger CrewAI + Salesforce"
|
||||
frameBorder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowFullScreen
|
||||
></iframe>
|
||||
|
||||
## Primeiros Passos
|
||||
|
||||
@@ -42,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 Enterprise, 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 Enterprise, que pode fornecer orientações personalizadas para o seu ambiente Salesforce e necessidades de negócio.
|
||||
|
||||
@@ -14,7 +14,7 @@ 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.
|
||||
O repositório não é um sistema de controle de versões. Use Git para rastrear mudanças no código e permitir colaboração.
|
||||
|
||||
## Pré-requisitos
|
||||
|
||||
@@ -102,7 +102,8 @@ Você pode verificar o status das verificações de segurança de uma ferramenta
|
||||
|
||||
`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>
|
||||
</Card>
|
||||
|
||||
|
||||
@@ -129,15 +129,14 @@ mode: "wide"
|
||||
</Steps>
|
||||
|
||||
Aqui está um tutorial de como obter saídas estruturadas de forma consistente dos seus agentes:
|
||||
<Frame>
|
||||
<iframe
|
||||
height="400"
|
||||
width="100%"
|
||||
src="https://www.youtube.com/embed/dNpKQk5uxHw"
|
||||
title="YouTube video player" frameborder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowfullscreen></iframe>
|
||||
</Frame>
|
||||
<iframe
|
||||
className="w-full aspect-video rounded-xl"
|
||||
src="https://www.youtube.com/embed/dNpKQk5uxHw"
|
||||
title="Saídas estruturadas no CrewAI"
|
||||
frameBorder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowFullScreen
|
||||
></iframe>
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Como posso criar ferramentas personalizadas para meus agentes CrewAI?">
|
||||
|
||||
Reference in New Issue
Block a user