> ## Documentation Index
> Fetch the complete documentation index at: https://symphony-docs.fcamara.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Visão geral e Execuções
> Acompanhe o uso de IA da sua empresa: usuários ativos, tokens, custos, modelos, agentes e cada execução.
**Acesso restrito.** Estas telas são destinadas a usuários com perfil **Administrador** (ou **Master**). As duas estão em **beta**.
## O que é
As telas **Visão geral** e **Execuções** mostram **como a sua empresa está usando a IA**: quantas pessoas usam, quanto usam, quais modelos e agentes são mais procurados, quanto isso custa e se houve erros.
* **Visão geral** é o painel de acompanhamento, com números resumidos e gráficos. Use para responder perguntas como "o uso está crescendo?", "qual área mais usa?" ou "quanto gastamos este mês?".
* **Execuções** é a lista detalhada de **cada uso de IA**: cada pergunta respondida no chat e cada etapa de fluxo. Use para investigar um caso específico, como "por que a resposta deste usuário deu erro?".
## Como acessar
Menu do usuário → **Painel Admin**.
Os valores em **dinheiro** (custo) só aparecem se a sua empresa tiver a permissão de **ver custos** no Painel Admin. Sem ela, as telas mostram tokens e execuções, mas não o custo.
## Conceitos básicos
| Termo | O que significa |
| - | - |
| **Execução** | Cada vez que a IA foi usada: uma resposta no chat, uma etapa de fluxo etc. |
| **Tokens** | A forma como a IA mede o tamanho dos textos. De forma aproximada, cada palavra equivale a um ou dois tokens. Quanto mais tokens, maior o uso e o custo. |
| **Tokens de entrada** | O que foi **enviado** para a IA: a pergunta, o histórico da conversa e os arquivos anexados. |
| **Tokens de saída** | O que a IA **gerou** na resposta. |
| **Latência** | Quanto tempo a IA levou para responder. |
| **Usuários ativos** | Pessoas que usaram a IA pelo menos uma vez no período. |
## Filtros
No topo das duas telas você escolhe:
* **Período** — **Últimas 24 horas**, **Últimos 7 dias**, **Últimos 30 dias**, **Últimos 90 dias** ou **Personalizado** (escolha as datas).
* **Unidade de negócio** — todas as BUs ou uma área específica.
Os números de toda a tela mudam conforme os filtros.
## Visão geral
### Indicadores principais
| Indicador | O que mostra |
| - | - |
| **Usuários ativos** | Quantas pessoas usaram a IA no período. |
| **Total de tokens** | Volume total de texto processado. |
| **Custo total** | Quanto foi gasto no período *(só com a permissão de ver custos)*. |
| **Execuções totais** | Quantas vezes a IA foi usada. |
Cada indicador mostra a **variação** em relação ao período anterior de mesma duração. Por exemplo, nos últimos 7 dias, a comparação é com os 7 dias anteriores.
### Uso ao longo do tempo
Gráfico do uso dia a dia. Em **Métrica**, alterne entre **Tokens**, **Execuções** e **Custo**.
### Consumo de IA
Os **Modelos** e **Agentes** mais usados no período, com os tokens e (com permissão) o custo de cada um. Ajuda a entender quais agentes estão gerando valor e quais quase não são usados.
### Consumo organizacional
Os **Usuários** e as **Unidades de negócio** que mais usaram a IA no período.
### Execuções recentes
As últimas execuções, com os mesmos filtros da tela. Para ver todas, use a tela **Execuções**.
## Execuções
A tela **Execuções** lista cada uso de IA, com estas colunas:
| Coluna | O que mostra |
| - | - |
| **Status** | **Sucesso**, **Aviso** ou **Erro** (veja abaixo). |
| **Quando** | Data e hora da execução. |
| **Usuário** | Quem usou. |
| **Unidade de negócio** | A área da pessoa. |
| **Agente** | O agente usado, se houver. |
| **Modelo** | O modelo de IA que respondeu. |
| **Latência** | Quanto tempo a resposta levou. |
| **Tokens de entrada** e **Tokens de saída** | O tamanho do que foi enviado e do que foi gerado. |
| **Custo total** | O custo da execução *(só com a permissão de ver custos)*. |
### O que cada status significa
| Status | Significado |
| - | - |
| **Sucesso** | A IA respondeu normalmente. |
| **Aviso** | A IA respondeu, mas algo fugiu do normal. Por exemplo, o modelo escolhido falhou e o Symphony **trocou automaticamente** para outro (veja [Troca automática de modelo](/admin/painel-administrativo)), ou a resposta chegou sem a contagem de tokens. |
| **Erro** | A IA não conseguiu responder. |
### Buscar e filtrar
* Use a **busca** para encontrar execuções por nome ou e-mail do usuário, modelo ou agente.
* Clique no título das colunas **Status**, **Usuário**, **Unidade de negócio**, **Agente** e **Modelo** para filtrar por um ou mais valores. Os filtros ativos aparecem numa barra acima da tabela e podem ser removidos um a um, ou todos de uma vez em **Limpar filtros**.
* Clique no título de uma coluna para ordenar.
### Ver o detalhe de uma execução
Clique em uma linha para abrir o **Detalhe da execução**, com latência, tokens, custo, usuário, agente, modelo, data e hora, e uma **prévia do texto enviado** à IA.
**Atenção à privacidade.** A prévia mostra parte do que o usuário escreveu. Trate essas informações com o mesmo cuidado que qualquer dado pessoal ou confidencial da empresa.
### Exportar
Clique em **Exportar** e escolha **Exportar CSV** ou **Exportar Excel**. A exportação usa os mesmos filtros e a mesma busca que estão ativos na tela.
### Excluir uma execução
Use o ícone de **Excluir** na linha. A execução deixa de aparecer na lista e nos totais.
## Exemplos de uso
| Pergunta | Onde olhar |
| - | - |
| Quanto gastamos com IA este mês? | **Visão geral** → período **Últimos 30 dias** → **Custo total**. |
| Qual área usa mais? | **Visão geral** → **Consumo organizacional** → **Unidades de negócio**. |
| O agente que criamos está sendo usado? | **Visão geral** → **Consumo de IA** → **Agentes**. |
| Um usuário reclamou de erro ontem. | **Execuções** → busque pelo e-mail → filtre **Status** = **Erro** → abra o detalhe. |
| Preciso de um relatório para a diretoria. | **Execuções** → ajuste os filtros → **Exportar Excel**. |
## Boas práticas
* **Acompanhe a Visão geral toda semana** para perceber cedo mudanças de uso ou de custo.
* **Compare períodos iguais.** A variação dos indicadores já faz isso por você.
* **Investigue picos de Erro** na tela Execuções: filtre por **Status = Erro** e veja se o problema se concentra em um modelo ou agente.
* **Use a exportação** em vez de copiar números manualmente.
* **Cadastre o preço dos modelos** em **Configurações → Modelos**. Sem preço, o custo das execuções aparece como zero.
## Perguntas frequentes
O custo só é calculado para modelos que têm **preço configurado** em **Configurações → Modelos**. Modelos sem preço aparecem com custo zero, e não com um valor estimado.
A sua empresa não tem a permissão de **ver custos** no Painel Admin. Fale com o responsável pela plataforma.
Sim. Acontece quando a tentativa falhou antes de a IA começar a responder (status **Erro**), ou quando a resposta chegou sem a contagem de tokens (status **Aviso**).
Sim. A conversa temporária não fica no histórico do usuário, mas o uso de IA dela é contabilizado.
Sim. Busque pelo nome ou e-mail na tela **Execuções**, ou abra o detalhe do usuário em **Gerenciamento → Usuários**.
## Limitações conhecidas
* As telas estão em **beta** e podem mudar.
* O custo depende do preço configurado em cada modelo.
* Os valores de custo exigem a permissão de **ver custos**.
* A prévia do texto enviado é resumida, e não mostra a conversa inteira.
* O horário de pico e as datas aparecem no fuso horário do seu computador.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.