# Equipe de professores baseada em IA: gerando um curso completo a partir de um único prompt > Guia completo para geração de cursos interativos no OpenMAIC: salas de aula multiagente, simulações digitais, exportação para PPTX/HTML e automação via Codex. A criação de um curso completo tradicionalmente exige o trabalho coordenado de uma equipe de especialistas: um metodólogo para estruturar o programa, um copywriter para os textos, um designer para os slides, um desenvolvedor para exercícios interativos e um instrutor para a entrega do conteúdo. A plataforma **OpenMAIC (Open Multi-Agent Interactive Classroom)** unifica todo esse ciclo de produção em um único sistema multiagente. Basta formular um tópico base ou fazer upload de materiais existentes (documentos, apresentações, vídeos), e a equipe de agentes de IA projetará autonomamente o roteiro pedagógico, sintetizará aulas multimídia, configurará testes avaliativos e criará simulações interativas diretamente no navegador. --- ## 1. O que é OpenMAIC: conceito e principais recursos OpenMAIC é uma plataforma aberta para geração e condução de sessões de aprendizado interativas, utilizando a sinergia de agentes autônomos de inteligência artificial. ### 1.1. Diferença em relação aos geradores clássicos de apresentações Diferentemente dos serviços que apenas criam slides estáticos ou longas transcrições textuais, o OpenMAIC gera uma sala de aula digital completa: - **Ambiente multiagente:** o processo de aprendizagem é conduzido por várias personas de IA (instrutor, assistente, colegas virtuais). - **Narração vocal sincronizada:** algoritmos TTS integrados comentam os slides, destacando fórmulas e gráficos importantes com um ponteiro virtual. - **Interação dialógica:** o usuário pode pausar a aula a qualquer momento, fazer perguntas por voz ou texto e participar da discussão. - **Execução de código e simulações:** módulos práticos funcionam diretamente na interface, sem necessidade de instalar softwares de terceiros. ### 1.2. Modos arquitetônicos disponíveis para criação de cursos O sistema oferece duas abordagens de trabalho, dependendo das suas necessidades: 1. **Classic Mode (Geração Rápida):** criação automática do curso em 1–3 minutos, baseada em um único prompt ou pacote de arquivos. 2. **Agent Workbench (Pro Mode):** projeto iterativo em diálogo com um agente metodólogo, onde cada cena, teste ou ilustração pode ser refinada através de comandos precisos. --- ## 2. Arquitetura de dois estágios para geração de cursos a partir de um prompt O OpenMAIC utiliza um pipeline de processamento de requisições em dois estágios, garantindo a integridade da intenção pedagógica. ### 2.1. Estágio 1: Formação da estrutura e plano pedagógico Inicialmente, a rede neural analisa o tópico ou os arquivos primários, decompondo o domínio temático em módulos lógicos segundo o princípio "do simples ao complexo". Exemplo de prompt inicial: ```text Crie um curso introdutório de educação financeira para iniciantes. Requisitos: 5 aulas, desde os termos básicos até a elaboração do orçamento familiar. Inclua testes de verificação e exercícios práticos em cada módulo. ``` No primeiro estágio, o sistema formula um roadmap: 1. Fundamentos de finanças pessoais e mentalidade monetária. 2. Controle de receitas, despesas e vazamentos ocultos de capital. 3. Construção de um orçamento mensal pessoal. 4. Formação de reserva de emergência e proteção de economias. 5. Laboratório interativo final com stress-testing do orçamento. ### 2.2. Estágio 2: Síntese de cenas de aprendizado e conteúdo interativo Após a aprovação do plano, o sistema inicia agentes paralelos para cada cena. Um módulo não se limita a texto simples — ele é decomposto em frames de aula, blocos de perguntas, scripts de programação e exercícios práticos. --- ## 3. Formatos modulares de conteúdo educacional O OpenMAIC suporta uma rica paleta de formatos, combinados em uma trilha de aprendizado sequencial coesa. ### 3.1. Slides multimídia e narração vocal Os slides de aula incluem texto marcado, tipografia, diagramas vetoriais, fórmulas matemáticas em LaTeX e ilustrações. O instrutor de IA acompanha a apresentação com fala viva, destacando blocos relevantes com um marcador em tempo real. ### 3.2. Testes adaptativos e verificação automática de conhecimento Para controlar a assimilação do material, há mecanismos de teste embutidos: - Questões de múltipla escolha com uma única resposta correta; - Tarefas com seleção múltipla de opções; - Perguntas abertas com verificação de correspondência semântica via LLM. ### 3.3. Cenas HTML interativas e simulações digitais Em vez de leitura passiva, o aluno interage com mini-aplicações em HTML5/JavaScript: gráficos dinâmicos, modelos físicos e simuladores de decisões de negócios. ### 3.4. Aprendizado baseado em projetos (Project-Based Learning) No modo PBL, o estudante assume o papel de especialista (por exemplo, CFO de uma startup ou data analyst) e resolve passo a passo um problema aplicado complexo junto com colegas artificiais. Roteiro típico de passagem pela lição no OpenMAIC: ```mermaid flowchart TD Intro["1. Теоретичний вступ"] --> Slides["2. Мультимедійні слайди з ШІ-голосом"] Slides --> Quiz["3. Контрольний квіз / Тест"] Quiz --> Sim["4. Інтерактивна симуляція / HTML-практика"] Sim --> Debate["5. Групове обговорення з ШІ-студентами"] Debate --> Project["6. Підсумковий практичний проєкт"] ``` --- ## 4. Interação multiagente: equipe de instrutores de IA e colegas A principal vantagem da plataforma é a simulação de um ambiente social vivo dentro da sala de aula virtual. ### 4.1. Formatos de papéis dos agentes na sala de aula virtual Vários agentes autônomos com diferentes temperamentos e níveis de conhecimento participam da sessão: | Papel do Agente | Funcionalidade na Sala | Padrão Comportamental | | :--- | :--- | :--- | | **Instrutor Principal (Primary Instructor)** | Explicação do tópico, narração dos slides | Ensina de forma estruturada, adapta o ritmo da fala | | **Colegas de IA (AI Peers / Classmates)** | Participação em debates, modelagem de erros comuns | Fazem perguntas orientadoras, facilitam a compreensão para iniciantes | | **Oponente Especialista (Debate Opponent)** | Geração de pontos de vista alternativos | Propõe contraargumentos críticos para a discussão | | **Assistente Tutor (Teaching Assistant)** | Suporte nos blocos práticos | Fornece dicas personalizadas e depura código | Os formatos de sessão incluem **Classroom Discussion** (conversa livre do grupo), **Roundtable Debate** (discussão entre especialistas sobre um problema controverso) e **Q&A Mode** (consultas individuais durante as pausas). ### 4.2. Quadro branco interativo compartilhado (Whiteboard) Os agentes têm acesso a um quadro branco interativo compartilhado: podem desenhar diagramas de relacionamentos, escrever equações matemáticas complexas ou criar fluxogramas diretamente durante a aula, ilustrando visualmente as teses de sua narrativa. --- ## 5. Modo de Interatividade Profunda (Deep Interactive Mode) Para disciplinas técnicas e científicas complexas, foi desenvolvido um modo especial chamado Deep Interactive Mode. ### 5.1. 5 tipos de conteúdo interativo aplicado O modo ativa a geração de cinco categorias de objetos aplicados: 1. **Visualizações 3D:** exploração de modelos espaciais, compostos moleculares e nós de engenharia. 2. **Simulações físicas e econômicas:** alteração de variáveis de entrada via sliders com recálculo instantâneo do resultado. 3. **Mini-jogos educacionais:** mecânicas gamificadas para fixar regras ou fórmulas estudadas. 4. **Mapas Mentais (Mind Maps):** visualização de conexões entre conceitos para estruturar a memória. 5. **Sandbox de código embutido:** execução e debugging de Python, JavaScript ou SQL diretamente no navegador. ### 5.2. Adaptabilidade e suporte a dispositivos Todas as cenas interativas geradas são automaticamente adaptadas para controle por tela sensível ao toque em tablets e smartphones, ou mouse e teclado em desktops. --- ## 6. Geração de cursos baseados em materiais próprios O OpenMAIC pode trabalhar não apenas com prompts textuais abstratos, mas também transformar bases de conhecimento corporativas em cursos envolventes. ### 6.1. Formatos suportados: documentos, áudio e vídeo A plataforma aceita uma ampla lista de arquivos de entrada: - Documentos: `PDF`, `DOCX`, `TXT`, `Markdown`. - Dados tabulares: `XLSX`, `CSV`. - Apresentações: `PPTX`. - Multimídia: gravações de áudio de aulas (`MP3`, `WAV`) e arquivos de vídeo (`MP4`). Para materiais de vídeo e áudio, o sistema realiza transcrição automática da fala e extração de quadros visuais-chave. ### 6.2. Trabalho com texto extraído no Agent Workbench Na interface Workbench, os dados extraídos dos documentos são armazenados como um índice semântico. O agente pode referenciar citações exatas do manual, extrair esquemas originais e formar links para páginas da fonte primária. --- ## 7. Comparação dos modos de operação: Classic Mode vs. Agent Workbench A escolha do modo depende dos requisitos de profundidade de tratamento e velocidade de criação dos materiais: | Critério | Classic Mode (Rápido) | Agent Workbench (Pro Mode) | | :--- | :--- | :--- | | **Velocidade de geração** | 1–3 minutos (piloto automático total) | Passo a passo em modo de diálogo ao vivo | | **Profundidade de customização** | Configurações básicas de tópicos e níveis | Alteração completa de cada cena, texto e narração | | **Suporte a Skills** | Pipeline universal automático | 20 Skills especializadas (Research, Code, Slides) | | **Importação de mídia e PPTX** | Arquivos estáticos padrão | Busca interativa, reordenação e redesenho | | **Salvamento de sessões** | Resultado único de exportação | Sessões persistentes no servidor com histórico de edições | ### 7.1. Pipeline automático rápido (Classic Mode) Ideal para criar aulas introdutórias ou testar hipóteses rapidamente: o usuário fornece um prompt ou faz upload de um guia metodológico, e o sistema imediatamente cria uma sala pronta para uso. ### 7.2. Ambiente dialógico com 20 skills (Agent Workbench / Pro Mode) No Pro Mode, o usuário interage com o agente como se fosse um produtor profissional de programas educacionais: ```text Adicione uma aula prática adicional antes do teste final. Simplifique a formulação da Lei de Ohm no terceiro capítulo. Substitua o slide estático por um diagrama interativo de circuito elétrico. ``` --- ## 8. Opções de implantação e execução da plataforma O OpenMAIC pode ser executado tanto em ambiente cloud quanto totalmente em infraestrutura local. ### 8.1. Uso em nuvem (Hosted Mode) A opção mais simples, que não requer recursos de servidor: o usuário recebe um Access Code pessoal no serviço oficial e o conecta na aplicação cliente. ### 8.2. Implantação local em seu próprio servidor (Self-Hosted) Para controle total sobre a privacidade dos dados, a plataforma pode ser implantada em seu próprio servidor. Requisitos de sistema: - **Node.js:** versão 22.19 ou superior; - **Gerenciador de pacotes:** `pnpm` 10+; - Chave API de pelo menos um provedor de IA suportado. Passos de instalação: ```bash # Клонування репозиторію та перехід у каталог проєкту git clone https://github.com/THU-MAIC/OpenMAIC.git cd OpenMAIC # Встановлення залежностей pnpm install # Налаштування конфігурації оточення cp .env.example .env.local ``` Abra o arquivo `.env.local` e adicione uma chave API válida: ```bash OPENAI_API_KEY="sk-proj-your-secret-key" ``` Inicie o servidor de desenvolvimento: ```bash pnpm dev ``` Após o início bem-sucedido, a interface web do OpenMAIC estará disponível no endereço local `http://localhost:3000`. --- ## 9. Integração do OpenMAIC via Codex, OpenClaw e agentes autônomos O OpenMAIC suporta o padrão aberto **SKILL.md**, permitindo gerenciar o processo de criação de cursos diretamente através de agentes de IA do desenvolvedor. ### 9.1. Uso do padrão SKILL.md no Codex e DeepSeek Para trabalhar no ambiente Codex, basta importar a pasta `skills/openmaic/` do repositório da plataforma. O agente aprenderá automaticamente a orquestrar o OpenMAIC, implantar o servidor local e gerar aulas com comandos curtos no chat: ```text Teach me quantum physics in an interactive OpenMAIC classroom ``` ### 9.2. Implantação em mensageiros via OpenClaw (Slack, Discord, Telegram) No ecossistema OpenClaw, a skill é instalada com um único comando terminal: ```bash clawhub install openmaic ``` Isso permite criar cursos educacionais, gerar interativos e compartilhar links prontos diretamente nos chats de trabalho do Slack, Discord ou Telegram. --- ## 10. Modelos suportados e distribuição de carga O OpenMAIC garante total liberdade de escolha de modelos e provedores de IA, suportando tanto APIs fechadas quanto pesos abertos locais. ### 10.1. Seleção de LLMs ótimas para geração de conteúdo | Tarefa no OpenMAIC | Modelo Recomendado | Vantagens e Características | | :--- | :--- | :--- | | **Planejamento e design pedagógico** | Gemini 2.5 Pro / Claude 3.7 Sonnet | Alto nível de estruturação lógica de temas complexos | | **Geração rápida de slides** | Gemini 2.0 Flash / GPT-4o-mini | Máxima velocidade de resposta com custo mínimo de API | | **Simulações interativas e código** | Claude 3.7 Sonnet / DeepSeek-V3 | Alta precisão de sintaxe HTML5/JavaScript | | **Síntese de fala (TTS)** | ElevenLabs / OpenAI TTS / Lemonade | Entonações naturais e alta expressividade do instrutor | ### 10.2. Arquitetura multimodelo: especialização por serviços A plataforma permite utilizar simultaneamente diferentes provedores: a base textual pode ser formada pelo DeepSeek ou Qwen, a geração de ilustrações realizada pelo FLUX ou DALL-E 3, a narração pelo ElevenLabs, e a busca de fatos atualizados pelo Perplexity ou Tavily API. --- ## 11. Exportação e integração do curso pronto Os materiais criados não ficam confinados dentro do serviço web — o OpenMAIC suporta quatro métodos universais de exportação. ### 11.1. PowerPoint editável (.pptx) Os slides são exportados para um arquivo de apresentação completo, preservando formas geométricas vetoriais, blocos de texto, fórmulas e imagens para posterior edição manual. ### 11.2. Páginas interativas autônomas (Interactive HTML) Simulações computacionais complexas e modelos 3D são salvos como documentos web independentes, que podem ser abertos em qualquer navegador moderno sem acesso à internet. ### 11.3. Arquivo completo do curso (Classroom ZIP) O pacote contém a estrutura das aulas, arquivos multimídia, transcrições textuais e módulos interativos. Esse arquivo pode ser transferido para outro instrutor ou carregado em outro servidor OpenMAIC. ### 11.4. Exportação de vídeo educacional (MP4) Para criar videoaulas, é utilizado um serviço de renderização em background baseado em Chromium e FFmpeg, que grava os slides, faixas de áudio e movimento do ponteiro virtual em alta resolução. --- ## 12. Workflow prático passo a passo: criando um curso do zero Vamos analisar o algoritmo prático de geração de um minicurso corporativo. ### 12.1. Passo 1. Formulação do prompt alvo Formule uma solicitação detalhada especificando o papel, a audiência e o resultado desejado: ```text [Papel]: Atue como um treinador corporativo sênior em produtividade. [Tarefa]: Crie um curso prático “Fundamentos do ChatGPT para Gerentes de Projetos”. [Público-alvo]: Líderes de equipe sem formação técnica prévia em IA. [Escopo]: 5 módulos concisos, desde a construção de prompts até a otimização de relatórios. [Formato]: Slides multimídia, um bloco de teste ao final de cada seção e 1 simulação interativa. ``` ### 12.2. Passo 2. Validação e ajuste da estrutura Revise o plano gerado pelo agente. Se alguns tópicos estiverem ausentes, adicione um comando de correção: ```text Adicione uma lição sobre verificação de fatos das respostas da IA e detecção de alucinações entre os módulos 2 e 3. ``` ### 12.3. Passo 3. Integração de materiais primários Faça upload de documentos internos, instruções normativas ou apresentações da sua empresa e especifique a diretiva: ```text Use the uploaded company regulations as a basis for practical case studies in the course. ``` ### 12.4. Passo 4. Refinamento dialógico via agente Insira edições pontuais nas cenas de aprendizado usando o Workbench: - “Torne a explicação na quarta aula mais concisa.” - “Substitua a lista textual por uma tabela comparativa com conclusões.” - “Adicione um exercício prático de cálculo de rentabilidade do projeto.” ### 12.5. Passo 5. Realização do treinamento e exportação final Teste o curso pronto no modo de sala de aula virtual: escute a trilha sonora, responda às questões de controle e baixe o `.pptx` final ou o `Classroom ZIP` para distribuição entre colegas. --- ## 13. Perguntas frequentes e recomendações (FAQ) ### 13.1. Respostas práticas para dúvidas comuns sobre o OpenMAIC > [!NOTE] > **É necessária uma placa de vídeo discreta potente para executar o OpenMAIC localmente?** > Não, desde que sejam utilizadas APIs em nuvem (OpenAI, Gemini, Anthropic) para geração de texto e imagens, o servidor local do OpenMAIC requer apenas um ambiente Node.js padrão e consome o mínimo de memória RAM (até 512 MB). > [!TIP] > **Como minimizar custos de tokens ao projetar grandes programas educacionais?** > Utilize um esquema de dois níveis: para o planejamento inicial e estruturação do curso, conecte um modelo flagship de alta inteligência (Gemini 2.5 Pro ou Claude 3.7 Sonnet), enquanto a geração de slides individuais e textos auxiliares deve ser delegada a modelos rápidos e econômicos como Gemini 2.0 Flash ou GPT-4o-mini. > [!IMPORTANT] > **Quais restrições existem para o tamanho dos materiais de vídeo educacional enviados?** > Ao analisar gravações de vídeo longas, recomenda-se previamente dividir as aulas em fragmentos temáticos de até 20–30 minutos. Isso evita o estouro da janela de contexto dos modelos de linguagem e aumenta significativamente a precisão da citação de fatos. > [!WARNING] > **Requisitos de recursos para exportação do curso em vídeo MP4** > Diferentemente da exportação leve para PowerPoint ou HTML, a geração de um arquivo de vídeo completo requer a implantação de um render-service em background com suporte a aceleração de hardware via Chromium e FFmpeg. Em VPS sem núcleos dedicados, a renderização de vídeo pode levar muito tempo.