Usage examples
Talk in natural language, the way you would ask a colleague. The examples below show common questions and the tools the assistant usually calls to answer them. The assistant also understands questions in Portuguese.
Query
| Question | Tools |
|---|---|
| Which bots do I have? | listar_bots |
| Which agents are offline? | listar_agentes |
| What is in the queue right now? | listar_fila |
| Which triggers does bot-rh have? | listar_agendamentos |
| How did the week go? What is the success rate? | resumo_dashboard |
Diagnose
| Question | Tools |
|---|---|
| What failed today? | listar_execucoes |
| Why did the last execution of bot-rh fail? | listar_execucoes → consultar_execucao |
| Why hasn’t my payroll bot started yet? | listar_fila → listar_agentes |
| Show me the log of machine AG-01. | consultar_logs_agente |
| Check whether bot-notas-fiscais is OK. | listar_execucoes (query only, does not run it) |
Tip
Chained questions work well: the assistant finds the last execution, opens its details and explains the error, all in the same answer.
Operate
| Question | Tools |
|---|---|
| Run bot-notas-fiscais on AG-01. | executar_bot |
Run bot-relatorio with parameter mes set to 10. | executar_bot |
| Pause execution 4512. | acao_execucao |
| Stop execution 4512. | acao_execucao |
Sample conversation
You: What failed yesterday?
Assistant: Yesterday there were 3 failed executions, all of
bot-notas-fiscaison agentAG-01. The cause was the same in all three:TimeoutErrorwhen accessing the city hall portal, after 120 seconds. The following executions, from 2 p.m. on, finished successfully.You: Run it again on AG-01.
Assistant: I queued execution 4530 of
bot-notas-fiscais(version 1.4.0) onAG-01.
What the MCP doesn’t do
The MCP is meant for everyday querying and operation. Requests like these are out of scope and should be done on the platform:
- Creating, editing or publishing bots and versions.
- Creating or changing triggers.
- Managing users, tokens, plugins and environment variables.