> ## Documentation Index
> Fetch the complete documentation index at: https://help.iteam.works/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat com Agentes

> O coração do iTeam. Aprenda a conversar para obter análises, gráficos, arquivos e ações — com técnicas de prompt, anexos, receitas prontas e solução de problemas.

O **Chat com Agentes** é onde você passa a maior parte do tempo. À esquerda, seus agentes e times; no centro, a conversa. Você pede em linguagem normal e o agente **executa de verdade** — consulta dados, gera gráficos, cria widgets, dispara ações.

<Frame caption="📸 Screenshot a inserir [/pt/conversar/chat-com-agentes]: tela do Chat — lista de agentes à esquerda, conversa no centro, painel de widget à direita.">
  <img src="https://mintcdn.com/iteam/E1mg8rFlXblsaNT0/images/placeholder.svg?fit=max&auto=format&n=E1mg8rFlXblsaNT0&q=85&s=36c435f4df28c31a7e114586a931bbd2" alt="Chat com Agentes" width="800" height="420" data-path="images/placeholder.svg" />
</Frame>

## O fluxo, na prática

<Steps>
  <Step title="Escolha o agente certo">
    Na lista à esquerda, os **mais usados aparecem primeiro**. Escolha o especialista no assunto (analista de dados para números, suporte para atendimento).
  </Step>

  <Step title="Faça o pedido de forma específica">
    Inclua **objetivo, período, recorte e formato**. O agente entende a intenção e escolhe as ferramentas.
  </Step>

  <Step title="Receba e itere">
    A resposta vem em texto, **tabela**, **gráfico** ou um **widget** ao lado. Não ficou perfeito? Refine na mesma conversa.
  </Step>
</Steps>

## Como pedir bem (técnicas que mudam o resultado)

<AccordionGroup>
  <Accordion title="Diga o período e o recorte">
    ❌ "mostra as vendas" → ✅ "vendas dos **últimos 7 dias**, **por canal**, só **pedidos pagos**".
  </Accordion>

  <Accordion title="Peça o formato">
    "responde em **tabela**", "faz um **gráfico de barras**", "**resume em 3 bullets**", "me dá **um número** e a variação".
  </Accordion>

  <Accordion title="Itere em vez de recomeçar">
    "agora **separa por mês**", "**tira os cancelados**", "**compara** com o mês passado". O agente ajusta sobre o que já fez.
  </Accordion>

  <Accordion title="Peça para virar widget">
    Gostou de um resultado recorrente? "**transforma isso num widget**" e você reusa sempre. [Widgets →](/pt/conversar/widgets)
  </Accordion>
</AccordionGroup>

## Anexos: trabalhe com seus arquivos

Clique no **clipe** para enviar:

* **Imagens** — o agente "vê" a imagem (ex.: print de um erro, foto de um documento).
* **Planilhas (Excel/CSV)** — "analise esta base", "qual a soma da coluna X por categoria".
* **PDFs** — "resuma este contrato", "extraia as datas e valores".

<Tip>
  Para planilhas grandes, peça um recorte: "considere só as colunas data, valor e status e me dê o total por mês".
</Tip>

## Recursos que ajudam no dia a dia

| Recurso                     | O que faz                                                               |
| --------------------------- | ----------------------------------------------------------------------- |
| **Histórico**               | Toda conversa fica salva; volte e continue de onde parou.               |
| **Painel de widget**        | Widgets abrem ao lado; redimensione (arraste a borda) ou maximize.      |
| **Continua se você fechar** | Pedidos longos seguem rodando no servidor — você não perde o resultado. |
| **Memória de sessão**       | O agente lembra o que já fez **nesta conversa** e evita refazer.        |

## Conversa longa, agente afiado

O iTeam mantém o agente **focado mesmo em conversas longas**: ele lembra o que já foi feito na sessão e **aprende com conversas anteriores** (preferências, correções, o que deu certo). Resultado: menos repetição e respostas mais consistentes. Ainda assim, para um **assunto totalmente novo**, comece uma **nova conversa** — o contexto fica mais limpo e as respostas mais rápidas.

## Receitas prontas

<AccordionGroup>
  <Accordion title="Pulso diário do negócio">
    "Me dá um panorama de hoje: faturamento, nº de pedidos e ticket médio, comparados com a média dos últimos 7 dias. Um número-chave em destaque e um gráfico."
  </Accordion>

  <Accordion title="Investigar uma queda">
    "O faturamento caiu ontem. Quebra por canal e por produto e me diz onde foi a maior queda."
  </Accordion>

  <Accordion title="Análise de arquivo">
    (anexe a planilha) "Analisa esta base de clientes: total por estado e os 10 maiores em receita, em tabela."
  </Accordion>
</AccordionGroup>

## Solução de problemas

<AccordionGroup>
  <Accordion title="“Não tenho acesso a esses dados”">
    O agente precisa da [Fonte de Dados](/pt/recursos/fontes-de-dados) liberada. Conecte e libere para ele.
  </Accordion>

  <Accordion title="A resposta veio genérica">
    Seja mais específico (período/recorte/formato) e use um agente com dados conectados e boas instruções.
  </Accordion>

  <Accordion title="A conversa está lenta ou confusa">
    Conversa muito longa? Inicie uma nova para o mesmo assunto. O contexto enxuto melhora a velocidade.
  </Accordion>

  <Accordion title="Não consigo ver um agente">
    É acesso. Peça a um Admin para liberar — veja [Segurança & Acessos](/pt/administracao/seguranca-e-acessos).
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Widgets" icon="layout-dashboard" href="/pt/conversar/widgets">
    Transforme respostas em telas reutilizáveis.
  </Card>

  <Card title="Assistente iTeam" icon="sparkles" href="/pt/conversar/assistente-iteam">
    Monte agentes, formulários e processos conversando.
  </Card>
</CardGroup>