Execuções do agente de IA
Toda vez que um agente de IA é executado, a partir de um nó Agente de IA ou pela API, o MonoChat registra a execução: qual harness e quais modelos ele usou, o que foi solicitado, cada chamada de modelo e de ferramenta feita, quanto do orçamento foi consumido e como a execução terminou.
Você encontra as execuções em Configurações › Automação › Execuções do agente de IA. O item de menu é exibido para usuários com a permissão Ler execuções de agentes de IA na automação.
A tabela de execuções
| Coluna | O que mostra |
|---|---|
| Harness de IA | O harness que executou o agente. Passe o cursor para ver o tipo do harness. |
| Status | Na fila, Em execução, Concluído, Falhou, Orçamento excedido, Tempo esgotado ou Cancelada. Passe o cursor sobre uma execução com falha para ver o erro. |
| Chamadas ao modelo | Chamadas ao modelo usadas / Máx. de chamadas ao modelo do orçamento. |
| Chamadas de ferramentas | Chamadas de ferramentas usadas / Máx. de chamadas de ferramentas do orçamento. |
| Tokens | Total de tokens. Passe o cursor para ver os tokens de entrada e de saída e, quando o provedor informa, as leituras e gravações de cache. |
| Duração | Quanto tempo a execução levou. |
| Criado em | Quando a execução foi iniciada. |
Cada linha tem três botões:
- Copiar ID copia o ID da execução, por exemplo para consultá-la com
aiAgentRuns.showou enviá-la ao suporte. - Chat abre a conversa em que a execução trabalhou. Ele só aparece para execuções que pertencem a uma conversa.
- Mostrar abre os detalhes da execução.
Use os filtros para refinar a lista por Harnesses de IA, Status e Criado em (intervalo de datas). A tabela não é atualizada sozinha; use o botão de atualizar no cabeçalho para carregar novas execuções e mudanças de status.
Detalhes da execução
Mostrar abre o painel Execução do agente de IA.
Resumo
| Linha | O que mostra |
|---|---|
| ID | O ID da execução, com um botão de copiar. |
| Harness de IA | O nome e o tipo do harness. |
| Status | Como a execução terminou, ou se ainda está na fila ou em execução. |
| Erro | A mensagem de erro, para execuções que não foram concluídas. |
| Modelo principal, Modelo alternativo (após o limite flexível), Modelo rápido (tarefas leves em segundo plano) | Os modelos de IA definidos no nó, para harnesses que usam modelos de IA. |
| Modelo (um dos modelos permitidos do harness) | O modelo, para um harness hospedado. |
| Criado em, Iniciado em, Concluído em | Quando a execução foi colocada na fila, iniciada e encerrada. |
| Duração | Tempo usado / Duração máx. (segundos). |
| Chamadas ao modelo | Chamadas usadas / máximo, com o limite flexível quando houver. |
| Chamadas de ferramentas | Chamadas usadas / máximo. |
| Tokens | Tokens de entrada e de saída (e de cache) e total / Máx. total de tokens. |
Etapas
Etapas lista o que o agente fez, em ordem, com o tempo desde o início da execução à direita:
| Etapa | O que mostra |
|---|---|
| Chamada ao modelo n | O modelo, os tokens de entrada e de saída e as ferramentas que o modelo solicitou (Ferramentas solicitadas: …) ou Resposta final. |
| Chamada de ferramenta | O nome da ferramenta e quanto tempo ela levou. |
| Alternou para o modelo de fallback | A execução atingiu o limite flexível e continuou com o modelo alternativo. |
| Mensagem intermediária | Uma mensagem que o agente escreveu durante o trabalho, conforme foi enviada ao cliente ou adicionada como sussurro. |
| Tentar novamente | Uma chamada de modelo com falha que foi repetida, com o respectivo erro. |
Se o harness não informar etapas, o painel exibe "Nenhuma etapa foi registrada para esta execução."
Instruções, Entrada, Resultado e Dados JSON
- Instruções: as instruções do nó como o agente as recebeu.
- Entrada: a tarefa, com as tags já preenchidas.
- Resultado: a resposta final do agente.
- Dados JSON: o registro completo da execução. Use o botão de copiar para compartilhá-lo com seu desenvolvedor ou com o suporte do MonoChat.
Depurando um agente
| O que você vê | O que verificar |
|---|---|
| Orçamento excedido com Chamadas ao modelo no máximo | Veja as etapas. Se o agente continua chamando ferramentas sem chegar a uma conclusão, torne as instruções e as descrições das ferramentas mais precisas. Se a tarefa realmente exige mais etapas, aumente Máx. de chamadas ao modelo. |
| Orçamento excedido com Tokens no máximo | Um histórico de conversa longo ou resultados grandes das ferramentas esgotam o orçamento de tokens. Reduza Limite do histórico de mensagens, retorne menos dados nas suas ferramentas ou aumente Máx. total de tokens. |
| Orçamento excedido com Chamadas de ferramentas no máximo | O agente pediu mais ferramentas do que o permitido. Aumente Máx. de chamadas de ferramentas ou diga nas instruções qual ferramenta usar e quando. |
| Tempo esgotado | Verifique a duração das chamadas de ferramentas em Etapas. Uma API ou um servidor MCP lento consome a Duração máx. (segundos). |
| Falhou com "Um escopo de IA ou ferramenta MCP não foi encontrado neste workspace." | Um escopo ou uma ferramenta MCP do nó foi excluído. Atualize as Configurações das ferramentas do nó. |
| Falhou com "Escolha um dos modelos permitidos do harness de IA." | O modelo do nó foi removido dos Modelos permitidos do harness hospedado. |
| Falhou com "Este harness não está disponível neste servidor." | O harness precisa do executor de agentes do MonoChat, que não está disponível. Escolha outro harness. |
| O cliente não recebeu a resposta | Verifique se a execução foi Concluída, se Enviar resposta está ativado no nó e se o Resultado está vazio. |
| O cliente viu mensagens de "pensando" que você não queria | Desative Encaminhar mensagens intermediárias ao cliente; as mensagens passam a ficar como sussurros para a sua equipe. |
dica
Compare algumas execuções do mesmo nó antes de mudar o orçamento. As etapas mostram se o agente precisa de mais espaço ou de instruções melhores.