Ferramentas
Entenda onde consultar as ferramentas, como interpretar seus estados e quais acessos conferir antes de uma execução.
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.
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.
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, 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.