Repolode
Enviar
tiagovilasboas

tiagovilasboas/grok-bot-architecture

Uma arquitetura de referência, sob licença MIT, para organizar equipes de agentes de IA com habilidades reutilizáveis por função, conectores MCP e etapas de aprovação humana.

Ver no GitHub
Estrelas
49
Forks
11
Issues abertas
0
Último commit
há 9 dias

O que é?

Este repositório apresenta uma referência independente de modelo e framework para estruturar uma equipe de agentes de IA. Um agente chief of staff transforma objetivos em tarefas com escopo definido e as encaminha a especialistas em áreas como engenharia, publicação, segurança, triagem de caixa de entrada e análise de oportunidades de carreira. Cada função é definida por uma receita reutilizável em SKILL.md e opera com permissões de ferramentas impostas pelo host, em vez de acesso irrestrito.

A ideia central é manter uma pessoa no processo de aprovação. Ações privilegiadas geram uma solicitação que aguarda uma decisão autenticada, vinculada à ação e à revisão exatas; se houver timeout, o padrão é aguardar, não prosseguir. Registros de encaminhamento tipados e um quadro em Markdown levam tarefas e evidências de uma função a outra. O repositório também inclui validadores JSON, ferramentas para o quadro e um exemplo local, com escopo limitado, do ciclo de aprovação.

O projeto também documenta como adaptar esse padrão ao Grok Bot, com etapas de configuração, orientações sobre políticas de aprovação e um passo a passo. Ele não contém o código-fonte do produto Grok Bot e não é afiliado à xAI.

Recursos principais

  • 01Agente chief of staff que define o escopo, atribui e revisa o trabalho das funções especializadas
  • 02Nove habilidades reutilizáveis por função, definidas como receitas em SKILL.md
  • 03Etapas de aprovação que vinculam cada decisão a uma revisão exata da ação e aguardam em caso de timeout
  • 04Registros de encaminhamento tipados e um quadro em Markdown para compartilhar estado e evidências
  • 05Validadores JSON e um exemplo local do ciclo de aprovação sem dependências externas

Casos de uso

  • Projetar uma equipe de assistentes de IA persistentes, cada um responsável por um domínio distinto, como e-mail ou código
  • Exigir aprovação humana antes que um agente envie mensagens, faça merge de código ou altere sistemas externos
  • Adaptar permissões e encaminhamentos baseados em funções a um host de agentes existente
  • Aprender padrões de limites de confiança para sistemas de agentes antes de escrever código de produção

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/tiagovilasboas/grok-bot-architecture.git
  2. 2

    Acesse a pasta do projeto

    cd grok-bot-architecture
  3. 3

    Execute a verificação local do ciclo de validação e aprovação

    bash scripts/check.sh

Antes de usar

  • Esta é uma arquitetura de referência e um padrão de documentação, não um sistema autônomo de agentes em tempo de execução.
  • O caminho de configuração do Grok Bot depende de um produto Grok Bot separado, cujo código-fonte não está incluído.
  • Os validadores verificam apenas a estrutura dos arquivos e não autenticam os responsáveis humanos pela aprovação nem executam efeitos colaterais.

Em coleções

Frameworks de orquestração multiagenteFrameworks e apps de agentes de IA open sourceServidores MCPAgentes pessoais de IA open source

Tópicos

#ai-agents#multi-agent#mcp#human-in-the-loop#agent-architecture#approval-workflow#personal-agent#agentic-ai#architecture#desktop-agents

Perguntas frequentes

O que é grok-bot-architecture?
Uma arquitetura de referência, sob licença MIT, para organizar equipes de agentes de IA com habilidades reutilizáveis por função, conectores MCP e etapas de aprovação humana. Este repositório apresenta uma referência independente de modelo e framework para estruturar uma equipe de agentes de IA. Um agente chief of staff transforma objetivos em tarefas com escopo definido e as encaminha a especialistas em áreas como engenharia, publicação, segurança, triagem de caixa de entrada e análise de oportunidades de carreira. Cada função é definida por uma receita reutilizável em SKILL.md e opera com permissões de ferramentas impostas pelo host, em vez de acesso irrestrito.
grok-bot-architecture é gratuito? Qual é a licença?
grok-bot-architecture é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
grok-bot-architecture ainda é mantido?
Manutenção ativa. O último commit de grok-bot-architecture foi em 29 de out. de 2026.
Para que posso usar grok-bot-architecture?
Projetar uma equipe de assistentes de IA persistentes, cada um responsável por um domínio distinto, como e-mail ou código Exigir aprovação humana antes que um agente envie mensagens, faça merge de código ou altere sistemas externos Adaptar permissões e encaminhamentos baseados em funções a um host de agentes existente Aprender padrões de limites de confiança para sistemas de agentes antes de escrever código de produção
Como instalar grok-bot-architecture?
Clone o repositório: git clone https://github.com/tiagovilasboas/grok-bot-architecture.git Acesse a pasta do projeto: cd grok-bot-architecture Execute a verificação local do ciclo de validação e aprovação: bash scripts/check.sh
Onde consigo grok-bot-architecture?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tiagovilasboas/grok-bot-architecture

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados