# Ferramentas Entenda onde consultar as ferramentas, como interpretar seus estados e quais acessos conferir antes de uma execução. Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/ **TL;DR** · Ferramentas permitem que o Maestro faça ações além de responder no chat. Consulte **Mais ações → Ferramentas** na conversa ou **Skills → Ferramentas** na lateral. ![Gravação do Maestro: o botão de mais ações do compositor abre um menu com Adicionar arquivos ou fotos, Skills, Ferramentas e Conectores; Ferramentas abre um submenu com busca na web, buscar página, shell, agendamentos, sub-agentes, visão e imagem, cada um com seu interruptor.](https://guides.adapta.org/media/screenshots/maestro/ferramentas-escolher-2026-09-19/maestro-ferramentas-menu.gif) *O menu do compositor separa quatro coisas diferentes. Ferramentas é a lista de ações que o agente pode tentar executar nesta conversa.* ## Quando consultar Abra esta referência quando uma tarefa envolver buscar informações, trabalhar com arquivos ou realizar uma ação. Antes de começar, separe o que você quer receber do que o Maestro pode fazer para chegar lá. Preparar uma mensagem é diferente de enviá-la. Criar um plano para a semana é diferente de agendar uma rotina. Essa distinção ajuda a definir um pedido que entregue o necessário sem assumir compromissos por você. ## Onde encontrar Na conversa, **Mais ações** reúne as entradas **Skills**, **Ferramentas** e **Conectores**, além de anexos. Abrir **Ferramentas** mostra uma lista com controles ligados ou desligados. ![Aba Ferramentas dentro de Skills, com os grupos Web (Busca na web, Buscar página), Sistema (Shell) e Automação (Agendamentos), cada opção com um interruptor.](https://guides.adapta.org/media/screenshots/maestro/ferramentas-2026-09-10/ferramentas-catalogo.png) Na lateral, **Skills** abre uma página com as abas **Skills** e **Ferramentas**. A aba de ferramentas organiza as opções por grupos. Consultar essa área não executa, por si só, a tarefa descrita pelo nome de uma ferramenta. O alcance e a persistência de uma alteração entre conversa, perfil e página não estão validados neste guia. Não assuma que mudar uma opção afeta somente o chat aberto ou todas as conversas. ## O que aparece no catálogo Use os nomes abaixo para reconhecer as opções. | Grupo | Opções observadas | Conferência necessária | | --- | --- | --- | | Web | Busca na web; Buscar página | Quais fontes podem ser consultadas e se a informação encontrada sustenta a resposta. | | Sistema | Shell | Quais comandos e arquivos entram no escopo. Não interpretar esse nome como acesso livre ao seu computador. | | Automação | Agendamentos | O que será executado, quando e com quais efeitos. Uma pauta escrita não é um agendamento. | | Sub-agentes | Sub-agente em background; Sub-agente síncrono; Status de sub-agentes | Qual parte do trabalho será delegada e como a entrega será conferida. Não confundir com trocar de assistente. | | Visão | Visão; Gerar imagem; Editar imagem | Qual imagem pode ser usada e qual resultado será avaliado. Reconhecer, gerar e editar são tarefas diferentes. | | Mensageria | Enviar mensagem; Enviar arquivo; Voz (TTS) | Destino, conteúdo, canal e autorização. TTS significa transformar texto em voz. | | Skills | Buscar skills; Instalar skill | Origem, finalidade e acessos do recurso. Encontrar uma skill não autoriza sua instalação. | As opções podem depender do ambiente e do perfil. Este catálogo não estabelece limites de formato, tamanho, duração ou quantidade. Esses limites precisam ser confirmados no fluxo específico. ### Diferenças que ajudam a escolher A interface descreve **Busca na web** como pesquisa na internet e **Buscar página** como leitura do conteúdo de uma URL. A primeira parte de uma pergunta de pesquisa; a segunda, de um endereço conhecido. Nenhuma delas dispensa conferir a fonte obtida. **Shell** é descrito como execução de comandos no espaço de trabalho do agente. Isso não significa acesso irrestrito ao seu computador. O exemplo de Primeira entrega usa um comando de conferência; outros comandos, acessos e efeitos precisam de validação própria. Nos subagentes, a descrição distingue **em background**, cujo resultado chega depois, de **síncrono**, que aguarda o resultado da subtarefa na mesma resposta. **Status de sub-agentes** consulta o progresso dos que trabalham em background. Esses são comportamentos descritos no catálogo; delegar uma tarefa de verdade ainda exige sua própria verificação. As descrições de **Gerar imagem** e **Editar imagem** informam consumo de créditos. **Voz (TTS)** indica exigência de configuração de voz. Confira as condições do seu ambiente antes de usar; este guia não estabelece valores nem comprova que a configuração necessária já esteja pronta. ## Não confunda quatro estados **Visível:** você encontrou a ferramenta na interface. Isso confirma a presença do controle naquele ambiente. **Ligada:** o controle está ativo na superfície consultada. Ainda é preciso conferir acessos, contexto e autorização para a tarefa. **Executada:** o histórico registra uma ação. Leia o resultado, não apenas o nome ou o indicador de conclusão. **Conferida:** você abriu a saída e verificou os critérios do pedido. Essa é a etapa que permite decidir se o material serve ao trabalho. No exercício da [primeira entrega](https://guides.adapta.org/guias/maestro/comece-aqui/primeira-entrega/), o Maestro cria e revisa arquivos com dados fictícios: a conversa mostra escrita de arquivos e execução de comando, o HTML abre e é baixado, o CSV é visualizado. ## Acessos e limites antes da ação - Use apenas materiais que você tem autorização para fornecer. - Confira perfil e conexões. Uma ferramenta visível não significa que seu e-mail, agenda ou outro serviço está conectado. - Especifique o que pode ser consultado, criado ou alterado. Separe arquivos novos de materiais existentes que devem ser preservados. - Defina quais ações exigem sua revisão. Escrever “não envie” no pedido ajuda a delimitar a tarefa, mas não substitui os controles de acesso. - Se o efeito de uma opção não estiver claro, não amplie permissões para tentar resolver. Delimite a tarefa e consulte o responsável pelo ambiente. **Dica prática:** escolha pelo trabalho necessário, não pela quantidade de ferramentas. Se os dados aprovados já estão no pedido, uma pesquisa externa pode introduzir uma segunda fonte que você não pediu. **Para aprofundar:** AI Agents for Business, aula 8, “Modelos, Ferramentas & Frameworks”. A aula diferencia a escolha do modelo das ações que as ferramentas permitem realizar. Use essa distinção para separar “qual resposta preciso?” de “quais ações autorizo?”. Para ver aplicações com entrada, resultado e critérios de revisão, consulte os [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).