Repolode
Enviar
tiagovilasboas

tiagovilasboas/grok-bot-architecture

Arquitectura de referencia con licencia MIT para organizar equipos de agentes de IA con habilidades de rol reutilizables, conectores MCP y controles de aprobación humana.

Ver en GitHub
Estrellas
49
Forks
11
Issues abiertos
0
Último commit
hace 10 días

¿Qué es?

Este repositorio ofrece una arquitectura de referencia independiente del modelo y del framework para estructurar un equipo de agentes de IA. Un agente de jefe de gabinete convierte los objetivos en tareas bien delimitadas y las asigna a especialistas en áreas como ingeniería, publicación, seguridad, clasificación de la bandeja de entrada y selección de candidatos. Cada rol se define mediante una receta reutilizable en SKILL.md y opera con permisos de herramientas aplicados por el host, en lugar de contar con acceso implícito.

La idea central es que haya una persona en el circuito de aprobación. Las acciones privilegiadas generan una solicitud que queda pendiente hasta recibir una decisión autenticada, vinculada a la acción y revisión exactas; si se agota el tiempo de espera, el sistema espera en lugar de continuar. Los registros tipados de traspaso y un tablero Markdown permiten compartir tareas y evidencia entre roles. El repositorio también incluye validadores JSON, herramientas para el tablero y un ejemplo local acotado del ciclo de aprobación.

El proyecto también documenta cómo adaptar este patrón a Grok Bot, con pasos de configuración, orientación sobre políticas de aprobación y un tutorial. No contiene el código fuente del producto Grok Bot ni está afiliado a xAI.

Funciones clave

  • 01Agente de jefe de gabinete que delimita, asigna y revisa el trabajo de los roles especializados
  • 02Nueve habilidades de rol reutilizables, definidas como recetas SKILL.md
  • 03Controles de aprobación que vinculan cada decisión a una revisión exacta de la acción y esperan si se agota el tiempo de espera
  • 04Registros tipados de traspaso y un tablero Markdown para compartir el estado y la evidencia
  • 05Validadores JSON y un ejemplo local del ciclo de aprobación sin dependencias externas

Casos de uso

  • Diseñar un equipo de asistentes de IA persistentes, cada uno encargado de un área distinta, como el correo electrónico o el código
  • Solicitar aprobación humana antes de que un agente envíe mensajes, integre código o modifique sistemas externos
  • Adaptar permisos basados en roles y traspasos a un host de agentes existente
  • Aprender patrones para definir límites de confianza en sistemas de agentes antes de escribir código de producción

Inicio rápido

  1. 1

    Clona el repositorio

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

    Entra en la carpeta del proyecto

    cd grok-bot-architecture
  3. 3

    Ejecuta la comprobación local del ciclo de validación y aprobación

    bash scripts/check.sh

Antes de usarlo

  • Se trata de una arquitectura de referencia y un patrón de documentación, no de un sistema de agentes en tiempo de ejecución independiente.
  • La configuración de Grok Bot depende de un producto Grok Bot independiente cuyo código fuente no está incluido.
  • Los validadores solo comprueban la estructura de los archivos; no autentican a los aprobadores humanos ni ejecutan efectos secundarios.

En colecciones

Frameworks de orquestación multiagenteFrameworks y apps de agentes de IA open sourceServidores MCPAgentes personales de IA open source

Temas

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

Preguntas frecuentes

¿Qué es grok-bot-architecture?
Arquitectura de referencia con licencia MIT para organizar equipos de agentes de IA con habilidades de rol reutilizables, conectores MCP y controles de aprobación humana. Este repositorio ofrece una arquitectura de referencia independiente del modelo y del framework para estructurar un equipo de agentes de IA. Un agente de jefe de gabinete convierte los objetivos en tareas bien delimitadas y las asigna a especialistas en áreas como ingeniería, publicación, seguridad, clasificación de la bandeja de entrada y selección de candidatos. Cada rol se define mediante una receta reutilizable en SKILL.md y opera con permisos de herramientas aplicados por el host, en lugar de contar con acceso implícito.
¿grok-bot-architecture es gratuito? ¿Qué licencia tiene?
grok-bot-architecture es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿grok-bot-architecture sigue mantenido?
Mantenimiento activo. El último commit de grok-bot-architecture fue el 29 oct 2026.
¿Para qué puedo usar grok-bot-architecture?
Diseñar un equipo de asistentes de IA persistentes, cada uno encargado de un área distinta, como el correo electrónico o el código Solicitar aprobación humana antes de que un agente envíe mensajes, integre código o modifique sistemas externos Adaptar permisos basados en roles y traspasos a un host de agentes existente Aprender patrones para definir límites de confianza en sistemas de agentes antes de escribir código de producción
¿Cómo se instala grok-bot-architecture?
Clona el repositorio: git clone https://github.com/tiagovilasboas/grok-bot-architecture.git Entra en la carpeta del proyecto: cd grok-bot-architecture Ejecuta la comprobación local del ciclo de validación y aprobación: bash scripts/check.sh
¿Dónde consigo grok-bot-architecture?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tiagovilasboas/grok-bot-architecture

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados