Ferramentas e permissões
O assistente escolhe sozinho qual ferramenta usar a partir da sua pergunta. Você não precisa saber o nome delas, mas conhecê-las ajuda a entender o que é possível.
Permissões
O MCP não tem permissões próprias: ele segue o Perfil do seu usuário no Sinfonia (veja Usuários). Se o seu Perfil não pode fazer algo na plataforma, o assistente também não pode. Na tela de autorização do login, as permissões que o seu Perfil não tem aparecem marcadas.
Ferramentas de leitura
Apenas consultam dados. Nada é alterado.
| Ferramenta | O que faz | Principais parâmetros | Perfil |
|---|---|---|---|
listar_bots | Lista os bots com versão release, versões disponíveis, linguagem, modo e agente padrão. | nome (parte do nome), limite | Todos |
listar_execucoes | Lista execuções iniciadas ou finalizadas, das mais recentes para as mais antigas. | status, bot, agente, desde, ate, limite | Todos |
listar_fila | Lista as execuções pendentes, na ordem em que vão rodar. | bot, agente, limite | Todos |
consultar_execucao | Detalha uma execução: status, horários, duração, erro e final do log. | id_execucao | Todos |
listar_agentes | Lista os agentes com status e uso de CPU, memória e disco. | status (online/offline), tipo (agente/docker_host) | Todos |
listar_agendamentos | Lista os gatilhos: agendamentos (cron), Watcher e Cloud. | bot, agente, tipo (cron/cloud/watcher) | Todos |
resumo_dashboard | Resumo de sucessos e erros por dia, com taxa de sucesso. | dias (1 a 90, padrão 7) | Admin e Dev |
consultar_logs_agente | Mostra o final do log de um agente. | agente | Admin e Dev |
Os filtros de status de execução aceitam: em_execucao, pausada, sucesso, erro, parada e erro_conexao. Os filtros de data (desde, ate) aceitam AAAA-MM-DD, hoje, ontem ou um número de dias como 7d.
Ferramentas de escrita
Alteram o estado da plataforma.
| Ferramenta | O que faz | Principais parâmetros |
|---|---|---|
executar_bot | Coloca uma execução real do bot na fila. | bot (obrigatório), versao (padrão: release), agente, parametros, label |
acao_execucao | Pausa, retoma ou para uma execução. | id_execucao, acao (pausar/retomar/parar) |
Atenção
As ferramentas de escrita só devem ser usadas quando você pede explicitamente, por exemplo “execute o bot X” ou “pare a execução 4512”. Perguntas como “teste se o bot está ok” são respondidas apenas com consultas. Mesmo assim, a maioria dos clientes pede a sua confirmação antes de chamar uma ferramenta de escrita: leia o pedido antes de aprovar.
Prompts prontos
Alguns clientes (como o Claude Code, com /) mostram prompts prontos do servidor. Eles usam somente ferramentas de leitura.
| Prompt | O que faz | Argumentos |
|---|---|---|
diagnosticar_falhas | Levanta as execuções com erro no período e explica as causas. | periodo (opcional: hoje, ontem, 7d ou AAAA-MM-DD; padrão hoje) |
resumir_operacao | Resume o estado atual: agentes, fila, execuções em andamento e falhas recentes. | — |
investigar_bot | Analisa um bot: versões, gatilhos e histórico recente de execuções. | bot (obrigatório) |
Segurança
- O assistente acessa somente a sua Conta, com o seu usuário.
- A sua senha e o código de verificação são digitados nas páginas do Sinfonia, nunca no cliente de IA.
- Os logs das execuções são tratados como dados: instruções escritas dentro de um log não são seguidas pelo assistente.
- Para revogar o acesso, remova o servidor do cliente. A sessão também expira sozinha em 24 horas.