Escola de Maestria

Boas-vindas ao Maestri

Este é o Maestri.

Ele é um aplicativo para orquestração de agentes de inteligência artificial.

Ele permite que você organize seus agentes e o contexto em volta deles de forma simples, tudo isso em um canvas infinito, te dando uma visão ampla sobre tudo o que está acontecendo e permitindo que você organize as coisas da maneira que fizer mais sentido para você.

Não tem jeito certo ou errado de usar, mas o objetivo deste vídeo é te dar os primeiros passos para que você comece a reger a sua própria orquestra.

Espaços de trabalho

Vamos começar pela interface. À esquerda, nesta barra lateral, ficam os espaços de trabalho. Pense nos espaços de trabalho como projetos separados. Considere o próprio Maestri: ele tem um site de marketing e um app para Mac, Windows e Linux. Cada uma dessas partes poderia ser um espaço de trabalho.

Vamos criar um espaço de trabalho para o site do Maestri. Além do nome, escolha um ícone e uma cor. Com muitos espaços de trabalho, isso vai te ajudar a localizá-lo rapidamente pela barra lateral.

E agora, algo importante: escolha uma pasta no seu computador. É nesse local que seus agentes serão iniciados e onde seu projeto será desenvolvido. Se você tem um repositório desse projeto, essa é a hora de selecioná-lo.

Seu primeiro agente

Agora, no nosso novo espaço de trabalho, vamos criar o primeiro agente. Mas antes, é importante entender que o Maestri não vem com agentes de inteligência artificial. Ele espera que você já os tenha instalados no seu terminal. Existem ótimas opções, como o Claude Code e o Codex, que funcionam com as assinaturas do Claude e do ChatGPT. Siga as instruções nos links da descrição para instalá-los.

Para criar nosso primeiro agente, olhe para a parte superior da interface. Essa é a barra de ferramentas. Vamos explorar cada ferramenta, mas, por agora, selecione a ferramenta Terminal. Para inserir um terminal no canvas, clique uma vez na região desejada, ou clique e arraste para desenhá-lo em um tamanho específico.

O Maestri vem com atalhos para os agentes mais populares. Então, para inserir um terminal do Claude, basta clicar no botão Claude Code. Note que isso preenche alguns campos do formulário. O campo Comando é o mais importante: é ele que chama o agente instalado. Nos Ajustes do Maestri, você pode modificar essa lista de atalhos e comandos. Você também pode definir um nome, e isso vai ser importante daqui a pouco.

Navegando pelo canvas

A vantagem do canvas é que você tem um espaço praticamente ilimitado para inserir elementos. Mas, para não se perder, vamos aprender alguns controles básicos. Para mover a câmera com um mouse, clique e segure o botão do meio, onde fica a rolagem, e arraste. Em um trackpad, arraste com dois dedos em qualquer direção.

Para mudar o zoom, use os controles no canto inferior direito. O gesto de pinça no trackpad, ou segurar Option enquanto rola o mouse, também funcionam muito bem. Ao lado dos controles de zoom fica um minimapa, que mostra onde você está no canvas.

Compositor de Prompts e Chat

O Maestri vem com algumas funcionalidades que melhoram a experiência de usar terminais. Com um terminal selecionado, aparece uma barra de ferramentas contextual com algumas opções. Este botão habilita o Compositor de Prompts: um campo de texto poderoso, que oferece uma experiência melhor para escrever prompts e incluir anexos para o seu agente.

Há também o Chat, que traz uma interface gráfica ao terminal, para uma experiência no estilo dos apps de mensagem.

Conectando agentes

O que torna o Maestri poderoso é permitir que os agentes se comuniquem e colaborem entre si. Para isso, selecione um terminal, clique no botão Conectar na barra contextual e, em seguida, clique no terminal ao qual você quer conectá-lo.

Um cabo surge no canvas, sinalizando a conexão entre eles. Na barra contextual, aparece uma etiqueta numerada com a lista de conexões e um botão para removê-las. Depois de conectados, digite arroba no Compositor de Prompts, e o outro agente aparece na lista de menções. Faça um teste: peça para um mandar uma mensagem para o outro.

Notas e Fichários

Outro aspecto importante do Maestri são as notas. Elas parecem post-its, mas, por baixo, são arquivos markdown de verdade, salvos no seu computador. Para criar uma, selecione a ferramenta Nota na barra de ferramentas e clique no canvas. Pela barra contextual, você alterna entre o modo Texto bruto, onde escreve o markdown, e o modo Formatado, que mostra títulos, tabelas, imagens e até diagramas.

O mais interessante é que você pode conectar uma nota a um agente, do mesmo jeito que conectamos os terminais. A partir daí, o agente consegue ler e escrever nela. Isso faz das notas um ótimo lugar para guardar o contexto do projeto: uma lista de tarefas, uma especificação, decisões que você não quer que se percam. E, se vários agentes estiverem conectados à mesma nota, todos trabalham a partir da mesma fonte.

Quando as notas começarem a se acumular, selecione duas ou mais, clique com o botão direito e escolha Colocar no Fichário. Elas viram páginas de uma pasta com abas, e, ao conectar o Fichário a um agente, ele acessa todas de uma vez.

Portais

Na barra de ferramentas também tem o Portal, um navegador que vive dentro do canvas. Aperte a tecla P, digite um endereço e pronto. Se você está rodando o projeto localmente, pode abrir o localhost aqui mesmo, ao lado dos seus agentes.

E, como tudo no Maestri, portais também podem ser conectados. Um agente conectado a um portal consegue navegar, clicar, digitar e tirar capturas de tela da página. Ou seja, ele consegue ver o resultado do que acabou de construir e corrigir sozinho, sem que você precise descrever o problema. E os portais não abrem só sites. Eles também rodam o simulador de iOS, no Mac, e emuladores ou celulares Android, e seus agentes controlam esses dispositivos do mesmo jeito: tocam, deslizam e testam o app que acabaram de compilar.

Responsabilidades

Com mais de um agente no canvas, faz sentido que cada um tenha uma função. É para isso que servem as responsabilidades: um conjunto de instruções que o agente recebe automaticamente quando inicia. Um pode ser o desenvolvedor, outro o revisor, outro o testador. Você cria e edita responsabilidades nos Ajustes, na seção Agentes, e pode atribuí-las na hora de criar o terminal ou depois, clicando com o botão direito nele.

Modo Maestro

E se, em vez de montar o time você mesmo, você pedisse para um agente montar? Esse é o Modo Maestro. Edite um terminal, marque a opção Maestro na aba Detalhes, e esse agente passa a poder criar novos agentes no canvas, dar responsabilidades a eles, conectá-los às notas certas e dispensar cada um quando o trabalho terminar.

Andares

Com vários agentes mexendo no mesmo projeto, uma hora eles vão acabar editando os mesmos arquivos ao mesmo tempo. Os andares resolvem isso. Lembra da pasta que escolhemos lá no começo? Se ela for um repositório git, cada andar ganha uma cópia própria dele, em uma branch só sua, com um canvas separado.

Para criar um andar, basta pedir ao seu agente Maestro. No Compositor de Prompts dele, digite arroba, escolha Novo andar e descreva a tarefa. O Maestri cria o andar, coloca um agente nele e o trabalho começa, sem atrapalhar o que já está em andamento. Quando o trabalho estiver pronto, você pousa o andar de volta no Térreo, com um merge local ou abrindo um pull request.

Próximos passos

Esses são os primeiros passos no Maestri. Ainda tem bastante coisa para explorar, como Rotinas e Partituras, e você encontra tudo na documentação, no link da descrição. Agora é com você. Boa regência.