# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-22T05:54:14.681Z

## Página

- Título: Usar os assistentes de IA
- URL humana: https://agilize.app/docs/usuarios/inteligencia-artificial/usar-assistentes-de-ia
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como escolher um assistente, iniciar uma conversa, entender as fontes consultadas e revisar resultados na Central de IA.

## Seções

- Acesse a Central de IA
- Como escolher o assistente
- Quais fontes podem ser usadas
- Inicie uma conversa útil
- Entenda conversas, contexto e propostas
- Créditos e consumo
- Boas práticas
- Se um assistente não aparecer

## Conteúdo da página

# Usar os assistentes de IA

Os assistentes de IA são especialistas configurados para objetivos diferentes, como analisar resultados, apoiar uma implantação, esclarecer dúvidas de produto ou revisar uma jornada. A lista disponível varia conforme o projeto, o perfil da pessoa, a equipe e a tela atual.

## Acesse a Central de IA

Acesse :ScreenEntry{href="https://my.agilize.app/ai" label="Abrir os assistentes de IA" path="sidebar lateral > módulo Hub > Agentes de IA"}.

Na Central de IA, escolha primeiro **o resultado que você precisa**. A tela destaca os especialistas mais relacionados ao contexto atual e permite abrir todos os demais quando necessário.

![Escolha de assistentes por resultado na Central de IA](/docs/screenshots/ia-assistentes-escolha.png)

Você também pode:

- favoritar os assistentes mais usados;
- iniciar uma nova conversa com o assistente em foco;
- alternar entre conversas normais, temporárias, em curso e não lidas;
- voltar ao recurso de origem quando a conversa começou a partir de uma tela contextual.

## Como escolher o assistente

Leia o nome da ação e a descrição exibida no catálogo. Um especialista só aparece quando está ativo e quando você atende às regras de acesso definidas pelo administrador.

Quando a tela atual possui relação com um especialista, a Central de IA pode marcá-lo como **Mais indicado** ou **Também ajuda**. Essa recomendação organiza a escolha; ela não amplia as permissões do assistente.

## Quais fontes podem ser usadas

Cada assistente combina uma **habilidade**, que descreve como trabalhar, com uma **role de acesso**, que limita o que pode ser consultado. Conforme essa configuração, ele pode usar fontes como:

| Fonte | Exemplos de uso |
| --- | --- |
| CRM | Oportunidades, tarefas, suporte, contatos e estrutura comercial permitida. |
| Indicadores e metas | Relatórios, itens de BI, objetivos e resultados autorizados. |
| Conversas | Sala externa e mensagens relacionadas ao atendimento em contexto. |
| Configurações | Estrutura do projeto necessária para orientar ou preparar uma proposta. |
| Marketing | Campanhas, públicos, criativos e métricas disponíveis ao projeto. |
| Fluxos e automações | Bots, automações de CRM e webhooks autorizados. |
| Memória da empresa | Orientações, preferências e informações empresariais liberadas para a habilidade. |
| Documentação oficial | Guias de produto usados por especialistas de suporte. |

O assistente não recebe acesso irrestrito a essas áreas. A consulta depende simultaneamente dos recursos liberados na role, do escopo do agente, do projeto atual e das permissões de quem iniciou a execução.

## Inicie uma conversa útil

1. Escolha o assistente pelo resultado desejado.
2. Use uma resposta rápida sugerida ou escreva o pedido no campo **Como posso ajudar?**.
3. Informe período, objetivo e formato esperado quando isso for relevante.
4. Acompanhe o estado da execução: na fila, processando, aguardando você, concluído, falhou ou cancelado.
5. Revise a resposta, as fontes contextuais indicadas e qualquer proposta antes de continuar.

Exemplo objetivo:

```text
Analise as oportunidades em aberto deste mês, destaque os três principais gargalos e sugira uma próxima ação para cada um. Não invente dados ausentes.
```

## Entenda conversas, contexto e propostas

Uma conversa pode mostrar a tela ou o registro que originou o pedido. Esse vínculo ajuda o assistente a trabalhar com o contexto correto e permite voltar ao recurso relacionado.

Quando uma solicitação pode alterar dados, o assistente deve preparar uma proposta para revisão. Confira valores, destinos, responsáveis e impactos antes de aplicar. Uma recomendação textual, por si só, não confirma que uma alteração foi executada.

Conversas comuns permanecem disponíveis por até 60 dias. Operações temporárias, como o Copiloto de escrita, ficam separadas e são removidas em até 24 horas.

## Créditos e consumo

O cabeçalho mostra os créditos disponíveis, e respostas concluídas podem apresentar o consumo realizado. O valor depende do volume de contexto, do tamanho da resposta e das consultas necessárias.

Se o limite pessoal ou o pool do projeto estiver sem saldo, novas execuções que dependem dessa quota ficam indisponíveis. Veja [Créditos e quotas de IA](/docs/configuracao/inteligencia-artificial/creditos-e-quotas-de-ia).

## Boas práticas

- Faça um pedido por vez quando o assunto for complexo.
- Informe o período e o resultado esperado.
- Peça para o assistente apontar lacunas em vez de completar informações por suposição.
- Confira números e registros na fonte antes de tomar decisões sensíveis.
- Cancele uma execução em curso quando o pedido estiver incorreto; depois, envie uma instrução mais específica.

## Se um assistente não aparecer

| Sintoma | Causa provável | O que fazer |
| --- | --- | --- |
| A Central de IA não aparece | Projeto não identificado ou recurso indisponível para a conta. | Confirme o projeto atual e peça ao administrador para revisar a disponibilidade da IA. |
| Um especialista específico não aparece | Agente inativo, restrito a administradores, pessoas ou equipes. | Peça ao administrador para revisar público e status do agente. |
| O assistente não encontra um dado | Fonte não autorizada, escopo restrito ou registro fora da sua permissão. | Confirme seu acesso e a role usada pelo agente. |
| A resposta ficou genérica | Pedido amplo ou contexto insuficiente. | Informe objetivo, período, critérios e formato de saída. |

## Guias relacionados

- [Melhorar e gerar respostas com o Copiloto de escrita](/docs/usuarios/inteligencia-artificial/melhorar-gerar-respostas)
- [Configurar assistentes de IA](/docs/configuracao/inteligencia-artificial/configurar-assistentes-de-ia)
- [Rotinas de IA](/docs/configuracao/inteligencia-artificial/rotinas-de-ia)