> For the complete documentation index, see [llms.txt](https://docs.powerembedded.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerembedded.com/power-embedded-documentacao/portal-de-administracao/power-pilot-gen2-ia/criacao-de-assistentes-gen2.md).
# Criação de Assistentes Gen2
### O que é um assistente?
Um **assistente** é uma interface de IA configurada para responder perguntas sobre um conjunto de dados específico do Power BI. Ele combina um modelo de linguagem natural (LLM) com o esquema do seu dataset para gerar consultas DAX automaticamente e devolver respostas em linguagem natural.
Na prática, o usuário final não precisa saber escrever DAX ou conhecer a estrutura do modelo de dados basta fazer a pergunta como faria para um analista.
> **Exemplo:** "Qual foi o faturamento total por região no último trimestre?" → o assistente gera a consulta DAX, executa no dataset e retorna a resposta formatada.
Cada assistente é vinculado a um modelo de IA (configurado previamente) e a um ou mais conjuntos de dados. Você também controla quem pode acessá-lo: todos os usuários da organização, grupos específicos ou usuários individuais.
### Antes de começar
Certifique-se de que os seguintes passos já foram concluídos:
1. [Pré-requisitos do Power Pilot](https://docs.powerembedded.com.br/portal-de-administracao/power-pilot-ia/pre-requisitos) foram validados
2. Um provedor de IA foi contratado (Azure OpenAI, OpenAI, Gemini ou Claude)
3. Um [modelo de IA Gen2 foi criado](https://docs.powerembedded.com.br/portal-de-administracao/power-pilot-gen2-ia/criacao-de-modelos-de-ia-gen2) no Power Embedded
### Criando um assistente
Acesse: **Portal de Administração > Power Pilot > Assistentes > Criar assistente**
Ou [clique aqui](https://admin.powerembedded.com.br/PPGen2Assistants/Create) para ir direto à tela de criação.
A tela é dividida em cinco seções:
### Seção: Geral
Configurações principais de identidade e comportamento do assistente.
| Campo | Descrição |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome do assistente** | Nome exibido para os usuários no portal. Escolha algo descritivo, como "Assistente de Vendas" ou "Análise Financeira". |
| **Descrição** | Texto opcional exibido abaixo do nome. Ajuda os usuários a entenderem o propósito do assistente. |
| **Ativo** | Ativa ou desativa o assistente. Assistentes inativos não aparecem para os usuários. |
| **Instruções (system prompt)** | Define o comportamento, tom e regras do assistente. Use para personalizar a persona, restringir temas ou adicionar contexto de negócio. |
| **Usar modelo Power Pilot** | Ativa o modelo padrão da Power Tuning, ajustado para o Power Embedded. Inclui **100 perguntas gratuitas por organização**. Ao ativar, os campos de modelo abaixo ficam desabilitados. |
| **Modelo principal (heavy)** | Modelo LLM responsável pelas respostas principais e geração de DAX. Use modelos mais capazes (ex: GPT-4o, Gemini 1.5 Pro) para maior precisão. |
| **Modelo secundário (light)** | Modelo leve utilizado para sugestões de perguntas e otimizações. Usar um modelo mais econômico aqui reduz custos sem impactar a qualidade das respostas principais. |
| **Timeout da consulta DAX (segundos)** | Tempo máximo para execução de uma consulta DAX. O valor `0` significa sem limite. Se atingido, a IA tenta reescrever a consulta antes de retornar erro. |
#### Dicas para as Instruções (system prompt)
As instruções moldam como o assistente se comunica, mas **não alteram as regras internas de geração de DAX** nem as regras de formatação do sistema. Exemplos de uso:
* **Tom e persona:** "Você é um assistente de análise financeira. Responda sempre de forma objetiva e use termos técnicos do setor."
* **Restrições de escopo:** "Responda apenas perguntas relacionadas às vendas. Para outros assuntos, informe que está fora do seu escopo."
* **Contexto de negócio:** "O campo 'Receita Líquida' já desconta impostos. Sempre mencione isso quando falar de receita."
* **Idioma:** "Responda sempre em português, independentemente do idioma da pergunta."
### Seção: Conjuntos de dados
Selecione quais datasets do Power BI este assistente poderá consultar.
* Use o filtro por **nome** ou **workspace** para localizar o dataset desejado.
* É possível associar mais de um conjunto de dados ao mesmo assistente.
* O assistente só acessa tabelas e medidas **visíveis** no dataset itens marcados como ocultos no Power BI não são enviados ao modelo de IA.
### Seção: Usuários
Defina quais usuários individuais terão acesso ao assistente.
* Se **nenhum usuário e nenhum grupo** forem selecionados, **todos os usuários da organização** terão acesso automaticamente.
* A seleção é aditiva: um usuário tem acesso se estiver na lista de usuários **ou** pertencer a um grupo com acesso.
### Seção: Grupos
Defina quais grupos terão acesso ao assistente.
* O mesmo comportamento da seção de Usuários se aplica: sem seleção, o acesso é liberado para toda a organização.
* Recomendamos usar grupos para facilitar a gestão de acesso em organizações com muitos usuários.
### Seção: Perguntas em destaque
Configure perguntas sugeridas que aparecem para o usuário ao abrir o assistente. Isso reduz a fricção inicial e orienta sobre o que é possível perguntar.
* As perguntas aparecem como **botões clicáveis** na interface do assistente.
* É possível marcar uma pergunta como **padrão**, dando a ela destaque visual em relação às demais.
* Use perguntas que representem os casos de uso mais comuns do seu dataset.
**Exemplos de boas perguntas em destaque:**
* "Qual foi o faturamento total do mês atual?"
* "Quais são os 5 produtos mais vendidos?"
* "Compare as metas vs. realizado por equipe de vendas"
### Dúvidas frequentes
**Posso ter múltiplos assistentes usando o mesmo modelo de IA?** Sim. Um modelo de IA pode ser reutilizado por quantos assistentes forem necessários.
**O assistente acessa dados em tempo real?** Sim, as consultas DAX são executadas diretamente no dataset do Power BI no momento da pergunta.
**O que acontece se eu não selecionar nenhum conjunto de dados?** O assistente será criado, mas não conseguirá responder perguntas. É necessário associar ao menos um dataset para que funcione corretamente.
**Usuários sem permissão no relatório conseguem ver todos os dados pelo assistente?** Não. O RLS do Power BI é sempre aplicado o usuário só verá dados compatíveis com suas permissões.