docs: Fix API Reference, add RBAC, revamp Examples/Cookbooks (EN/PT-BR/KO) (#3314)

* docs: add RBAC docs and other chores * docs: fix API Reference rendering; per-locale OpenAPI; add Enterprise RBAC; restructure Examples (EN/PT-BR/KO) + Cookbooks; update nav and links * docs(i18n): add RBAC docs for pt-BR and ko; update Enterprise Features nav
2026-01-10 00:28:31 +00:00 · 2025-08-13 13:13:24 -04:00
parent e9b1e5a8f6
commit dc6771ae95
7 changed files with 411 additions and 113 deletions
--- a/docs/pt-BR/enterprise/features/rbac.mdx
+++ b/docs/pt-BR/enterprise/features/rbac.mdx
@@ -0,0 +1,103 @@
+---
+title: "Controle de Acesso Baseado em Funções (RBAC)"
+description: "Controle o acesso a crews, ferramentas e dados com funções e visibilidade por automação."
+icon: "shield"
+---
+
+## 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**.
+
+<Frame>
+  <img src="/images/enterprise/users_and_roles.png" alt="Visão geral de RBAC no CrewAI Enterprise" />
+  
+</Frame>
+
+## Usuários e Funções
+
+Cada membro da sua workspace possui uma função, que determina o acesso aos recursos.
+
+Você pode:
+
+- Usar funções pré-definidas (Owner, Member)
+- Criar funções personalizadas com permissões específicas
+- Atribuir funções a qualquer momento no painel de configurações
+
+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.
+  </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.
+  </Step>
+  <Step title="Atribuir aos membros">
+    Selecione os usuários e atribua a função. Você pode alterar depois.
+  </Step>
+</Steps>
+
+### 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 |
+
+## Controle de Acesso em Nível de Automação
+
+Além das funções na organização, as **Automations** suportam visibilidade refinada para restringir acesso por usuário ou função.
+
+Útil para:
+
+- Manter automações sensíveis/experimentais privadas
+- Gerenciar visibilidade em equipes grandes ou colaboradores externos
+- Testar automações em contexto isolado
+
+Em modo privado, somente usuários/funções na whitelist poderão:
+
+- Ver a automação
+- Executar/usar a API
+- Acessar logs, métricas e configurações
+
+O owner da organização sempre tem acesso, independente da visibilidade.
+
+Configure em Automation → Settings → Visibility.
+
+<Steps>
+  <Step title="Abrir a aba Visibility">
+    Acesse <b>Automation → Settings → Visibility</b>.
+  </Step>
+  <Step title="Definir visibilidade">
+    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.
+  </Step>
+  <Step title="Salvar e verificar">
+    Salve e confirme que não listados não conseguem ver ou executar a automação.
+  </Step>
+</Steps>
+
+### 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 | ✓ | ✓ | ✗ |
+
+<Tip>
+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 Enterprise" />
+  
+</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>
+
+
--- a/docs/pt-BR/examples/cookbooks.mdx
+++ b/docs/pt-BR/examples/cookbooks.mdx
@@ -0,0 +1,22 @@
+---
+title: CrewAI Cookbooks
+description: Quickstarts e notebooks focados em recursos para aprender padrões rapidamente.
+icon: book
+---
+
+## Quickstarts & Demos
+
+<CardGroup cols={2}>
+  <Card title="Repositório de Quickstarts" icon="bolt" href="https://github.com/crewAIInc/crewAI-quickstarts">
+    Demos e projetos pequenos que mostram capacidades específicas do CrewAI.
+  </Card>
+  <Card title="Notebooks nos Exemplos" icon="book-open" href="https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks">
+    Notebooks interativos para aprendizado prático.
+  </Card>
+</CardGroup>
+
+<Tip>
+Use Cookbooks para aprender um padrão rapidamente e, em seguida, avance para os Exemplos completos para implementações de produção.
+</Tip>
+
+
--- a/docs/pt-BR/examples/example.mdx
+++ b/docs/pt-BR/examples/example.mdx
@@ -1,62 +1,85 @@
 ---
 title: Exemplos CrewAI
-description: Uma coleção de exemplos que mostram como usar o framework CrewAI para automatizar fluxos de trabalho.
+description: Explore exemplos organizados por Crews, Flows, Integrações e Notebooks.
 icon: rocket-launch
 ---

+## Crews
+
 <CardGroup cols={3}>
-  <Card
-  title="Estratégia de Marketing"
-  color="#F3A78B"
-  href="https://github.com/crewAIInc/crewAI-examples/tree/main/marketing_strategy"
-  icon="bullhorn"
-    iconType="solid"
-  >
-    Automatize a criação de estratégias de marketing com CrewAI.
+  <Card title="Estratégia de Marketing" icon="bullhorn" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/marketing_strategy">
+    Planejamento de campanhas com múltiplos agentes.
+  </Card>
+  <Card title="Viagem Surpresa" icon="plane" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/surprise_trip">
+    Planejamento de viagens personalizadas.
+  </Card>
+  <Card title="Relacionar Perfil a Posições" icon="id-card" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/match_profile_to_positions">
+    Correspondência de CV para vagas com busca vetorial.
+  </Card>
+  <Card title="Criar Vaga" icon="newspaper" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/job-posting">
+    Criação automatizada de descrições de vagas.
+  </Card>
+  <Card title="Crew Construtor de Jogos" icon="gamepad" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/game-builder-crew">
+    Equipe multiagente que projeta e constrói jogos em Python.
+  </Card>
+  <Card title="Recrutamento" icon="user-group" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews/recruitment">
+    Prospecção e avaliação de candidatos.
+  </Card>
+  <Card title="Ver todos os Crews" icon="users" href="https://github.com/crewAIInc/crewAI-examples/tree/main/crews">
+    Lista completa de exemplos de crews.
+  </Card>
+</CardGroup>
+
+## Flows
+
+<CardGroup cols={3}>
+  <Card title="Content Creator Flow" icon="pen" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/content_creator_flow">
+    Geração de conteúdo com roteamento.
+  </Card>
+  <Card title="Email Auto Responder" icon="envelope" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/email_auto_responder_flow">
+    Monitoramento e respostas de e‑mail.
+  </Card>
+  <Card title="Lead Score Flow" icon="chart-line" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/lead_score_flow">
+    Qualificação de leads com revisão humana.
+  </Card>
+  <Card title="Meeting Assistant Flow" icon="calendar" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/meeting_assistant_flow">
+    Processamento de notas com integrações.
+  </Card>
+  <Card title="Self Evaluation Loop" icon="rotate" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/self_evaluation_loop_flow">
+    Fluxos de autoaperfeiçoamento iterativo.
+  </Card>
+  <Card title="Escrever um Livro (Flows)" icon="book" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows/write_a_book_with_flows">
+    Geração paralela de capítulos.
+  </Card>
+  <Card title="Ver todos os Flows" icon="diagram-project" href="https://github.com/crewAIInc/crewAI-examples/tree/main/flows">
+    Lista completa de exemplos de flows.
+  </Card>
+</CardGroup>
+
+## Integrações
+
+<CardGroup cols={3}>
+  <Card title="CrewAI ↔ LangGraph" icon="link" href="https://github.com/crewAIInc/crewAI-examples/tree/main/integrations/crewai-langgraph">
+    Integração com o framework LangGraph.
+  </Card>
+  <Card title="Azure OpenAI" icon="cloud" href="https://github.com/crewAIInc/crewAI-examples/tree/main/integrations/azure_model">
+    Usando CrewAI com Azure OpenAI.
+  </Card>
+  <Card title="Modelos NVIDIA" icon="microchip" href="https://github.com/crewAIInc/crewAI-examples/tree/main/integrations/nvidia_models">
+    Integrações com o ecossistema NVIDIA.
+  </Card>
+  <Card title="Ver todas as Integrações" icon="puzzle-piece" href="https://github.com/crewAIInc/crewAI-examples/tree/main/integrations">
+    Todos os exemplos de integrações.
+  </Card>
+</CardGroup>
+
+## Notebooks
+
+<CardGroup cols={2}>
+  <Card title="Simple QA Crew + Flow" icon="book" href="https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks/Simple%20QA%20Crew%20%2B%20Flow">
+    Simple QA Crew + Flow.
+  </Card>
+  <Card title="Todos os Notebooks" icon="book" href="https://github.com/crewAIInc/crewAI-examples/tree/main/Notebooks">
+    Exemplos interativos para aprendizado e experimentação.
  </Card>
-  <Card
-    title="Viagem Surpresa"
-    color="#F3A78B"
-    href="https://github.com/crewAIInc/crewAI-examples/tree/main/surprise_trip"
-    icon="plane"
-      iconType="duotone"
-    >
-      Crie um roteiro de viagem surpresa com CrewAI.
-    </Card>
-    <Card
-    title="Relacionar Perfil a Posições"
-    color="#F3A78B"
-    href="https://github.com/crewAIInc/crewAI-examples/tree/main/match_profile_to_positions"
-    icon="linkedin"
-      iconType="duotone"
-    >
-      Relacione um perfil a vagas de emprego com CrewAI.
-    </Card>
-    <Card
-    title="Criar Vaga"
-    color="#F3A78B"
-    href="https://github.com/crewAIInc/crewAI-examples/tree/main/job-posting"
-    icon="newspaper"
-      iconType="duotone"
-    >
-      Crie uma vaga de emprego com CrewAI.
-    </Card>
-    <Card
-    title="Gerador de Jogos"
-    color="#F3A78B"
-    href="https://github.com/crewAIInc/crewAI-examples/tree/main/game-builder-crew"
-    icon="gamepad"
-      iconType="duotone"
-    >
-      Crie um jogo com CrewAI.
-    </Card>
-    <Card
-    title="Encontrar Candidatos"
-    color="#F3A78B"
-    href="https://github.com/crewAIInc/crewAI-examples/tree/main/recruitment"
-    icon="user-group"
-      iconType="duotone"
-    >
-      Encontre candidatos a vagas com CrewAI.
-    </Card>
 </CardGroup>