# Escolha ferramentas para a tarefa

Prepare uma decisão de uso com fontes, ações permitidas e critérios de revisão antes de executar o pedido.

Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/escolher/

**TL;DR** · Defina a entrega, identifique as fontes e separe consultar, criar e agir externamente. Depois confira as ferramentas visíveis na conversa. Este guia ajuda a preparar essa decisão; não orienta ativar todas as opções nem considera uma ação autorizada apenas porque ela está disponível.

![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.*

## Antes de começar

Tenha um resultado concreto, materiais autorizados e uma pessoa responsável pela revisão. Consulte o perfil ativo e os acessos disponíveis. Se você não sabe qual serviço está conectado ou onde uma ação terá efeito, deixe essa parte fora da execução até esclarecer.

O percurso **Mais ações → Ferramentas** fica disponível para consulta sem alterar os controles. Aqui, a saída é um plano de uso; nenhuma ferramenta precisa ser ligada para completar a preparação.

## Exemplo: preparar uma decisão, sem assumir compromissos

Considere o Estúdio Horizonte, empresa fictícia de treinamentos. A equipe precisa decidir se aceita uma oficina extra. Há 40 horas internas aprovadas na semana, 36 horas já comprometidas e uma demanda adicional de 10 horas. Um resumo comercial indica 8 horas livres, em conflito com os dados aprovados.

A entrega desejada é um pacote para revisão: análise, alternativas, pauta de reunião e plano em arquivo. Não é uma autorização para aceitar a oficina, contratar alguém, enviar e-mails ou agendar encontros.

Esse cenário retoma o guia [Primeira entrega](https://guides.adapta.org/guias/maestro/comece-aqui/primeira-entrega/), com criação e revisão de HTML e CSV. O exercício abaixo explicita a decisão de escopo, sem funcionar como uma segunda comparação entre configurações de ferramentas.

1. **Escreva o resultado e a origem dos dados**

    Descreva a entrega sem escolher a ferramenta primeiro: “Quero comparar alternativas e levar uma pauta conferível à reunião”. Em seguida, registre as fontes e a regra para conflitos.

    Neste caso, a capacidade aprovada prevalece sobre o resumo comercial. O saldo é 40 − 36 = 4 horas; a demanda extra de 10 horas gera déficit de 6. Uma pesquisa na web não resolve essa divergência interna. A origem do número comercial continua a confirmar.

    Se faltar um dado, formule uma pergunta em vez de ampliar a pesquisa automaticamente. Um valor de venda ausente, por exemplo, impede calcular a rentabilidade da oficina com esses insumos.

![Compositor do Maestro com o resultado esperado e a origem dos dados digitados: pauta conferível para a reunião, capacidade aprovada de 40 horas com 36 alocadas, resumo comercial pedindo 10 horas extras e a regra de que a capacidade aprovada prevalece.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/fe-1-2026-09-22.png)

    *Antes de escolher ferramenta: **1** o resultado em uma frase e **2** as fontes com a regra para conflito. A divergência interna (saldo 4, déficit 6) não se resolve com busca na web.*

2. **Relacione cada ação à entrega**

    Separe o trabalho em três categorias: consultar informações, criar materiais e realizar ações externas. Essa divisão é um critério de planejamento, não um menu do Maestro.

    Para a oficina, cálculos e arquivos de revisão fazem parte da entrega. Contatar clientes, contratar parceiro, instalar uma skill e configurar agendamentos ficam fora. Não há justificativa para conceder esses acessos apenas porque o catálogo os oferece.

    **Dica prática:** para cada ferramenta cogitada, complete a frase “preciso desta ação para produzir...”. Se você não consegue ligar a ação a uma parte da entrega, revise a necessidade antes de usá-la.

    **Para aprofundar:** AI Agents for Business, aula 8, “Modelos, Ferramentas & Frameworks”. A distinção entre modelo e ferramenta ajuda a escolher ações pelo problema, em vez de acumular recursos.

![Compositor do Maestro com as ações da entrega separadas em consultar informações, criar materiais e realizar ações externas, esta última vazia.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/fe-2-2026-09-22.png)

    *Três categorias, uma decisão: **1** consultar e criar fazem parte da entrega e **2** ações externas ficam de fora, com a lista do que não será feito.*

3. **Confira o menu sem presumir acesso**

    Na conversa, abra **Mais ações** e depois **Ferramentas**. Compare os nomes visíveis com as ações que você delimitou. Para consultar os grupos em uma página própria, use **Skills → Ferramentas** na lateral.

    O mesmo menu separa quatro coisas que não se substituem: **Adicionar arquivos ou fotos** traz material para a conversa, **Skills** traz procedimentos, **Ferramentas** traz ações que o agente pode tentar executar e **Conectores** traz acesso a serviços. Confundir os quatro é o erro que faz alguém ligar um acesso externo quando bastava anexar um arquivo.

    Em 19/09/2026, o submenu de Ferramentas listava busca na web, buscar página, shell, agendamentos, sub-agente em background, sub-agente síncrono, status de sub-agentes, visão, gerar imagem e editar imagem, cada um com interruptor próprio. A lista varia por conta e por versão; o método não.

![Menu de mais ações do compositor aberto, com Adicionar arquivos ou fotos, Skills, Ferramentas e Conectores, e o submenu de Ferramentas com dez opções, cada uma com seu interruptor ligado.](https://guides.adapta.org/media/screenshots/maestro/ferramentas-escolher-2026-09-19/ferramentas-menu-2026-09-19.png)

    *No menu: **1** anexar material, **2** Skills, Ferramentas e Conectores, três caminhos diferentes, **3** a lista de ferramentas desta conversa e **4** os interruptores, um por ação.*

    O controle informa um estado na interface, não uma garantia de acesso ao destino ou de execução correta. Não é necessário mudar opções para terminar este exercício. Se a tarefa depender de um acesso ainda desconhecido, registre a pendência antes de enviar o pedido.

4. **Registre os limites e o aceite**

    Defina o que será considerado uma entrega pronta.

    Antes de uma execução, você deve conseguir responder: quais dados entram, quais ações são permitidas, quais são proibidas e o que será conferido depois. Se o pedido exigir um efeito externo, especifique destino e condição de aprovação separadamente.

![Compositor do Maestro com os limites e o critério de aceite digitados: dados que entram, ações permitidas e proibidas, o que será conferido depois e a ausência de efeito externo nesta rodada.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/fe-3-2026-09-22.png)

    *O aceite escrito antes da execução: **1** entradas e ações permitidas e **2** o que será conferido, com os números esperados. Efeito externo, se houver, vira pedido separado.*

## Decisão de escopo para este caso

|  Ação cogitada |  Decisão e motivo |
| --- | --- |

|  Buscar dados na web |  Fora do escopo: as fontes numéricas são internas e já foram fornecidas. |

|  Conferir cálculos e produzir arquivos novos |  Faz parte da entrega, com execução de comando e escrita de arquivos; isso não autoriza comandos arbitrários nem alterações em arquivos existentes. |

|  Enviar mensagem ou arquivo a terceiros |  Fora do escopo: o pacote é para revisão, sem destinatário externo autorizado. |

|  Agendar rotina |  Fora do escopo: uma pauta de reunião não exige uma automação. |

|  Gerar imagens ou voz |  Fora do escopo: não é requisito do pacote executivo. |

|  Instalar skill ou delegar a subagentes |  Sem necessidade demonstrada neste exercício; não apresentar como requisito. |

## Um pedido para revisar o plano antes de agir

O texto abaixo é uma proposta de preparação, não uma execução validada. Ele não substitui permissões do ambiente e não promete que uma instrução textual impeça o uso de ferramentas.

````
Exercício fictício: Estúdio Horizonte.
Nesta mensagem, quero apenas um plano de trabalho em texto.
Não execute ferramentas, não crie arquivos, não pesquise,
não instale recursos, não agende e não envie nada a terceiros.

Precisamos preparar uma decisão sobre uma oficina extra.
Fonte A, aprovada: capacidade interna da equipe de 40 horas
na semana; trabalhos já assumidos de 12, 16 e 8 horas.
Fonte B, preliminar: o Comercial informa 8 horas livres.
A Fonte A prevalece. A oficina extra exige 10 horas.
Não há distribuição diária, disponibilidade individual,
valor de venda nem aprovação para contratar um parceiro.

Proponha o plano para produzir, numa etapa posterior,
um HTML de revisão e um CSV de ações propostas.
Separe: dados a consultar; cálculos a conferir; arquivos novos;
ações que exigiriam autorização adicional; informações ausentes.
Para cada ação, explique qual parte da entrega ela atende.
Não transforme uma alternativa em decisão aprovada.
Encerre com os critérios que eu devo conferir antes de executar.

````

## Confira a decisão antes de executar

- Os cálculos de referência são 36 horas comprometidas, 4 livres e déficit de 6.

- A diferença de 4 horas entre o resumo comercial e a fonte aprovada não ganhou causa inventada.

- Horas totais não foram tratadas como prova de disponibilidade individual ou diária.

- As ações externas continuam separadas da preparação do material.

- Cada ação permitida tem uma finalidade concreta e uma saída que pode ser conferida.

Se o plano depender de dados ou acessos ausentes, resolva a pendência ou reduza a entrega. Não troque a ferramenta esperando que ela preencha informações que você não forneceu.

Quer aplicar esse cuidado a outros trabalhos? Consulte os [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).