# 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.

<figure><img src="/files/W3RvXz8YPXkYQpnFlXDD" alt=""><figcaption></figcaption></figure>

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:

<figure><img src="/files/2kk4uvxSjAE0TCDw8REP" alt=""><figcaption></figcaption></figure>

### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerembedded.com.br/portal-de-administracao/power-pilot-gen2-ia/criacao-de-assistentes-gen2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.