# Início

Seja bem-vindo à documentação do Power Omni, onde você irá conhecer melhor a solução de IA corporativa da Power Tuning, entender seus diferenciais em segurança e governança, e como ela pode aumentar a produtividade da sua empresa.

O Power Omni é um portal web no formato de SaaS (Software as a Service), que utiliza modelos avançados de Inteligência Artificial para criar Agentes corporativos, seguros e integrados aos seus dados internos.

A solução roda diretamente no seu Azure, garantindo total controle de acesso, privacidade dos dados e conformidade, sem o risco de vazamento de informações para ferramentas abertas.

#### Principais Documentações

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">O que é o Power Omni?</td><td><a href="/files/JXh4idRAcTddfHkOY9oE">/files/JXh4idRAcTddfHkOY9oE</a></td><td><a href="/files/JXh4idRAcTddfHkOY9oE">/files/JXh4idRAcTddfHkOY9oE</a></td><td><a href="/pages/KAIlsoMBUg9MK7GBsmse">/pages/KAIlsoMBUg9MK7GBsmse</a></td></tr><tr><td align="center">Agendar Apresentação</td><td><a href="/files/iSShqibs2Sh7x4sWAwSz">/files/iSShqibs2Sh7x4sWAwSz</a></td><td></td><td><a href="https://sales.powertuning.com.br/meetings/dirceu-resende/apresentacao-power-omni?uuid=3d593f76-6220-47a6-b4f9-cc1cc3f27c67">https://sales.powertuning.com.br/meetings/dirceu-resende/apresentacao-power-omni?uuid=3d593f76-6220-47a6-b4f9-cc1cc3f27c67</a></td></tr><tr><td align="center">Conheça a Power Tuning</td><td><a href="/files/B6T1jdBGPLIiD4jBHkcn">/files/B6T1jdBGPLIiD4jBHkcn</a></td><td><a href="/files/B6T1jdBGPLIiD4jBHkcn">/files/B6T1jdBGPLIiD4jBHkcn</a></td><td><a href="https://powertuning.com.br/">https://powertuning.com.br/</a></td></tr><tr><td align="center">Calculadora de custos</td><td><a href="/files/CPEBk8noT7KbmKCtz4Wm">/files/CPEBk8noT7KbmKCtz4Wm</a></td><td></td><td><a href="https://poweromni.ai/calculadora-de-custos/">https://poweromni.ai/calculadora-de-custos/</a></td></tr><tr><td align="center">Instalação Power Omni </td><td><a href="/files/dml0JnbdHkibcC8WoaH7">/files/dml0JnbdHkibcC8WoaH7</a></td><td></td><td><a href="/pages/JNp5FU0qI9DRuoRLqUTQ">/pages/JNp5FU0qI9DRuoRLqUTQ</a></td></tr><tr><td align="center">Atualizações Recentes</td><td><a href="/files/cKUGn1UYsYRRY8MHqaq4">/files/cKUGn1UYsYRRY8MHqaq4</a></td><td></td><td><a href="/pages/hMAmd1O4G6s1QX8AS9Ae">/pages/hMAmd1O4G6s1QX8AS9Ae</a></td></tr></tbody></table>


# O que é o Power Omni?

O Power Omni é a solução de Inteligência Artificial corporativa da Power Tuning, desenvolvida para empresas que buscam alta produtividade com total segurança e governança.

Diferente de ferramentas abertas (como o ChatGPT), ele roda diretamente no seu Azure, garantindo total controle sobre os dados e acessos.

A plataforma permite que você conecte a IA aos seus arquivos e sistemas internos da empresa de forma segura e confiável, transformando documentos em fontes de conhecimento para a IA.

### Principais Desafios de IA nas Empresas que o Power Omni Soluciona

O Power Omni foi desenhado para mitigar os riscos e superar as barreiras de adoção da IA em ambientes corporativos:

* Falta de Governança: O uso de IAs abertas sem controle, onde cada usuário utiliza uma ferramenta diferente, sem auditoria e gerenciamento de permissões.
* Risco de Vazamento de Dados: Exposição de informações sensíveis em ferramentas externas que podem utilizar os dados da empresa para treinar seus modelos.
* Falta de Contexto e Integração: Dificuldade em integrar a IA com arquivos, políticas, contratos, manuais internos e sistemas da empresa para obter respostas relevantes.
* Custos Elevados: Preços altos para licenciar e escalar a tecnologia de IA mais avançada para todos os usuários da empresa.

### A Solução Power Omni: Segurança e Produtividade

A solução do Power Omni endereça esses desafios através de seus pilares de segurança, governança e integração:

<table><thead><tr><th width="295">Característica</th><th>Descrição</th></tr></thead><tbody><tr><td>Dados Sob Seu Controle</td><td>Os dados são processados e armazenados no seu ambiente Azure, garantindo que estejam sob o controle exclusivo da empresa, sem risco de exposição externa.</td></tr><tr><td>Governança e Auditoria</td><td>A plataforma oferece auditoria de uso, monitorando quais usuários e agentes estão ativos. Inclui relatórios de custos e gerenciamento de permissões.</td></tr><tr><td>Integração com Dados Corporativos </td><td>Permite o upload seguro de documentos internos (políticas, manuais, contratos) para que a IA os utilize como fonte de dados para responder às consultas dos usuários.</td></tr><tr><td>Consultas Inteligentes</td><td>Os usuários podem fazer perguntas complexas, solicitando partes específicas de documentos ou regulamentos, como "qual a cláusula de valores" ou a "política de reembolso".</td></tr><tr><td>Escalabilidade com Baixo Custo</td><td>Oferece acesso aos modelos mais avançados de IA com um custo baixo por usuário, promovendo economia em relação a ferramentas tradicionais.</td></tr><tr><td>Integrações Futuras</td><td>Há a possibilidade de conectar o Power Omni com sistemas internos (ERP, CRM, SharePoint, etc.) e outras fontes de dados via consultoria especializada.</td></tr></tbody></table>

### Benefícios Chave

* Segurança Corporativa: Dados e usuários estão sob a governança da empresa, rodando em seu próprio Azure.
* Transparência: Relatórios de custos em tempo real e auditoria completa de uso.
* Produtividade Acelerada: Acesso rápido a informações internas e suporte para atividades do time, com a capacidade de criar Agentes de IA personalizados para cada necessidade.
* Baixo Custo de Adoção: Economia estimada de até 70% em relação a ferramentas tradicionais, com previsibilidade e baixo custo por usuário.


# Quanto custa o Power Omni?

O Power Omni adota uma estrutura de custos simples e transparente, baseada em licença por usuário ativo, mais o custo variável de infraestrutura (tokens) pago diretamente à Microsoft.

Confira abaixo o resumo das condições comerciais para o período de Trial (Avaliação Gratuita) e para o Plano Padrão (Após o Trial).

### Estrutura de Custos

A tabela abaixo resume os principais componentes de custo do Power Omni:

<table><thead><tr><th width="138">Componente</th><th width="209">Período de Trial (30 dias)</th><th width="199">Plano Padrão (Mensal)</th><th>Observações</th></tr></thead><tbody><tr><td>Taxa de Onboarding</td><td>R$ 0,00</td><td>R$ 2.400,00</td><td>Pagamento à vista ou em até 3x.</td></tr><tr><td>Mensalidade Power Omni</td><td>R$ 0,00</td><td>R$ 15,00 por licença ativo/mês</td><td>Mínimo de 10 licenças ativos.</td></tr><tr><td>Suporte</td><td>Enterprise (incluso gratuitamente)</td><td>Plano Básico (incluso) ou Enterprise (opcional).</td><td>Veja detalhe dos planos de Suporte no item 3.</td></tr><tr><td>Infraestrutura Azure</td><td>Custo do consumo de tokens pago pelo Cliente à Microsoft.</td><td>Custo do consumo de tokens pago pelo Cliente à Microsoft.</td><td>O consumo de tokens e APIs de IA é 100% transparente.</td></tr></tbody></table>

### Detalhamento do Plano Padrão

#### Mensalidade (Licença de Uso)

O valor mensal é calculado com base no número de licenças que têm acesso ao Power Omni no período, garantindo baixo custo para escalar a produtividade da IA para toda a empresa.

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

* Precificação por Faixas de Volume O Power Omni utiliza um modelo de faturamento escalonável. Quanto maior o número de licenças ativas, menor será o custo unitário aplicado em sua fatura. O desconto é aplicado em faixas, Iniciando em R$ 15,00 por licença podendo chegar até R$ 5,00 reais por licença.
* Contrato Mínimo: A contratação exige um mínimo de 10 licenças.

#### Taxa de Onboarding (Implementação)

A Taxa de Onboarding cobre a configuração inicial da plataforma no Azure do cliente e o setup de segurança.

* Valor: R$ 2.400,00.
* Condição: Pode ser paga à vista ou parcelada em até 3x.

***

### Custos de Infraestrutura e Tokens (Azure)

O Power Omni se diferencia por rodar diretamente no Azure do cliente, oferecendo total segurança e controle sobre os dados.

* Custo Variável: O consumo de tokens, que é a unidade de medida do uso da IA, é pago diretamente pelo cliente à Microsoft.
* Benefício: Essa abordagem proporciona total transparência, permitindo o acompanhamento em tempo real dos relatórios de custos de tokens no Portal de Administração.

***

### Planos de Suporte (Opcional)

<table><thead><tr><th width="202">Plano</th><th width="347">Benefícios</th><th>Custo Mensal</th></tr></thead><tbody><tr><td>Plano Básico</td><td>Chamados abertos via e-mail e pela plataforma de suporte.</td><td>Incluso no valor da Mensalidade</td></tr><tr><td>Plano Enterprise</td><td>Atendimento prioritário nos canais padrão, mais atendimento via grupo no WhatsApp.</td><td>R$ 380,00/mês.</td></tr><tr><td>Suporte no Trial</td><td>O Suporte Enterprise é incluso gratuitamente durante o período de avaliação de 30 dias.</td><td>R$ 0,00.</td></tr></tbody></table>


# Meu Período de Teste Acabou, e Agora?

O período de Trial de 30 dias do Power Omni é o tempo ideal para sua empresa validar a segurança, governança e produtividade da nossa IA corporativa. Esta página detalha o que acontece ao final da avaliação e como prosseguir com a contratação.

### Processo de Conversão

O processo de conversão para o plano pago é simples e automático, garantindo a continuidade do serviço e evitando interrupções.

* Duração do Trial: O período de avaliação gratuita dura 30 dias.
* Aceite dos Termos: Durante a ativação, foi realizado o aceite eletrônico dos termos diretamente na plataforma.
* Conversão Automática: Ao término dos 30 dias, a conta será convertida automaticamente para o plano pago.
* Cancelamento: A conversão automática só é impedida caso haja uma solicitação de cancelamento formal antes do término do período.

### Condições Comerciais Após o Trial

Após a conversão, a cobrança passa a ser realizada com base nas seguintes condições e valores:

#### Taxa de Implementação (Onboarding)

<table><thead><tr><th width="232">Item</th><th width="208">Valor</th><th>Condição de Pagamento</th></tr></thead><tbody><tr><td>Taxa de Onboarding</td><td>R$ 2.400,00</td><td>À vista ou em até 3x.</td></tr><tr><td><em>No Trial:</em></td><td><em>R$ 0,00</em></td><td>Taxa de Onboarding inclusa gratuitamente durante o trial.</td></tr></tbody></table>

#### Mensalidade do Serviço

<table><thead><tr><th width="234">Item</th><th width="253">Valor</th><th>Observação</th></tr></thead><tbody><tr><td>Mensalidade Power Omni</td><td>R$ 15,00 por licença no mês.</td><td>Cobrança com mínimo de 10 licenças.</td></tr><tr><td><em>No Trial:</em></td><td><em>R$ 0,00</em></td><td>Mensalidade isenta durante o trial.</td></tr></tbody></table>

### Infraestrutura (Tokens e Azure)

O Power Omni utiliza o próprio Azure do cliente, garantindo total controle sobre os dados corporativos.

* Consumo de Tokens (Azure): O consumo da infraestrutura Azure (que inclui o uso de tokens e processamento de IA) é pago diretamente pelo cliente à Microsoft.
* Monitoramento de Custos: Você tem total transparência e auditoria de uso, com relatórios de custos para acompanhamento em tempo real do consumo de tokens e valores pagos à Microsoft.

### Planos de Suporte

Ao final do trial, o suporte passa a ser cobrado ou reduzido, dependendo do plano escolhido:

<table><thead><tr><th width="190">Plano de Suporte</th><th>Canais Inclusos</th><th>Custo Após o Trial</th></tr></thead><tbody><tr><td>Plano Básico</td><td>Chamados abertos via e-mail e pela plataforma.</td><td>Incluso (sem custo adicional).</td></tr><tr><td>Plano Enterprise</td><td>Atendimento prioritário e grupo exclusivo no WhatsApp.</td><td>Opcional (R$ 380,00/mês).</td></tr><tr><td><em>No Trial:</em></td><td>Suporte Enterprise incluso gratuitamente durante os 30 dias.</td><td><em>R$ 0,00</em>.</td></tr></tbody></table>

Caso tenha qualquer dúvida sobre as condições ou precise agendar uma reunião para alinhamento final antes do término do Trial, por favor, entre em contato com o time comercial.


# Documento de Apresentação

{% embed url="<https://www.canva.com/design/DAG3vZ6oga8/1Nmc-_x8oqAP8PJQPkloaA/view?utm_content=DAG3vZ6oga8&utm_campaign=designshare&utm_medium=link2&utm_source=uniquelinks&utlId=h13a72458de>" %}

<figure><img src="https://www.canva.com/design/DAG1-e_JmIE/wEdcSGjimp-jQLu0EtQdPA/view?utm_content=DAG1-e_JmIE&#x26;utm_campaign=designshare&#x26;utm_medium=link2&#x26;utm_source=uniquelinks&#x26;utlId=h0b17b76d7d" alt=""><figcaption></figcaption></figure>


# Agendar reunião

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Apresentação do Power  Omni</td><td><a href="/files/iSShqibs2Sh7x4sWAwSz">/files/iSShqibs2Sh7x4sWAwSz</a></td><td><a href="https://poweromni.ai/apresentacao">https://poweromni.ai/apresentacao</a></td></tr><tr><td align="center">Instalação do Power <br>Omni</td><td><a href="/files/9Q5vaFXCqLpE6l4noaIi">/files/9Q5vaFXCqLpE6l4noaIi</a></td><td><a href="https://poweromni.ai/apresentacao">https://poweromni.ai/apresentacao</a></td></tr></tbody></table>


# Portal do Usuário

A interface do Power Omni é desenhada para a máxima produtividade e facilidade de uso

### Interface de Conversação

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

A tela principal do usuário é o *chat* com o Agente de IA, onde você pode:

* **Selecionar Agentes:** A barra lateral esquerda lista os Agentes de IA disponíveis, criados por você. Selecione o agente ideal para a sua necessidade.
* **Acesso ao Hub de Agentes:** O menu lateral inclui um atalho direto para o Hub de Agentes, permitindo que você retorne à visualização completa para buscar, filtrar por Workspace ou selecionar um Agente Principal.
* **Perguntar:** Digite sua consulta na caixa "Pergunte alguma coisa". O Power Omni responderá utilizando o **Modelo de IA** e as **fontes de dados (Conectores)** permitidas para o Agente selecionado.
* **Histórico:** Suas conversas anteriores são salvas e listadas na barra lateral para fácil acesso.
* **Configurações do Usuário:** Clicando no seu nome de usuário (localizado no canto inferior esquerdo do menu lateral), você terá acesso a alteração do tema, alteração do idioma e a tela de administração e configuração.

{% hint style="info" %}

## <mark style="color:$tint;">Importante</mark>

<mark style="color:$primary;">O Power Omni é uma ferramenta poderosa, mas como toda IA, pode cometer erros. Sempre verifique informações importantes e confie em seus dados corporativos indexados.</mark>
{% endhint %}


# Hub de Agentes

O Hub de Agentes é a página inicial da experiência do usuário no Power Omni, centralizando todos os Agentes de Inteligência Artificial aos quais você tem acesso, organizados por suas respectivas Áreas de Trabalho (Workspaces).

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

### Visão Geral do Hub

A tela principal oferece uma navegação rápida e visual para que você localize, organize e inicie conversas com os Agentes de IA.

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

#### 🖼 Modos de Visualização

Você pode alternar a forma como os Workspaces e seus Agentes são apresentados:&#x20;

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

* **Visualização em Grade (Cards):** Ideal para uma visão rápida e visual, mostrando Workspaces como cartões grandes com fácil identificação dos Agentes dentro deles.

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

* **Visualização em Lista:** Oferece uma estrutura mais compacta e linear, facilitando a navegação rápida por um grande número de Workspaces e Agentes.

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

#### 🔎 Pesquisa e Filtro

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

* **Campo de Busca:** Utilize a barra de pesquisa para encontrar rapidamente qualquer Agente pelo Nome.
* **Filtro por Workspace:** No menu abaixo do campo de busca, você pode clicar em um Workspace específico para exibir somente os Agentes contidos nele, isolando sua pesquisa.

### Menu Lateral Esquerdo (Navegação Rápida)

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

O menu de navegação lateral esquerdo (Workspaces) foi ajustado para melhorar a organização e o foco do usuário:

* **Filtro Dinâmico:** Ao selecionar uma Área de Trabalho (Workspace), a lista de Agentes é automaticamente ajustada para mostrar apenas aqueles que pertencem ao Workspace selecionado.
* **Agente Principal:** O menu lateral contém uma seção separada para seu Agente principal, garantindo acesso imediato.

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

#### Adicionando um Agente Principal

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

1. Localize o Agente desejado na Visualização em Grade ou Lista na tela de Hub.
2. Clique no Ícone da Casa, presente no cartão ou linha do Agente.
3. O Agente será movido para a área separada de Agente Principal, no menu lateral esquerdo, onde ficará disponível para acesso rápido, independentemente do filtro de Workspace.

### Interação com Agentes

Iniciar uma conversa é a principal ação no Hub de Agentes:

* **Abrir Nova Conversa:** Ao clicar em qualquer Agente (seja no modo de Grade, Lista ou Padrão), uma nova conversa é aberta instantaneamente, permitindo que você comece a interagir com a IA.

#### Gerenciamento de Agentes

Você também pode gerenciar a visibilidade dos Agentes:

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

* **Ocultar Agente:** Se um Agente não for relevante para o seu trabalho diário, você pode optar por ocultá-lo. Esta ação remove o Agente do menu lateral esquerdo, liberando espaço e simplificando sua lista de acesso rápido. O Agente oculto pode ser reativado a qualquer momento através da tela de Hub de agentes.


# Instruções Personalizadas

O Power Omni permite que você personalize a interação, adicionando instruções que refinam a qualidade e o estilo da resposta do Agente para o seu perfil.

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

#### O que são Instruções Personalizadas?

Instruções Personalizadas são comandos adicionais que você fornece ao Agente para guiar suas respostas (ex: tom formal, formato específico, foco em um tópico, etc.).

> <mark style="color:$warning;">Importante: As instruções personalizadas servem como informações adicionais que complementam as configurações (instruções) definidas pelo administrador. Elas são vinculadas somente ao seu perfil de usuário ao interagir com aquele Agente específico.</mark>

#### Como Adicionar / Editar Instruções

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

1. **Acesso:** Na tela de conversa, localize o campo Intruções personalizadas, no canto inferior direito, da caixa de entrada de mensagens.
2. **Edição:** Na janela de configuração que se abre, utilize o campo de texto para escrever as instruções que fornecerão contexto adicional ao Agente.
3. **Aplicação:** Clique em "Salvar" para aplicar as novas instruções.

As instruções que você define são salvas e persistentes. Elas permanecerão ativas para você em todas as conversas futuras com aquele Agente, mesmo que você saia e retorne à sessão.

{% hint style="info" %} <mark style="color:$warning;">Importante: O Power Omni é uma ferramenta poderosa, mas como toda IA, pode cometer erros. Sempre verifique informações importantes e confie em seus dados corporativos indexados.</mark>
{% endhint %}


# Leitura de imagens

### 1. Visão Geral

A funcionalidade de Análise de Imagens permite que os usuários enviem arquivos visuais diretamente no chat do Power Omni. Agora, a IA integrada possui a capacidade de "enxergar", interpretar e analisar imagens para fornecer insights, transcrições ou explicações técnicas baseadas no conteúdo visual fornecido.

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

***

#### 2. Como Realizar o Upload

O Power Omni oferece três formas práticas para você enviar suas imagens para análise:

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

* Pelo Menu de Anexos: Clique no ícone de clipe de papel na barra de digitação, selecione Imagem e escolha o arquivo em seu computador.
* Arrastar e Soltar (Drag & Drop): Simplesmente selecione o arquivo de imagem em sua pasta e arraste-o diretamente para dentro da área da conversa.
* Colar do Atalho (Ctrl + V): Se você tirou um print da tela (Print Screen) ou copiou uma imagem da web, basta clicar na caixa de texto e pressionar Ctrl + V para colar a imagem instantaneamente.

***

#### 3. Principais Capacidades

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

* OCR (Reconhecimento de Texto): Extração de textos de capturas de tela, documentos digitalizados ou fotos.
* Diagnóstico Visual: Envio de prints de mensagens de erro ou logs do sistema para diagnóstico instantâneo.
* Interpretação de Dados: Análise de gráficos, tabelas e diagramas para resumir informações principais.
* Suporte Contextual: Oferece contexto visual às suas perguntas, resultando em respostas mais precisas da IA.

***

### 4. Formatos Suportados e Limites

* Formatos: Arquivos de imagem padrão (PNG, JPG, JPEG, WEBP).
* Processamento: A IA processa a imagem em tempo real para responder à sua consulta específica.
* Multi-upload: É possível enviar mais de uma imagem para comparar dados ou fornecer um contexto mais amplo.

***

### 5. Boas Práticas

* Clareza: Certifique-se de que a imagem não está borrada e que o texto está legível para melhores resultados de leitura.
* Especificidade: Ao enviar uma imagem, seja específico na sua pergunta (ex: em vez de "O que é isso?", tente "Explique o fluxo de trabalho mostrado neste diagrama").
* Privacidade: Evite o envio de imagens contendo credenciais sensíveis, a menos que seja estritamente necessário para um atendimento de suporte.


# Guia de Pré-Instalação

### Objetivo&#xD;

Garantir as permissões mínimas no Microsoft Azure para instalar o Power Omni

O que será configurado:

[1- Habilitar “Gerenciamento de acesso para os recursos do Azure”](/guia-de-pre-instalacao#id-2-habilitar-gerenciamento-de-acesso-para-os-recursos-do-azure) ✅

[2- Conceder a função Proprietário (Owner) na assinatura onde os recursos serão criados](/guia-de-pre-instalacao#id-3-atribuir-proprietario-owner-na-assinatura) ✅

[3- Registrar Provedor de Recursos (Resource Providers)](/guia-de-pre-instalacao#id-4-verificar-provedor-de-recursos-resource-providers) ✅

***

### 1- Acesso ao Portal

1. Acesse o [portal.azure.com](https://portal.azure.com/)&#x20;
2. Logue com a conta de administrador

***

### 2- Habilitar “Gerenciamento de acesso para os recursos do Azure”

1. No menu lateral, selecione **Microsoft Entra ID**.

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

2. Na página do Microsoft Entra ID, clique em **Gerenciar** e acesse **Propriedades**.

<div align="center"><figure><img src="/files/RGK0jdEXHUXzJRyioEyz" alt=""><figcaption></figcaption></figure></div>

<div align="center"><figure><img src="/files/3bo1c9b0Ucw28RMRe99Y" alt=""><figcaption></figcaption></figure></div>

3. Procure **Gerenciamento de acesso para os recursos da Azure**.

4. Verifique se está marcado “**Sim**”. Se não estiver, marque **Sim** e salve.

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

***

### 3- Atribuir Proprietário (Owner) na assinatura

1. No topo do portal, busque por **Assinaturas** (Subscriptions).

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

2. Na tela de **Assinaturas**, selecione a assinatura desejada.

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

3. Na assinatura selecionada, acesse **Access control (IAM)** ➜ Check access e busque pelo e-mail do usuário.

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

4. Verifique se o usuário já possui a permissão **Proprietário (Owner)**.

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

5. <mark style="color:$success;">Se possuir, acesse o</mark> [<mark style="color:$success;">passo 4 (Provedores de Recurso).</mark>](#id-4-verificar-provedor-de-recursos-resource-providers)
6. <mark style="color:$warning;">Se não possuir</mark>, clique em **+ Add (+ Adicionar)** ➜ **Add role assignment** (Adicionar atribuição de função).

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

7. Em **Role** (Função), selecione **Owner (Proprietário)** e clique em **Next (Avançar)**.

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

8. Em **Members (Membros)**, clique em **Select members (Selecionar membros)**, pesquise o usuário instalador e selecione-o.

<figure><img src="/files/97XdlxU3pktTrye6iIgj" alt=""><figcaption></figcaption></figure>

9. Em **Conditions (Condições)**, mantenha o padrão selecione **Allow user to assign all roles**

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

10. Clique em **Review + assign (Examinar + atribuir)** para finalizar.

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

### 4- Verificar Provedor de Recursos (Resource Providers)

1. &#x20;Dentro da sua assinatura, clique em **Configurações  ->** **Provedores de recursos**.

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

2. Busque por **Machine** e localiza o provedor "**Microsoft.MachineLeanirngServices**", ele precisa estar registrado.

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

3. Caso não esteja registrado, clique nos 3 pontos e clique em **Registrar**.

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

{% hint style="success" %} <mark style="color:$success;">Pronto, após esses processos, a Instalação do Power Omni já pode ser realizada.</mark>
{% endhint %}

{% hint style="danger" %}

\ <mark style="color:$danger;">**Observação:**</mark>
\ <mark style="color:$danger;">**● Esse processo de pré-instalação deve ser realizado**</mark><mark style="color:$danger;">**&#x20;**</mark><mark style="color:$danger;">**pelo menos 20 minutos antes da**</mark>
\ <mark style="color:$danger;">**instalação oficial, devido à propagação das permissões pela Microsoft.**</mark>
{% endhint %}


# Instalação Power Omni

Este guia apresenta, de forma simples e objetiva, todo o processo para realizar a instalação automática do Power Omni.

{% hint style="danger" %}

### Atenção:

<mark style="color:$danger;">Antes de iniciar, é obrigatório acessar e seguir os passos de pré-instalação (Link abaixo) para habilitar as permissões de acesso necessárias no seu ambiente Azure.</mark>&#x20;

[Guia de pré-Instalação](/guia-de-pre-instalacao)
{% endhint %}

***

### Passo 1: Início e Login

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

1. Acesse o site principal: [poweromni.ai.](https://poweromni.ai/)
2. Clique no botão "**Teste agora**"
3. Você será redirecionado para a página de Login. Faça o Login utilizando sua Conta Microsoft, vinculada ao Azure, onde o Power Omni será instalado.

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

* Imediatamente após o login, será exibido um pop-up solicitando o consentimento para o uso do Power Omni em nome de sua organização.
* **Ação:** É necessário conceder este consentimento para que o Power Omni obtenha as permissões adequadas e possa avançar com o processo de instalação em seu ambiente Azure.

### Passo 2: Registro da Empresa e Termos de Uso

Após o login, preencha os dados cadastrais da empresa:

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

1. Ao informar o CNPJ ou CPF, os dados devem ser carregados automaticamente. No entanto, caso isso não ocorra, será necessário realizar o preenchimento manual das informações.
2. **Preencha as informações obrigatórias:** CNPJ, Nome da empresa, Endereço completo, etc.
3. **Código Municipal (Importante):** No campo de endereço, preencha o código da cidade, conforme a tabela do IBGE.

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

{% hint style="info" %}
*Dica:* Clique no ícone de informação ao lado do campo, para ser redirecionado ao site do IBGE e consultar o código municipal correto.
{% endhint %}

3. Leia e aceite o Termo de Uso da plataforma.

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

{% hint style="info" %}

### Para acessar o documento completo, clique em <mark style="color:$primary;">Termos de Uso.</mark> O arquivo será aberto, permitindo a leitura, o download ou a impressão.

{% endhint %}

### Passo 3: Escolha do Método de Instalação

Na tela de instalação:

<figure><img src="/files/4HznAjnVNfiDSqYP4tmm" alt=""><figcaption></figcaption></figure>

1. **Escolha do Método:** Selecione a opção **Instalação Automática (melhor opção)**.
2. **Assinatura Azure:** No campo apropriado, selecione a **Assinatura Azure (Subscription)** na qual os recursos do Power Omni serão provisionados.

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

### Passo 4: Configurações dos recursos

Na página de Instalação Automática, você verá os recursos do Azure que serão provisionados.

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

<table data-header-hidden><thead><tr><th width="222"></th><th></th></tr></thead><tbody><tr><td><strong>Configuração</strong></td><td><strong>Ação Recomendada</strong></td></tr><tr><td>Grupo de Recursos e Azure AI Foundry</td><td>Não é necessário alterar. Pode manter o nome que vem por padrão.</td></tr><tr><td>Nome do Projeto e Região (Campo 3)</td><td>Você pode alterar o nome do Projeto, se desejar. Para a Região, recomendamos manter "eastus" ou "eastus2".</td></tr><tr><td>Modelo AI</td><td>Você pode alterar o modelo que será a base naquele momento. Recomendamos iniciar com o padrão (ex: gpt-4.1 mini).</td></tr><tr><td>Validação de Cota</td><td>APÓS selecionar o modelo, clique em "<strong>Validar Quota</strong>". Esta etapa verifica se sua assinatura Azure possui a capacidade necessária (Quota) para provisionar os serviços de IA.</td></tr></tbody></table>

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

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

Configuração do Primeiro Agente de IA:

* Você pode alterar o nome e as instruções iniciais do seu Agente Padrão nesta tela.
* Caso prefira, poderá editar esse Agente posteriormente à instalação, no Portal de Administração.

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

Após preencher e validar todas as informações, clique no botão "**Iniciar Instalação**".

### Passo 5: Conclusão do Provisionamento

Aguarde o sistema completar o provisionamento dos recursos em seu *tenant* Azure. O tempo de espera pode variar.

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

#### ⚠️ Solução de Erro Comum: Bloqueio de Pop-up

Se ocorrer algum erro ou o processo não avançar após o clique, verifique se o seu navegador bloqueou a abertura de uma nova janela (*pop-up*).

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

1. **Liberação:** Localize o ícone de bloqueio de *pop-up* (geralmente na barra de endereço do navegador).
2. **Permitir:** Clique no ícone e selecione a opção para permitir *pop-ups*.

<figure><img src="/files/3DEKK8yLsm3l9peQKUPh" alt=""><figcaption></figcaption></figure>

3. **Tentar Novamente:** Após liberar o *pop-up*, tente iniciar a instalação novamente.

### Passo 6: Finalização e Acesso

1. Após o provisionamento ser concluído com sucesso, você será notificado.

<figure><img src="/files/7Vt1LuamBzgrWrhShlMQ" alt=""><figcaption></figcaption></figure>

2. Clique em "**Finalizar**" para encerrar o processo de instalação.
3. Pronto! Você já terá acesso à plataforma, ao seu agente padrão e poderá começar a utilizar o Power Omni.

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

4. Basta clicar no card **Agente Padrão** (ou no nome que você deu ao seu agente), e a tela de conversação será aberta para você começar a utilizar o Power Omni.

***

{% hint style="info" %}

#### 🛠 Suporte Enterprise durante o Período de Teste

Durante o período de teste, você tem acesso ao Suporte Enterprise diretamente via grupo no WhatsApp para te auxiliarmos no processo de implantação do Power Omni na sua empresa.

Basta enviar um email para: <mark style="color:green;"><suporte@poweromni.ai></mark> solicitando a criação do grupo e informando seu contato do WhatsApp.
{% endhint %}


# Suporte

**Precisa de suporte com o Omni?**\
Nossa equipe está à disposição para te ajudar!

Você pode entrar em contato diretamente pelos seguintes canais:\
📧 **E-mail:** <suporte@poweromni.ai>\
📱 **WhatsApp:** [poweromni.ai/whatsapp](https://poweromni.ai/whatsapp)


# Perguntas Frequentes (FAQ)

Esta seção responde às dúvidas mais comuns sobre segurança, uso e modelo de negócio do Power Omni.

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Duvidas Gerais</td><td><a href="/files/81ELAfe09BMneVFcOWkc">/files/81ELAfe09BMneVFcOWkc</a></td><td><a href="/pages/mzPEWpdOjXtFtu498G6Z">/pages/mzPEWpdOjXtFtu498G6Z</a></td></tr><tr><td align="center">Segurança e Privacidade</td><td><a href="/files/g4xzPDQ88KM9bF8j6NUD">/files/g4xzPDQ88KM9bF8j6NUD</a></td><td><a href="/pages/JCi9Z46wQqzUveO7DJgq">/pages/JCi9Z46wQqzUveO7DJgq</a></td></tr><tr><td align="center">Licenciamento e Custos</td><td><a href="/files/5fTbhRuXECpuAhnX03Y6">/files/5fTbhRuXECpuAhnX03Y6</a></td><td><a href="/pages/6h3g4YfIH8kDmd1j1M9H">/pages/6h3g4YfIH8kDmd1j1M9H</a></td></tr></tbody></table>


# Dúvidas Gerais e Funcionalidade

**O que o Power Omni usa como base para responder?**
\
O Power Omni utiliza modelos de IA avançados e os combina com o recurso que busca informações nos seus documentos e sistemas internos (Conectores) para fornecer respostas contextualizadas.

**Como funciona a integração com documentos da empresa?**\
Através da tecnologia RAG (Retrieval-Augmented Generation), o Power Omni indexa seus documentos — contratos, manuais, políticas internas, regulamentos — e permite que a IA responda perguntas com base nessas fontes, citando o trecho exato de onde veio a informação.\
\
**Preciso ter Azure para usar o Power Omni?**\
Sim, é necessária uma assinatura Azure para hospedar o Microsoft Foundry. **A Azure Brasil**, parceira Microsoft Solutions Partner, pode criar e configurar sua conta Azure, otimizar custos e gerenciar os recursos com governança total.\
\
**Qual a diferença do Power Omni para o ChatGPT ou Copilot?**\
O ChatGPT e Copilot são ferramentas genéricas que processam dados em servidores externos, sem governança. O Power Omni oferece: dados no seu Azure, governança por usuário e agente, integração com documentos internos, custo menor em escala corporativa e auditoria completa de todo uso.


# Segurança e Privacidade

**Os meus dados ficam protegidos?** \
Sim. Diferente de ferramentas como ChatGPT público ou Copilot gratuito, o Power Omni processa todos os dados no ambiente Azure da sua empresa. A Microsoft e a Power Tuning não têm acesso aos seus dados — tudo fica sob controle total da sua organização.\
\
**Meus dados são usados para treinar a Inteligência Artificial?** \
Não. O Power Omni foi construído com foco em **privacidade e segurança**. Os dados da sua empresa são processados no seu **próprio ambiente Azure** e sob seu controle. Eles não são compartilhados para treinar o modelo de IA e não há risco de exposição externa.

**Como funciona a segurança no acesso aos documentos?** \
A segurança é gerenciada por meio de **Permissões**. O administrador usa **Grupos** e o **Diagrama de Permissões** para definir exatamente quais **Agentes** podem acessar quais **Arquivos** e quais **Usuários** podem usar esses Agentes.

**O Power Omni é compatível com a LGPD?**\
Sim. Por processar os dados dentro do ambiente do cliente (seu Azure), a solução fornece o nível máximo de controle e conformidade com regulamentações de privacidade.


# Licenciamento e Custos

**Como funciona o modelo de cobrança do Power Omni?** O modelo é **Híbrido**:

1. **Custo Fixo Mensal:** Valor por Licença, que garante acesso à plataforma, governança e interface.
2. **Custo Variável (Consumo de Tokens):** Cobrança feita pela Microsoft, referente ao uso do Azure. O Power Omni apenas monitora e audita esse consumo para você.

**A Taxa de Onboarding é obrigatória?** \
Sim, ela cobre os custos de implantação inicial, configuração do ambiente Azure e suporte ao cliente para os primeiros passos na plataforma.

**Consigo limitar o uso (USD) direto no Omni?**\
Sim, dentro da ferramenta no Portal de configuração temos a opção chamada Orçamentos, onde irá conseguir limitar o uso da plataforma em $.

**Como funciona o período de teste gratuito?**\
Os primeiros 30 dias são gratuitos. Você paga apenas o custo do Azure AI Foundry. O onboarding e a mensalidade só são cobrados após os 30 dias, se a sua empresa decidir continuar.


# Atualizações Recentes

Confira abaixo as novas funcionalidades adicionadas recentemente ao Power Omni

### Agosto 2026

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/gx1O3mn7NWNZi2EbuZSS" %}
[Toolboxes](/administracao-e-configuracao/artefatos/toolboxes)
{% endcontent-ref %}

### Junho 2026

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/VfxNe4xHz6433yigyYh2" %}
[Migração](/migracao)
{% endcontent-ref %}

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/92b4fTT2773Qy35oQRLJ" %}
[Busca na Web](/administracao-e-configuracao/artefatos/conectores/conectores-padroes/busca-na-web)
{% endcontent-ref %}

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/hYASzGjFEcYaKXV5g6h6" %}
[MCP](/administracao-e-configuracao/artefatos/conectores/mcp)
{% endcontent-ref %}

### Maio 2026

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/gHGU8SCKqwfj8EL10hOv" %}
[SharePoint](/administracao-e-configuracao/artefatos/conectores/sharepoint)
{% endcontent-ref %}

### Abril 2026

{% content-ref url="/pages/0v8KHOBwlZbOD0HR9v7p" %}
[Logotipo](/administracao-e-configuracao/personalizacao/logotipo)
{% endcontent-ref %}

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/JGpn7fc6JFMQmenCg0Zv" %}
[Leitura de imagens](/portal-do-usuario/leitura-de-imagens)
{% endcontent-ref %}

### Dezembro 2025

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/lxyJcNfUkkeeshnmsYOP" %}
[N8N](/administracao-e-configuracao/artefatos/conectores/n8n)
{% endcontent-ref %}

### Novembro 2025

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/pWsyi0rGJ0DSWBgFni9D" %}
[Logic Apps](/administracao-e-configuracao/artefatos/conectores/logic-apps)
{% endcontent-ref %}

{% content-ref url="/pages/Du5wb1meQETYA5MFb7OD" %}
[Hub de Agentes](/portal-do-usuario/hub-de-agentes)
{% endcontent-ref %}

{% content-ref url="/pages/G6QGZ0q5oOtfcexOsRPV" %}
[Instruções Personalizadas](/portal-do-usuario/instrucoes-personalizadas)
{% endcontent-ref %}

### Outubro 2025

{% content-ref url="/spaces/LGvDlIVKG3lx8yU6pzIF/pages/Gx5mam14WtzwLItBcIII" %}
[Orçamento](/administracao-e-configuracao/orcamento)
{% endcontent-ref %}


# Política de Privacidade

Este site é mantido e operado por **Power Tuning – Soluções em TI Ltda**.

A sua privacidade é importante para nós e por isso respeitamos a sua privacidade em relação a qualquer informação sua que possamos coletar no site **poweromni.a**i, e outros sites que possuímos e operamos.

Nós coletamos e utilizamos alguns dados pessoais que pertencem àqueles que utilizam nosso site. Ao fazê-lo, agimos na qualidade de **controlador** desses dados e estamos sujeitos às disposições da Lei Federal n. 13.709/2018 (Lei Geral de Proteção de Dados Pessoais – LGPD).

Nós cuidamos da proteção de seus dados pessoais e, por isso, disponibilizamos esta política de privacidade, que contém informações importantes sobre:

– Quem deve utilizar nosso site; – Quais dados coletamos e o que fazemos com eles; – Seus direitos em relação aos seus dados pessoais; e – Como entrar em contato conosco.

#### **1. Dados que coletamos e motivos da coleta** <a href="#id-1.-dados-que-coletamos-e-motivos-da-coleta" id="id-1.-dados-que-coletamos-e-motivos-da-coleta"></a>

Nosso site coleta e utiliza alguns dados pessoais, de acordo com o disposto nesta seção.

***1.1 Dados pessoais fornecidos expressamente pelo usuário.***

Nós coletamos os seguintes dados pessoais que nossos usuários nos fornecem expressamente ao utilizar nosso site:

* Nome completo;
* Nome da empresa;
* Endereço de e-mail;
* Número de telefone;
* Mensagem de contato.

A coleta destes dados ocorre nos seguintes momentos:

* Quando preenche formulário Contato ou responde ao Chatbot, com a finalidade de solicitar que seja realizado contato comercial para apresentação de produtos e serviços.
* Quando preenche formulário Trabalhe Conosco, com a finalidade de se inscrever no banco de talentos e ter oportunidade de fazer parte da nossa empresa.

Os dados fornecidos por nossos usuários são coletados com as seguintes finalidades:

* Para que nosso time comercial possa entrar em contato com os usuários a fim de responder os pedidos de contato para apresentação dos nossos produtos e serviços;
* Analisar candidaturas e formalizar contrato de trabalho e demais atividades relacionadas a um vínculo de emprego;

***1.2 Dados pessoais obtidos de outras formas***

Nós coletamos os seguintes dados pessoais de nossos usuários:

* endereço IP;
* dados de geolocalização;
* fuso horário.

A coleta destes dados ocorre nos seguintes momentos:

* Quando você acessa o site.

Estes dados são coletados com as seguintes finalidades:

* Medir as interações do usuário com os sites e/ou apps dos clientes.
* Proteger a segurança do serviço e informar a origem dos usuários.

***1.3 Dados sensíveis***

**Não** fazemos a coleta de dados sensíveis, assim entendidos aqueles definidos nos arts. 11 e seguintes da Lei de Proteção de Dados Pessoais. Assim, **não** haverá coleta de dados sobre origem racial ou étnica, convicção religiosa, opinião política, filiação a sindicato ou a organização de caráter religioso, filosófico ou político, dado referente à saúde ou à vida sexual, dado genético ou biométrico, quando vinculado a uma pessoa natural.

***1.4. Cookies***

*1.4.1 O que são cookies?*

*Cookies* são pequenos arquivos de texto baixados automaticamente em seu dispositivo quando você acessa e navega por um site. Eles servem, basicamente, para seja possível identificar dispositivos, atividades e preferências de usuários.

Os *cookies* não permitem que qualquer arquivo ou informação sejam extraídos do disco rígido do usuário, não sendo possível, ainda, que, por meio deles, se tenha acesso a informações pessoais que não tenham partido do usuário ou da forma como utiliza os recursos do site.

*1.4.2 Como usamos os cookies?*

Utilizamos cookies por vários motivos, detalhados abaixo. Infelizmente, na maioria dos casos, não existem opções padrão do setor para desativar os cookies sem desativar completamente a funcionalidade e os recursos que eles adicionam a este site. É recomendável que você deixe todos os cookies se não tiver certeza se precisa ou não deles, caso sejam usados para fornecer um serviço que você usa.

*1.4.3 Desativar cookies*

O usuário poderá se opor ao registro de cookies pelo site, bastando que desative esta opção no seu próprio navegador. Mais informações sobre como fazer isso em alguns dos principais navegadores utilizados hoje podem ser acessadas a partir dos seguintes links:

Internet Explorer: *<https://support.microsoft.com/pt-br/help/17442/windows-internet-explorer-delete-manage-cookies>*

Safari: *<https://support.apple.com/pt-br/guide/safari/sfri11471/mac>*

Google Chrome: *<https://support.google.com/chrome/answer/95647?hl=pt-BR\\&hlrm=pt>*

Mozila Firefox:*<https://support.mozilla.org/pt-BR/kb/ative-e-desative-os-cookies-que-os-sites-usam>*

Opera: *<https://www.opera.com/help/tutorials/security/privacy/>*

A desativação dos cookies, no entanto, pode afetar a disponibilidade de algumas ferramentas e funcionalidades do site, comprometendo seu correto e esperado funcionamento. Outra consequência possível é remoção das preferências do usuário que eventualmente tiverem sido salvas, prejudicando sua experiência.

1.4.4 Cookies que definimos

* Cookies relacionados a formulários: quando você envia dados por meio de um formulário como os encontrados nas páginas de contato ou nos formulários de comentários, os cookies podem ser configurados para lembrar os detalhes do usuário para correspondência futura.
* Cookies de preferências do site: para proporcionar uma ótima experiência neste site, fornecemos a funcionalidade para definir suas preferências de como esse site é executado quando você o usa. Para lembrar suas preferências, precisamos definir cookies para que essas informações possam ser chamadas sempre que você interagir com uma página que for afetada por suas preferências.

1.4.5 Cookies de Terceiros

Em alguns casos especiais, também usamos cookies fornecidos por terceiros confiáveis. A seção a seguir detalha quais cookies de terceiros você pode encontrar através deste site.

* Este site usa o Google Analytics, que é uma das soluções de análise mais difundidas e confiáveis da Web, para nos ajudar a entender como você usa o site e como podemos melhorar sua experiência. Esses cookies podem rastrear itens como quanto tempo você gasta no site e as páginas visitadas, para que possamos continuar produzindo conteúdo atraente.
* As análises de terceiros são usadas para rastrear e medir o uso deste site, para que possamos continuar produzindo conteúdo atrativo. Esses cookies podem rastrear itens como o tempo que você passa no site ou as páginas visitadas, o que nos ajuda a entender como podemos melhorar o site para você.
* Periodicamente, testamos novos recursos e fazemos alterações sutis na maneira como o site se apresenta. Quando ainda estamos testando novos recursos, esses cookies podem ser usados para garantir que você receba uma experiência consistente enquanto estiver no site, enquanto entendemos quais otimizações os nossos usuários mais apreciam.
* À medida que vendemos produtos, é importante entendermos as estatísticas sobre quantos visitantes de nosso site realmente compram e, portanto, esse é o tipo de dados que esses cookies rastrearão. Isso é importante para você, pois significa que podemos fazer previsões de negócios com precisão que nos permitem analisar nossos custos de publicidade e produtos para garantir o melhor preço possível.

***1.5. Coleta de dados não previstos expressamente***

Eventualmente, outros tipos de dados não previstos expressamente nesta Política de Privacidade poderão ser coletados, desde que sejam fornecidos com o consentimento do usuário, ou, ainda, que a coleta seja permitida com fundamento em outra base legal prevista em lei.

Em qualquer caso, a coleta de dados e as atividades de tratamento dela decorrentes serão informadas aos usuários do site.

#### **2. Compartilhamento de dados pessoais com terceiros** <a href="#id-2.-compartilhamento-de-dados-pessoais-com-terceiros" id="id-2.-compartilhamento-de-dados-pessoais-com-terceiros"></a>

Nós não compartilhamos seus dados pessoais com terceiros. Apesar disso, é possível que o façamos para cumprir alguma determinação legal ou regulatória, ou, ainda, para cumprir alguma ordem expedida por autoridade pública.

#### **3. Por quanto tempo seus dados pessoais serão armazenados** <a href="#id-3.-por-quanto-tempo-seus-dados-pessoais-serao-armazenados" id="id-3.-por-quanto-tempo-seus-dados-pessoais-serao-armazenados"></a>

Os dados pessoais coletados pelo site são armazenados e utilizados por período de tempo que corresponda ao necessário para atingir as finalidades elencadas neste documento e que considere os direitos de seus titulares, os direitos do controlador do site e as disposições legais ou regulatórias aplicáveis.

Uma vez expirados os períodos de armazenamento dos dados pessoais, eles são removidos de nossas bases de dados ou anonimizados, salvo nos casos em que houver a possibilidade ou a necessidade de armazenamento em virtude de disposição legal ou regulatória.

#### **4. Bases legais para o tratamento de dados pessoais** <a href="#id-4.-bases-legais-para-o-tratamento-de-dados-pessoais" id="id-4.-bases-legais-para-o-tratamento-de-dados-pessoais"></a>

Cada operação de tratamento de dados pessoais precisa ter um fundamento jurídico, ou seja, uma base legal, que nada mais é que uma justificativa que a autorize, prevista na Lei Geral de Proteção de Dados Pessoais.

Todas as Nossas atividades de tratamento de dados pessoais possuem uma base legal que as fundamenta, dentre as permitidas pela legislação. Mais informações sobre as bases legais que utilizamos para operações de tratamento de dados pessoais específicas podem ser obtidas a partir de nossos canais de contato, informados ao final desta Política.

#### **5. Direitos do usuário** <a href="#id-5.-direitos-do-usuario" id="id-5.-direitos-do-usuario"></a>

O usuário do site possui os seguintes direitos, conferidos pela Lei de Proteção de Dados Pessoais:

* confirmação da existência de tratamento;
* acesso aos dados;
* correção de dados incompletos, inexatos ou desatualizados;
* anonimização, bloqueio ou eliminação de dados desnecessários, excessivos ou tratados em desconformidade com o disposto na lei;
* portabilidade dos dados a outro fornecedor de serviço ou produto, mediante requisição expressa, de acordo com a regulamentação da autoridade nacional, observados os segredos comercial e industrial;
* eliminação dos dados pessoais tratados com o consentimento do titular, exceto nos casos previstos em lei;
* informação das entidades públicas e privadas com as quais o controlador realizou uso compartilhado de dados;
* informação sobre a possibilidade de não fornecer consentimento e sobre as consequências da negativa;
* revogação do consentimento.

É importante destacar que, nos termos da LGPD, não existe um direito de eliminação de dados tratados com fundamento em bases legais distintas do consentimento, a menos que os dados sejam desnecessários, excessivos ou tratados em desconformidade com o previsto na lei.

***5.1 Como o titular pode exercer seus direitos***

Os titulares de dados pessoais tratados por nós poderão exercer seus direitos por enviando um *e-mail* ou uma correspondência ao nosso Encarregado de Proteção de Dados Pessoais. As informações necessárias para isso estão na seção “Como entrar em contato conosco” desta Política de Privacidade.

Para garantir que o usuário que pretende exercer seus direitos é, de fato, o titular dos dados pessoais objeto da requisição, poderemos solicitar documentos ou outras informações que possam auxiliar em sua correta identificação, a fim de resguardar nossos direitos e os direitos de terceiros. Isto somente será feito, porém, se for absolutamente necessário, e o requerente receberá todas as informações relacionadas.

#### **6. Medidas de segurança no tratamento de dados pessoais** <a href="#id-6.-medidas-de-seguranca-no-tratamento-de-dados-pessoais" id="id-6.-medidas-de-seguranca-no-tratamento-de-dados-pessoais"></a>

Empregamos medidas técnicas e organizativas aptas a proteger os dados pessoais de acessos não autorizados e de situações de destruição, perda, extravio ou alteração desses dados.

As medidas que utilizamos levam em consideração a natureza dos dados, o contexto e a finalidade do tratamento, os riscos que uma eventual violação geraria para os direitos e liberdades do usuário, e os padrões atualmente empregados no mercado por empresas semelhantes à nossa.

Entre as medidas de segurança adotadas por nós, destacamos as seguintes:

* Os dados de nossos usuários são armazenados em ambiente seguro;
* Utilizamos certificado SSL (Secure Socket Layer), de modo que a transmissão de dados entre os dispositivos dos usuários e nossos servidores aconteça de forma criptografada;
* Mantemos registros de todos aqueles que têm, de alguma forma, contato com nossos dados.
* Utilizamos firewall e antivírus em servidores para proteção contra ameaças de malware;
* Limitamos o acesso aos dados de nossos usuários, de modo que terceiros não autorizados não possam acessá-los.

Ainda que adote tudo o que está ao seu alcance para evitar incidentes de segurança, é possível que ocorra algum problema motivado exclusivamente por um terceiro – como em caso de ataques de *hackers* ou *crackers* ou, ainda, em caso de culpa exclusiva do usuário, que ocorre, por exemplo, quando ele mesmo transfere seus dados a terceiro. Assim, embora sejamos, em geral, responsáveis pelos dados pessoais que tratamos, nos eximimos de responsabilidade caso ocorra uma situação excepcional como essas, sobre as quais não temos nenhum tipo de controle.

De qualquer forma, caso ocorra qualquer tipo de incidente de segurança que possa gerar risco ou dano relevante para qualquer de nossos usuários, comunicaremos os afetados e a Autoridade Nacional de Proteção de Dados acerca do ocorrido, em conformidade com o disposto na Lei Geral de Proteção de Dados.

#### **7. Alterações nesta política** <a href="#id-7.-alteracoes-nesta-politica" id="id-7.-alteracoes-nesta-politica"></a>

A presente versão desta Política de Privacidade foi atualizada pela última vez em: 31/05/2024.

Reservamo-nos o direito de modificar, a qualquer momento, as presentes normas, especialmente para adaptá-las às eventuais alterações feitas em nosso site, seja pela disponibilização de novas funcionalidades, seja pela supressão ou modificação daquelas já existentes.

Sempre que houver uma modificação, nossos usuários serão notificados acerca da mudança.

#### ***8. Como entrar em contato conosco*** <a href="#id-8.-como-entrar-em-contato-conosco" id="id-8.-como-entrar-em-contato-conosco"></a>

*Para esclarecer quaisquer dúvidas sobre esta Política de Privacidade ou sobre os dados pessoais que tratamos, entre em contato com nosso Encarregado de Proteção de Dados Pessoais, por algum dos canais mencionados abaixo:*

* *E-mail:* [*atendimento-lgpd@powertuning.com.br*](mailto:atendimento-lgpd@powertuning.com.br)


# Permissão Foundry User

Para que um usuário consiga utilizar, pelo Power Omni, recursos protegidos pelo Microsoft Foundry, a função Foundry User deve ser atribuída à conta desse usuário no Azure.

Esse cenário se aplica, por exemplo, aos usuários que irão consumir um agente conectado a um **agente de dados do Microsoft Fabric**. Nesse tipo de integração, a autenticação é feita com a identidade do próprio usuário no Microsoft Entra ID.&#x20;

{% hint style="warning" %}
A Microsoft renomeou recentemente a função **Azure AI User** para **Foundry User**. Durante a atualização do Azure, o nome antigo ainda pode aparecer em alguns ambientes. As permissões e o identificador da função continuam os mesmos.
{% endhint %}

## Por que essa permissão é necessária?

Quando o usuário acessa um agente pelo Power Omni, a identidade dele pode ser usada para autenticar a solicitação no Azure e validar quais recursos ele tem permissão para consumir.

A função **Foundry User** concede as permissões de leitura e de plano de dados necessárias para que o usuário consiga:

* acessar o recurso e o projeto do Foundry;
* utilizar modelos já implantados;
* interagir com agentes;
* executar chamadas de inferência;
* consumir recursos do projeto usando sua própria identidade do Microsoft Entra ID.

Sem essa atribuição, o Azure pode bloquear a solicitação com erros de autorização, como **403 - Access denied**, mesmo que o agente esteja configurado corretamente no Power Omni.

A função não concede acesso administrativo completo. O usuário não poderá gerenciar a assinatura, atribuir funções a outras identidades ou excluir recursos do Azure.

## Pré-requisitos

Antes de começar, confirme que:

* O recurso e o projeto do Microsoft Foundry já foram criados;
* Os usuários que utilizarão o agente possuem conta no Microsoft Entra ID;
* Os usuários e os recursos envolvidos estão no tenant correto;
* Para integrações com Fabric, o projeto Foundry e o agente de dados do Fabric estão no mesmo tenant;
* Sua conta tem permissão para criar atribuições de função no recurso, como **Proprietário**, **Administrador de Acesso do Usuário** ou **Administrador de Controle de Acesso Baseado em Função**.

## Passo a passo

{% stepper %}
{% step %}

## Abra o recurso do Microsoft Foundry

1. Acesse o [Portal do Azure](https://portal.azure.com/).
2. No campo de pesquisa superior, procure pelo nome do recurso Foundry utilizado pelo Power Omni ou o grupo de recursos.
3. Abra o recurso correto.

{% hint style="info" %}
Para reduzir o nível de acesso, faça a atribuição diretamente no recurso Foundry usado pelo Power Omni. Evite aplicar a função na assinatura inteira sem necessidade.
{% endhint %}
{% endstep %}

{% step %}

## Acesse o Controle de acesso (IAM)

No menu lateral do recurso, selecione **Controle de acesso (IAM)**.

<figure><img src="/files/19bEQdinbblrUfUl134S" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Inicie uma nova atribuição de função

1. Clique em **Adicionar**.
2. Selecione **Adicionar atribuição de função**.

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

Se a opção estiver desabilitada, sua conta não possui permissão para atribuir funções nesse escopo. Nesse caso, solicite a ação a um administrador do Azure.
{% endstep %}

{% step %}

## Selecione a função Foundry User

1. Na guia **Função**, mantenha selecionada a opção **Funções de trabalho**.
2. No campo de busca, pesquise por **Foundry User**.
3. Se o nome não aparecer, pesquise por **Azure AI User**, que é o nome anterior da mesma função.
4. Selecione a função e clique em **Avançar**.

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

O identificador oficial da função é:

```
53ca6127-db72-4b80-b1b0-d745d6d5456d
```

Esse ID pode ser usado para confirmar que a função selecionada é a correta.
{% endstep %}

{% step %}

## Selecione o usuário&#x20;

Na guia **Membros**:

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

1. Marque **Usuário, grupo ou entidade de serviço**.
2. Clique em **Selecionar membros**.

No painel lateral:

1. Pesquise pelo grupo ou pelo nome ou pelo e-mail do usuário.\
   Ex: Vai usar para o conector do Fabric? Adicione os usuários que vão consumir esse agente..
2. Repita o processo para adicionar outros usuários, quando necessário.

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

3. Confirme em **Selecionar**.
4. Clique em **Avançar**.
   {% endstep %}

{% step %}

## Revise e conclua a atribuição

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

1. Na guia **Examinar + atribuir**, confirme:
   * Função: **Foundry User** ou **Azure AI User**;
   * Membro: Usuários ou grupos que vão consumir os agentes;
   * Escopo: recurso Foundry correto.
2. Clique em **Examinar + atribuir**.
3. Se o botão continuar disponível após a primeira confirmação, clique novamente para concluir.
   {% endstep %}

{% step %}
{% hint style="info" %}
A propagação da permissão pode levar alguns minutos. Depois desse período, peça ao usuário para acessar novamente o Power Omni e testar o agente vinculado ao recurso.
{% endhint %}
{% endstep %}
{% endstepper %}

## Problemas comuns

<details>

<summary>A função Foundry User não aparece</summary>

Pesquise pelo nome antigo **Azure AI User**. A Microsoft ainda está concluindo a alteração de nome em todos os portais e regiões. Também é possível pesquisar pelo ID da função:

```
53ca6127-db72-4b80-b1b0-d745d6d5456d
```

</details>

<details>

<summary>O botão Adicionar atribuição de função está desabilitado</summary>

Sua conta não possui `Microsoft.Authorization/roleAssignments/write` no escopo selecionado. Solicite a atribuição a um usuário com uma das funções abaixo:

* Proprietário;
* Administrador de Acesso do Usuário;
* Administrador de Controle de Acesso Baseado em Função.

</details>

<details>

<summary>A atribuição aparece, mas o Power Omni ainda recebe erro de acesso</summary>

1. Aguarde alguns minutos para a propagação da função.
2. Confirme que a permissão foi aplicada ao recurso Foundry correto.
3. Caso existam vários recursos Foundry configurados, repita a atribuição em cada recurso necessário.
4. Teste novamente a chamada pelo Power Omni.

</details>


# Migração

O Power Omni está passando por uma atualização importante na infraestrutura que sustenta os agentes de IA da plataforma.

Até agora, os agentes utilizavam a base clássica do Microsoft Foundry. Essa estrutura atendeu bem ao produto por bastante tempo, mas está sendo descontinuada pela Microsoft e será substituída pela nova geração do Microsoft Foundry Agents.

Por esse motivo, será necessário migrar os agentes do Power Omni para a nova infraestrutura.

Essa migração mantém o Power Omni alinhado com a evolução da Microsoft e prepara a plataforma para recursos mais modernos, mais estabilidade e novas possibilidades dentro dos agentes de IA.

### Aviso de atualização disponível

Quando a migração estiver disponível para o seu ambiente, o Power Omni exibirá um aviso no topo da tela:

“Uma atualização importante está disponível para o seu ambiente. Saiba mais sobre os benefícios.”

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

Ao clicar em Saiba mais, você será direcionado para a página Migração New Foundry.

Nessa página, você poderá entender os benefícios da atualização, revisar os impactos da migração e iniciar o processo.

### Página Migração New Foundry

Na página Migração New Foundry, você poderá revisar as informações principais da atualização antes de iniciar o processo.

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

Essa tela apresenta o motivo da migração, os prazos importantes definidos pela Microsoft, os benefícios imediatos e as possibilidades que a nova infraestrutura abre para o produto.

### Por que essa migração é necessária?

A Microsoft está encerrando gradualmente o suporte às tecnologias antigas utilizadas na versão clássica do Foundry.

A Assistants API, usada como base para agentes em estruturas anteriores, será encerrada em 26 de agosto de 2026. Após essa data, agentes que ainda dependam dessa tecnologia podem deixar de funcionar.

Além disso, o suporte ao Foundry Classic será encerrado em 31 de março de 2027. Depois dessa data, a migração não poderá mais ser feita pela base antiga.

Por isso, recomendamos realizar a migração com antecedência.

### O que muda na prática?

A principal mudança acontece na camada técnica do Power Omni.

O usuário continua acessando seus agentes dentro da plataforma, mas a infraestrutura por trás deles passa a utilizar a nova base do Microsoft Foundry.

Com isso, os agentes passam a funcionar sobre uma estrutura mais atual, preparada para lidar melhor com conversas longas, consultas em arquivos, conectores e novas ferramentas que poderão ser adicionadas ao produto.

### Benefícios imediatos

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

Com a nova infraestrutura, os agentes passam a ter respostas mais fluidas.

O mecanismo de streaming foi reescrito na nova plataforma, permitindo que as respostas sejam entregues de forma mais contínua, com menos interrupções em textos longos ou consultas mais complexas.

Outro ponto importante é a estabilidade das conversas. A nova arquitetura trata cada conversa de forma mais isolada, reduzindo problemas onde o histórico de uma sessão poderia interferir em outra, principalmente em agentes com muitos arquivos, documentos ou conectores ativos.

### O que essa nova base permite para o futuro?

A migração também abre espaço para novas possibilidades dentro do Power Omni.

Entre elas, está o suporte a modelos além da família GPT, incluindo modelos como Claude, DeepSeek, Grok e outros modelos disponíveis no catálogo da Microsoft.

Também será possível evoluir o uso de ferramentas nativas, como busca na web em tempo real e interpretador de código, conforme esses recursos forem avaliados e integrados ao produto.

Outro caminho que essa nova base abre é a colaboração entre agentes. Isso permite criar fluxos em que um agente pode acionar outro, formando automações mais avançadas e especializadas.

Essas funcionalidades dependem da migração concluída e ainda podem passar por validação antes de serem liberadas no Power Omni.

### Como iniciar a migração?

O processo é simples.

Acesse a página Migração New Foundry e revise as informações exibidas.

Ao iniciar a migração, o Power Omni exibirá uma janela de confirmação chamada Confirmar início da migração.

Essa tela mostra o que ficará temporariamente bloqueado, o que será transferido e quais pontos exigem atenção antes de continuar.

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

Para prosseguir, clique em Confirmar e Iniciar.

Caso ainda não queira iniciar, clique em Cancelar.

### Funcionalidades bloqueadas durante o processo

Enquanto a migração estiver em andamento, algumas ações ficarão temporariamente indisponíveis no ambiente.

Durante esse período, não será possível criar, editar ou excluir agentes.

Também não será possível criar, editar ou excluir conectores dos tipos Document, OpenAPI, Fabric, N8N, Logic App e SharePoint.

O upload e a exclusão de arquivos também ficarão bloqueados até a migração ser concluída.

Esse bloqueio é temporário e serve para evitar alterações no ambiente enquanto os recursos estão sendo transferidos para a nova infraestrutura.

### Histórico de conversas

O histórico atual de conversas dos agentes não será transferido.

Isso significa que as threads e interações antigas não serão migradas para a nova infraestrutura.

Depois que a migração for concluída, as novas conversas começarão do zero.

Os agentes serão migrados, mas o histórico das conversas anteriores não será mantido.

### O que será transferido?

Os principais recursos do ambiente serão migrados automaticamente para a nova infraestrutura.

Serão transferidos:

* Agentes, incluindo configurações, instruções e system prompt.
* Conectores.
* Arquivos associados aos agentes.

Os arquivos serão reenviados para a nova plataforma durante a migração.

### Possíveis falhas parciais

Alguns conectores do tipo Documento podem falhar durante a migração.

Isso pode acontecer, por exemplo, quando um arquivo está corrompido, quando há limite de quota ou quando o reenvio para a nova infraestrutura não é concluído corretamente.

Nesses casos, o agente será criado sem o conector que apresentou problema.

Depois que a migração terminar, esse conector poderá ser recriado manualmente.

### Acompanhando o progresso

Após confirmar o início da migração, o Power Omni exibirá o status Migração em andamento.

Você poderá acompanhar o progresso pela tela de migração ou pelo botão Ver Progresso.

<figure><img src="/files/5q3eF0AD17f9twzXhJqL" alt=""><figcaption></figcaption></figure>

Enquanto o processo estiver em andamento, aguarde a conclusão antes de tentar alterar agentes, conectores ou arquivos.

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

### O que devo conferir após migrar?

Após concluir a migração, valide os seguintes pontos:

* Se o agente responde normalmente.
* Se os documentos conectados continuam sendo consultados.
* Se os conectores configurados continuam funcionando.
* Se as respostas estão coerentes com as instruções do agente.

Caso encontre qualquer comportamento diferente, entre em contato com o suporte do Power Omni.

### Preciso recriar meus agentes?

Não necessariamente.

A migração foi pensada para atualizar a infraestrutura que sustenta os agentes, sem exigir que o usuário reconstrua tudo do zero.

Mesmo assim, recomendamos revisar os agentes mais importantes depois da migração, principalmente aqueles que usam documentos, conectores ou instruções mais específicas.

### Posso continuar usando a versão antiga?

A versão antiga continuará disponível apenas durante o período de transição.

Como a Microsoft já definiu prazos para encerramento das tecnologias antigas, a recomendação é migrar o quanto antes para evitar interrupções futuras.

### Preciso de ajuda?

Se tiver qualquer dúvida durante o processo, entre em contato com o suporte do Power Omni.

Nossa equipe pode auxiliar na migração, revisar o ambiente e ajudar na validação dos agentes após a atualização.


# Visão Geral

O Portal de Administração é o seu centro de controle, acessível através do menu lateral esquerdo.

<figure><img src="/files/07GAkurHu9qnoiaufmZB" alt=""><figcaption></figcaption></figure>


# Monitoramento

A seção **Monitoramento** fornece uma visão geral em tempo real das **Métricas de Uso de Tokens** na sua organização. É a ferramenta principal para o administrador rastrear o consumo, auditar a atividade e gerenciar os custos da IA.

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

Você pode ajustar o período de análise **(Últimas 24h, Últimos 7 dias, Últimos 30 dias ou Mais Anterior)** no canto superior direito.

#### Visão Geral

A primeira linha do painel apresenta o resumo financeiro e de volume:

* **Total de Perguntas:** O volume total de interações processadas pela IA no período selecionado.
* **Custo Médio / Pergunta (USD):** O custo médio de tokens necessário para gerar uma resposta. Ajuda a entender a eficiência do uso dos Agentes.
* **Custo Total (USD):** O custo total de consumo de tokens (cobrado pela sua conta Azure) no período.

#### Métricas de Uso Detalhadas

Abaixo da visão geral, as métricas são segmentadas para permitir uma auditoria granular do consumo, garantindo total transparência e governança:

<table><thead><tr><th width="210">Tabela de Métrica</th><th width="301">Propósito</th><th>Campos Chave</th></tr></thead><tbody><tr><td><strong>Uso por Agente</strong></td><td>Mostra quais Agentes (assistentes de IA) estão sendo mais utilizados. Essencial para identificar os custos por área ou função específica.</td><td><strong>Agente</strong>, <strong>Perguntas</strong>, <strong>Custo por Pergunta</strong>, <strong>Valor Total</strong> (em USD)</td></tr><tr><td><strong>Usuário por Quantidade de Perguntas</strong></td><td>Identifica os usuários que estão gerando o maior volume de interações com a IA. Ajuda a monitorar a adoção e identificar usuários que precisam de treinamento adicional.</td><td><strong>Usuário</strong>, <strong>Total</strong> de Perguntas, <strong>Valor Total</strong> (em USD)</td></tr><tr><td><strong>Uso por Modelo</strong></td><td>Detalha a distribuição de uso entre os diferentes Modelos de IA cadastrados. Permite que o administrador tome decisões de custo, priorizando modelos mais eficientes.</td><td><strong>Modelo</strong>, <strong>Perguntas</strong>, <strong>Valor Total</strong> (em USD)</td></tr><tr><td><strong>Agente por Usuário</strong></td><td>Apresenta o cruzamento de dados, mostrando <strong>qual usuário</strong> está usando <strong>qual Agente</strong> e qual o <strong>custo específico</strong> dessa interação.</td><td><strong>Agente</strong>, <strong>Usuário</strong>, <strong>Perguntas</strong>, <strong>Custo/Pergunta</strong></td></tr></tbody></table>

{% hint style="info" %}

## <mark style="color:blue;">Governança e Custo</mark>

<mark style="color:blue;">**O painel de Monitoramento é sua ferramenta de governança. Ao auditar o Custo por Agente e o Uso por Modelo, você pode ajustar as configurações de Agentes e aplicar limites de uso para controlar o gasto total de tokens.**</mark>
{% endhint %}


# Artefatos

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Projetos</td><td><a href="/pages/ynK96yudUXXBnqfhM8Ss">/pages/ynK96yudUXXBnqfhM8Ss</a></td><td><a href="/files/bmB3eolp2r3jqX9onO9Q">/files/bmB3eolp2r3jqX9onO9Q</a></td></tr><tr><td align="center">Modelos</td><td><a href="/pages/lHwjJEF4BydYjekJTweH">/pages/lHwjJEF4BydYjekJTweH</a></td><td><a href="/files/FqThQ4mMig77r9eYHan6">/files/FqThQ4mMig77r9eYHan6</a></td></tr><tr><td align="center">Arquivos</td><td><a href="/pages/bQJYysriiVRythVpCQYW">/pages/bQJYysriiVRythVpCQYW</a></td><td><a href="/files/LV1Rd4C7H2Pbj62ONOxv">/files/LV1Rd4C7H2Pbj62ONOxv</a></td></tr><tr><td align="center">Agentes</td><td><a href="/pages/3jTwnabH5L4SW6DlnYXB">/pages/3jTwnabH5L4SW6DlnYXB</a></td><td><a href="/files/2jjjMCnKUa5VxhoUl7RP">/files/2jjjMCnKUa5VxhoUl7RP</a></td></tr><tr><td align="center">Conectores</td><td><a href="/pages/a5ZKmS6tbhODwaRw8UGR">/pages/a5ZKmS6tbhODwaRw8UGR</a></td><td><a href="/files/wWaI8PSKkblFITTr48x3">/files/wWaI8PSKkblFITTr48x3</a></td></tr></tbody></table>


# Projetos

O menu **Projetos** é o ponto de integração entre o Power Omni e o recurso do **Azure** na sua conta Microsoft Azure. O cadastro de um projeto é um pré-requisito técnico para habilitar o consumo de tokens e a gestão de modelos de IA na plataforma.

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

#### Como Cadastrar um Novo Projeto

Para adicionar um novo projeto no Power Omni, siga estes passos:

1. Acesse o menu **Artefatos > Projetos**.
2. Clique no botão **Criar Projeto** no canto superior direito.
3. Preencha os campos com as informações obtidas no seu ambiente Azure.

| Campo                        | Descrição                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------- |
| **Nome**                     | Nome de identificação interna do Projeto no Power Omni.                          |
| **Endpoint URL**             | O endereço da API do recurso Azure AI Foundry na sua conta Azure.                |
| **Nome do Grupo de Recurso** | O nome do Resource Group (Grupo de Recursos) onde o Azure AI Foundry foi criado. |
| **Nome do Azure AI Foundry** | O nome exato do recurso Azure AI Foundry criado no portal do Azure.              |
| **ID da Assinatura**         | O *ID Subscription* da sua conta Azure onde o recurso está hospedado.            |

#### Permissões de Acesso

{% hint style="info" %}
**Atenção:** Ao criar o recurso Azure AI Foundry, é obrigatório adicionar a permissão "**Azure AI User**" ao serviço principal do Power Omni. Sem essa permissão, a plataforma não conseguirá interagir com o seu recurso Azure e o consumo de tokens não será processado.
{% endhint %}


# Modelos

O menu **Modelos** permite que você cadastre os modelos de IA disponíveis no seu recurso **Azure** no Power Omni. Cadastrar um modelo aqui o torna elegível para ser utilizado pelos seus **Agentes** e permite o controle de custos e auditoria automatizados.

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

#### Visão Geral dos Modelos Cadastrados

A tabela principal apresenta os modelos que já foram configurados, fornecendo informações financeiras cruciais:

| Campo                     | Propósito                                                                                                                     |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                  | Nome de identificação do modelo (Ex: gpt-4o).                                                                                 |
| **Projeto**               | O Projeto (Azure) ao qual este modelo está vinculado.                                                                         |
| **Custo de Input (USD)**  | O custo de tokens para a **entrada** de dados (a pergunta do usuário e o contexto fornecido) é a parte mais comum do consumo. |
| **Custo de Output (USD)** | O custo de tokens para a **saída** de dados (a resposta gerada pela IA).                                                      |

#### Como Cadastrar um Novo Modelo

Para disponibilizar um novo modelo de IA para uso no Power Omni, clique no botão **Criar Modelo** no canto superior direito:

| Campo             | Descrição                                                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Modelos de IA** | Selecione na lista suspensa o modelo de IA que você deseja cadastrar.                                                                  |
| **Nome**          | Defina um nome curto e sem espaços para o modelo (máximo 64 caracteres). Este é o nome que aparecerá nas listas de seleção de Agentes. |
| **Projeto**       | Vincule este modelo a um dos **Projetos** (Azure) que você já cadastrou. O custo do modelo será cobrado através desta conta Azure.     |

{% hint style="info" %}

## **Controle e Otimização**

Ao cadastrar modelos com diferentes estruturas de custo, você pode otimizar seus gastos. Por exemplo, utilizar um modelo com Custo de Input mais baixo para Agentes de uso interno e alto volume de perguntas.
{% endhint %}


# Arquivos

O menu **Arquivos** é o repositório centralizado onde você armazena e organiza os documentos que serão usados como base de conhecimento pelos seus Agentes de IA. Este é o coração da funcionalidade, garantindo que a IA responda com informações internas e específicas da sua empresa.

<figure><img src="/files/4FE75caJ9LdI23IZDkzQ" alt=""><figcaption></figcaption></figure>

#### Propósito

Os documentos enviados aqui são processados exclusivamente pelos **Conectores "Leitor de Arquivos"** e só podem ser consultados por Agentes que tenham a devida permissão.

* **Governança:** A organização em pastas permite que você aplique permissões de acesso e restrições de segurança, garantindo que Agentes de um departamento não acessem documentos confidenciais de outro.
* **Conhecimento Contextual:** Permite que os Agentes respondam a perguntas complexas sobre políticas, contratos, manuais e dados internos, com base na sua documentação oficial.

#### Organização e Conteúdo

A tela de Arquivos exibe a estrutura de pastas e documentos, similar a um explorador de arquivos:

| Tipo de Item   | Descrição                                                                                                                                                 |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pastas**     | Usadas para organizar logicamente o conteúdo (Ex: `Area Administrativa`, `rh`, `G4`). As pastas são a principal forma de segregar o acesso por permissão. |
| **Documentos** | Os arquivos individuais (Ex: .doc, .pdf, .docx, .html, .java, .json…) que a IA irá ler e indexar.                                                         |

#### Como Gerenciar seus Arquivos

Você tem as seguintes ações disponíveis na tela:

* **Importar Arquivos:** Permite o *upload* de documentos de sua máquina para o repositório.
* **Nova Pasta:** Cria uma nova pasta para organizar o conteúdo e segmentar permissões.
* **Filtros, Selecionar Todos, Desmarcar Todos:** Ferramentas para gerenciamento de grandes volumes, facilitando a aplicação de ações em lote, como a exclusão de múltiplos arquivos.

{% hint style="info" %}

## **Próxima Etapa Essencial**

Após o upload dos documentos, você deve criar um Conector do tipo "**Leitor de Arquivos**" e vinculá-lo aos Agentes apropriados. Sem esse vínculo, o Agente não conseguirá acessar ou usar os documentos.
{% endhint %}


# Agentes

O menu **Agentes** é onde você cria, edita e configura os assistentes de IA do Power Omni.

Cada agente pode ter seu próprio nome, avatar, descrição, modelo de IA, esforço de raciocínio, instruções, conectores e permissões de acesso. Isso permite criar agentes específicos para diferentes áreas, como atendimento, financeiro, RH, jurídico, suporte técnico, busca na web ou análise de documentos.

### Tela principal de agentes

A tela principal exibe todos os agentes configurados no ambiente.

Nessa tela, é possível acompanhar as principais informações de cada agente, como modelo utilizado, orçamento, valor consumido e ações disponíveis.

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

<table><thead><tr><th width="207">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td>Nome</td><td>Nome do agente exibido para os usuários.</td></tr><tr><td>Modelo</td><td>Modelo de IA utilizado pelo agente.</td></tr><tr><td>Orçamento</td><td>Valor de orçamento configurado para o agente. Quando não houver orçamento definido, será exibido “-”.</td></tr><tr><td>Uso</td><td>Valor consumido pelo agente até o momento.</td></tr><tr><td>Ações</td><td>Opções para editar, excluir ou acessar configurações adicionais do agente.</td></tr></tbody></table>

Essa visão ajuda os administradores a acompanhar quais agentes estão ativos, quais modelos estão sendo usados e quanto cada agente já consumiu.

### Como criar ou editar um agente

Para criar um novo agente, clique em **Criar**.

Para editar um agente existente, clique no ícone de edição na linha do agente desejado.

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

Ao abrir o formulário lateral, você poderá configurar as informações principais do agente.

#### Avatar do agente

O avatar é a imagem que representa o agente dentro do Power Omni.

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

Ele ajuda os usuários a identificarem visualmente cada agente, principalmente quando existem vários agentes disponíveis no ambiente.

O Power Omni permite configurar o avatar de duas formas:

No **Avatar personalizado**, você pode enviar uma imagem própria para o agente. A imagem deve ter exatamente **150x150 pixels** e estar no formato **PNG ou SVG**.

No **Avatar da biblioteca**, você pode selecionar uma imagem já disponível na biblioteca do Power Omni.

#### Nome do agente

O campo **Nome** define como o agente será exibido para os usuários.

Use nomes simples e claros, que indiquem a finalidade do agente.

#### Descrição do agente

O campo **Descrição do Agente** é opcional, mas recomendado.

Ele ajuda os usuários a entenderem para que aquele agente serve antes de iniciar uma conversa.

#### Modelo

O campo **Modelo** define qual modelo de IA será usado pelo agente.

Modelos diferentes podem ter capacidades, desempenho e custos diferentes. Escolha o modelo de acordo com o objetivo do agente.

Um agente simples de dúvidas frequentes pode usar um modelo mais leve. Já um agente que precisa analisar documentos, interpretar informações ou responder perguntas mais complexas pode usar um modelo mais avançado.

#### Esforço de raciocínio padrão

O campo **Esforço de raciocínio padrão** define o nível de raciocínio que o agente deverá usar por padrão nas respostas.

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

Essa configuração permite ajustar se o agente deve responder de forma mais direta ou se deve pensar mais antes de responder.

As opções disponíveis são: Nenhum / Baixo / Médio / Alto

Use **Nenhum** ou **Baixo** para agentes mais simples, que precisam responder de forma rápida e direta.

Use **Médio** para a maioria dos agentes, quando é necessário equilibrar qualidade da resposta e tempo de execução.

Use **Alto** para agentes que precisam analisar melhor o contexto, comparar informações, interpretar documentos ou responder perguntas mais complexas.

Quanto maior o esforço de raciocínio, maior tende a ser a profundidade da resposta. Em alguns casos, isso também pode impactar o tempo de resposta e o consumo do modelo.

#### Instruções do agente

O campo **Instruções** define o comportamento do agente.

É nesse campo que você informa o papel do agente, como ele deve responder, quais tarefas deve executar e quais limites deve respeitar.

Exemplo:

Você é um agente inteligente responsável por buscar e recuperar, na internet, as solicitações feitas pelo usuário, organizando os resultados de forma clara, objetiva e útil.

As instruções devem ser claras e diretas. Quanto melhor forem as instruções, maior a chance do agente responder da forma esperada.

#### Melhorar com IA

O botão **Melhorar com IA** ajuda a ajustar o texto das instruções.

Use essa opção quando quiser transformar uma ideia simples em uma instrução mais completa e organizada.

Depois de usar a melhoria com IA, revise o texto antes de salvar.

O botão **Expandir** abre o campo de instruções em uma área maior.

### Conectores

Os conectores permitem que o agente acesse documentos, sistemas, páginas da internet ou ferramentas externas.

Exemplos:

Use conectores de documentos quando o agente precisar consultar arquivos internos.

Use Leitor de URL quando o agente precisar analisar páginas informadas por link.

Use Busca na Web quando o agente precisar consultar informações atualizadas na internet.

Use conectores como OpenAPI, Logic App, N8N, Fabric, SharePoint ou MCP quando o agente precisar se integrar a sistemas externos.

Habilite apenas os conectores necessários para o objetivo do agente.

### Permissões

As permissões definem quais usuários ou grupos poderão visualizar e interagir com o agente.

Essa configuração ajuda a organizar o acesso por área, time ou função.

Exemplos:

Um agente de RH pode ser liberado apenas para o time de Recursos Humanos.

Um agente financeiro pode ser liberado apenas para usuários da área financeira.

Um agente de atendimento geral pode ser liberado para todos os usuários.

{% hint style="info" %} <mark style="color:$tint;">Revise as permissões antes de disponibilizar o agente para uso.</mark>
{% endhint %}

### Boas práticas

Use nomes claros para os agentes.

Adicione uma descrição curta para explicar a finalidade do agente.

Configure um avatar para facilitar a identificação visual.

Escolha o modelo de acordo com a complexidade da tarefa.

Ajuste o esforço de raciocínio conforme o tipo de resposta esperada.

Escreva instruções objetivas.

Habilite apenas os conectores necessários.

Acompanhe o campo **Uso** para entender o consumo de cada agente.

Teste o agente com perguntas reais antes de liberar para os usuários.

### Salvando o agente

Após preencher as informações, clique em **Salvar**.

Depois de salvar, recomendamos testar o agente no chat para validar nome, avatar, descrição, modelo, esforço de raciocínio, instruções, conectores e permissões.

### Precisa de ajuda?

{% hint style="info" %} <mark style="color:$primary;">Se tiver dúvidas sobre criação de agentes, escolha de modelo, esforço de raciocínio, instruções, conectores, orçamento ou consumo, entre em contato com o suporte do Power Omni.</mark>
{% endhint %}


# Conectores

O menu **Conectores** é a área de configuração de todas as fontes de dados e capacidades de integração que seus Agentes utilizarão.

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

#### Visão Geral

A tabela principal lista todos os Conectores configurados, separados por **Tipo**:

<table><thead><tr><th width="154">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Tipo</strong></td><td>Identifica a função do Conector: <strong>Leitor de Arquivos</strong>, <strong>Conector de OpenAPI</strong> (Sistemas Externos) ou <strong>Conector de Fabric</strong> (Microsoft Fabric/Power BI) e etc.</td></tr><tr><td><strong>Nome</strong></td><td>Nome de identificação interna do Conector.</td></tr></tbody></table>

#### Tipos de Conectores e Como Criar

Clique no botão **Criar** para configurar um novo Conector. Você deve selecionar o **Tipo de Conector** no dropdown lateral:

{% hint style="info" %}
Uso no Agente: Após a criação, o Conector deve ser vinculado ao Agente em Artefatos > Agentes.&#x20;

O Agente usará o Conector automaticamente quando a consulta do usuário exigir o tipo de dado que o Conector fornece.
{% endhint %}


# Conectores Padrões

Os Conectores Padrões são ferramentas nativas que podem ser habilitadas diretamente na configuração do agente.

Eles permitem que o agente execute ações simples e úteis durante uma conversa, como consultar a data atual, ler uma página da internet, analisar arquivos enviados pelo usuário ou buscar informações atualizadas na web.

Para ativar um conector padrão, acesse a configuração do agente e marque os conectores que deseja disponibilizar.

### Conectores disponíveis

Atualmente, o Power Omni possui os seguintes conectores padrões:

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

1. Data e Hora
2. Leitor de URL
3. Manipulador de Arquivos
4. Busca na Web

Cada conector adiciona uma capacidade específica ao agente. O ideal é habilitar apenas os conectores que fazem sentido para o uso daquele agente.

### Quando habilitar cada conector?

Use o Data e Hora quando o agente precisar lidar com datas, prazos, vencimentos ou cálculos simples de tempo.

Use o Leitor de URL quando o agente precisar analisar uma página informada pelo usuário.

Use o Manipulador de Arquivos quando o agente precisar trabalhar com arquivos, planilhas, documentos, gráficos ou análises de dados.

Use a Busca na Web quando o agente precisar consultar informações atuais na internet.

### Boas práticas

Habilite apenas os conectores necessários para o objetivo do agente.

Evite habilitar Busca na Web em agentes que trabalham com informações confidenciais, a menos que isso tenha sido validado internamente.

Use o Manipulador de Arquivos para análises com arquivos enviados pelo usuário, principalmente planilhas, relatórios e bases de dados.

Teste o agente após ativar qualquer conector, fazendo perguntas reais do dia a dia da operação.

### Precisa de ajuda?

Se tiver qualquer dúvida sobre qual conector ativar, custos, privacidade, região dos dados ou comportamento do agente, entre em contato com o suporte do Power Omni.


# Data e Hora

O conector Data e Hora permite que o agente consulte informações relacionadas à data e ao horário atual.

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

Ele pode ser usado para responder perguntas como:

* Qual é a data de hoje?
* Que dia da semana será uma determinada data?
* Quanto tempo falta até determinado prazo?
* Qual foi a data de X dias atrás?
* Qual será a data daqui a X dias?

Esse conector é útil para agentes que precisam lidar com prazos, vencimentos, agendamentos, rotinas internas ou respostas que dependem da data atual.


# Leitor de URL

O conector Leitor de URL permite que o agente acesse e leia o conteúdo de uma página informada por link.

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

Ele pode ser usado para analisar uma página pública, resumir um conteúdo, interpretar informações de um site ou usar uma URL como referência dentro da resposta.

Exemplos de uso:

* Resumir uma página enviada pelo usuário.
* Extrair os principais pontos de um artigo.
* Analisar o conteúdo de uma landing page.
* Comparar informações de uma página com o contexto da conversa.

O Leitor de URL depende do acesso ao conteúdo da página. Links protegidos por login, páginas privadas, conteúdos bloqueados ou URLs indisponíveis podem não ser lidos corretamente.


# Manipulador de Arquivos

O Manipulador de Arquivos permite que o agente trabalhe com arquivos enviados durante a conversa.

<figure><img src="/files/7YMqC4MIHs3gofbWjwwt" alt=""><figcaption></figcaption></figure>

Na infraestrutura Microsoft, essa capacidade é baseada no Code Interpreter, uma ferramenta que permite ao agente executar código Python em um ambiente isolado para analisar dados, gerar gráficos, resolver cálculos e criar arquivos de saída.&#x20;

Com esse conector, o agente pode receber arquivos e executar análises mais avançadas.

Exemplos de uso:

* Analisar planilhas.
* Ler arquivos CSV ou XLSX.
* Gerar gráficos a partir de dados.
* Identificar padrões em uma base.

A Microsoft informa suporte a diversos tipos de arquivos, incluindo CSV, DOCX, PDF, PPTX, XLSX, TXT, JSON, imagens, ZIP e outros formatos.

#### Custos do Manipulador de Arquivos

O uso do Code Interpreter possui cobrança adicional além dos custos de tokens do modelo de IA. A Microsoft informa que, se o agente acionar o Code Interpreter em conversas diferentes ao mesmo tempo, serão criadas sessões separadas, e cada sessão poderá ser cobrada individualmente.

Na página de preços do Foundry Agent Service, a Microsoft lista o Code Interpreter como ferramenta cobrada por sessão, com referência de US$ 0,033 por sessão.

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


# Busca na Web

O conector Busca na Web permite que o agente pesquise informações atualizadas na internet antes de gerar uma resposta.

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

Na infraestrutura Microsoft, essa capacidade usa o Web Search Tool do Foundry. Essa ferramenta permite que o modelo busque informações em tempo real na web pública e gere respostas com base nessas fontes, incluindo citações quando disponíveis.

Esse conector é útil quando o agente precisa responder sobre informações que podem mudar com frequência.

Exemplos de uso:

* Notícias recentes.
* Informações públicas atualizadas.
* Consulta de páginas indexadas na web.
* Validação de dados atuais.
* Pesquisa sobre empresas, produtos, eventos ou documentações públicas.

#### Pontos importantes sobre dados e região

{% hint style="danger" %}

#### <mark style="color:red;">A Microsoft informa que os dados enviados para esses recursos podem trafegar fora dos limites geográficos e de conformidade do Azure.</mark>

{% endhint %}

A Microsoft detalha que as informações enviadas ao Bing incluem a consulta de busca, parâmetros da ferramenta e a chave do recurso, usada para cobrança e controle de limite. A consulta enviada para o Bing é transferida para fora da fronteira de conformidade do Azure.

Por esse motivo, recomendamos atenção ao habilitar esse conector em agentes que lidam com dados sensíveis, informações internas, dados pessoais, conteúdo confidencial ou documentos estratégicos da empresa.

{% hint style="info" %}
Em caso de dúvida, valide o uso com o responsável de segurança, privacidade ou compliance da sua organização.
{% endhint %}

#### Custos da Busca na Web

O uso da Busca na Web pode gerar custos adicionais. A Microsoft informa que o Web Search usa Grounding with Bing Search e que esse recurso possui cobrança própria.

Na página de preços da Microsoft para Grounding with Bing, o valor apresentado é de US$ 14 por 1.000 transações para Grounding with Bing Search.

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

A Microsoft também informa que as transações são contabilizadas pelo número de chamadas da ferramenta durante a execução. Ou seja, uma única pergunta do usuário pode gerar mais de uma chamada de busca, dependendo da necessidade do agente.


# Leitor de Arquivos

Os Conectores de Arquivos permitem estruturar e gerenciar os conjuntos de documentos que servirão como base de conhecimento (fonte RAG) para que o Agente de IA responda de forma contextual e precisa às solicitações dos usuários.

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

### 1. Visão Geral do Fluxo

O processo para liberar o acesso a documentos por um Agente segue três etapas:

1. Upload: Adicionar os arquivos na área de Artefatos > Arquivos.
2. Conector: Criar o Conector para agrupar os arquivos relevantes.
3. Relacionamento: Associar esse Conector ao Agente de IA específico.

### 2. Passo a Passo: Criação do Conector de Arquivos

A criação do Conector ocorre no Portal de Administração.

#### 2.1 Acessando a Área de Conectores

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

1. No Portal de Administração (Artefatos), navegue até a opção Conectores.
2. Clique em "Adicionar Conector" ou no botão de criação (geralmente um ícone "+").
3. Selecione o tipo de conector: "Conector de Arquivos".

#### 2.2 Configurando o Conector

Preencha os campos obrigatórios para nomear e selecionar os documentos que farão parte deste conjunto.

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

* Nome do Conector: Insira um nome claro e descritivo que identifique o conjunto de arquivos (Ex: "Regras Internas RH", "Documentação do Produto X").
* Projeto: Selecione um projeto para o seu conector.

#### 2.3 Seleção dos Arquivos

<figure><img src="/files/9xHRpiI5prwuq20Jrcnx" alt=""><figcaption></figcaption></figure>

Na seção de seleção de arquivos, você encontrará uma lista de todas pastas e documentos que foram previamente carregados na área Artefatos > Arquivos.

1. Localize e selecione os arquivos desejados que devem compor este Conector. Você pode filtrar por pasta ou usar a barra de pesquisa para encontrar documentos específicos.

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

2. Todos os arquivos selecionados serão agrupados.

#### 2.4 Finalização

1. Revise as configurações e os arquivos selecionados.

<figure><img src="/files/31URmX5ChKBfc2fKhOac" alt=""><figcaption></figcaption></figure>

2. Clique em "Salvar" para finalizar a criação do Conector de Arquivos.

> <mark style="color:$warning;">Nota: A criação do Conector não concede automaticamente permissão ao Agente. O Agente ainda precisa ser explicitamente associado a este Conector.</mark>

### 3. Passo Final: Relacionando o Conector ao Agente

Esta é a etapa crucial de governança, onde você define quais agentes podem acessar o novo conjunto de documentos.

1. Acesse a seção de Artefatos > Agentes no Portal de Administração.

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

2. Encontre ou crie o Agente de IA desejado e clique no icone de relacionamentos.

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

3. Selecione Conectores.
4. Na lista de Conectores disponíveis, localize o Conector de Arquivos que você acabou de criar (Ex: "Regras Internas RH").

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

5. Adicione ou selecione o Conector para associá-lo ao Agente.
6. Clique em "Salvar" para aplicar as alterações na configuração do Agente.

{% hint style="info" %} <mark style="color:$danger;">É importante ajustar as instruções do agente de IA para que ele saiba que existem arquivos disponíveis para consulta e os utilize como base durante as respostas.</mark>
{% endhint %}

#### ✅ Resultado Esperado

Somente após esta etapa final, quando um usuário interagir com o Agente, o modelo de IA terá permissão para buscar informações e gerar respostas utilizando exclusivamente os arquivos contidos neste Conector e em quaisquer outros Conectores relacionados.


# OpenAPI

O conector de OpenAPI permite integrar o Power Omni a qualquer (API) que siga o padrão OpenAPI. Através dele, a IA deixa de apenas "conversar" e passa a "executar tarefas" em sistemas externos.

### Criação e Identificação do Conector

A criação do Conector ocorre no Portal de Administração (Artefatos > Conectores).

* Clique em "Criar" e selecione o tipo "Conector OpenAPI".

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

<figure><img src="/files/7S5hlbGdHKjLkGckoIDv" alt=""><figcaption></figcaption></figure>

* Selecione o Projeto do seu Power Omni.
* Nome: Identificador interno para gestão no painel. Use nomes claros como "API de Gestão de Estoque" ou "Integração CRM".
* Descrição: Este campo é lido pela Inteligência Artificial. Descreva detalhadamente o que este conector faz.
  * *Dica: Quanto melhor a descrição, mais assertiva será a IA ao decidir usar esta ferramenta durante uma conversa.*

***

### Autenticação (Segurança)

Para que o Power Omni acesse dados externos, ele precisa se identificar com segurança perante a API de destino.

* Tipo de Autenticação:

  * Anonymous (Sem Autenticação): Usado apenas para APIs que não exigem chaves de acesso.

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

  * API Key: Você define o (Header) — geralmente `X-API-KEY` ou `Authorization` — e insere o valor da chave.

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

  <figure><img src="/files/IcCwajsfhNnzjkIg4wMw" alt=""><figcaption></figcaption></figure>
* **Importar conexão existente**: Utilize esta opção caso já tenha criado a conexão em outro momento e deseje reutilizá-la.

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

* **Criar Nova Conexão**: Utilize caso seja a primeira vez configurando a API.&#x20;

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

***

### Definição do Schema (OpenAPI)

O Schema é o mapa técnico da API. Ele diz à IA quais "portas" (endpoints) estão abertas, quais informações ela deve enviar e o que ela receberá de volta.

#### Método de Importação Automático (Via URL)

* URL de Especificação: Neste campo, você insere o link direto para o arquivo de especificação da API (Ex: `https://api.suaempresa.com/v1/swagger.json`).
* Botão Buscar Especificação: Ao clicar neste botão, o Power Omni busca a especificação OpenAPI automaticamente.

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

#### Método de Importação Manual

* Como usar: Você deve copiar o conteúdo da sua especificação OpenAPI e colá-lo diretamente no editor.
* Editor de Schema (JSON): Espaço para colar o código da especificação OpenAPI.

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

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

* Endpoints e Métodos: O schema deve detalhar os métodos suportados, como:
  * `GET`: Para buscar informações.
  * `POST`: Para criar novos registros.
  * `PUT/PATCH`: Para atualizar dados existentes.
* Parâmetros de Entrada: Define quais dados a IA deve extrair da conversa com o usuário para preencher a requisição (Ex: `id_pedido`, `cpf_cliente`).
* Validação: O sistema validará a estrutura do JSON para garantir que o formato está seguindo os padrões mundiais da OpenAPI 3.0.

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

***

### Validação&#x20;

Após configurar a estrutura e a segurança, o conector precisa ser registrado para ficar disponível para os Agentes.

* O sistema realiza uma verificação final de sintaxe no Schema. Se houver erros de formatação no JSON, o sistema indicará a linha do erro para correção.
* Clique em <img src="/files/WY6VwbLnQEtgwCn17H6E" alt="" data-size="line">.

### Passo Final: Relacionando o Conector ao Agente

O Agente só terá acesso às funções da API após o relacionamento.

* Acesse a seção de Artefatos > Agentes no Portal de Administração.
* Selecione o Agente de IA que precisa interagir com a API.
* Navegue até a aba ou seção de Relacionamentos > *Conectores*.
* Na lista de Conectores disponíveis, localize o Conector OpenAPI recém-criado.
* Associe o Conector ao Agente.
* Clique em "Salvar" para aplicar as alterações.

***

### ✅ Boas Práticas e Governança

* Ao gerar uma API Key no seu sistema externo, dê permissão apenas para os métodos necessários. Ex: Se a IA só precisa consultar dados, não forneça uma chave com permissão de exclusão (`DELETE`).
* Tratamento de Erros: Certifique-se de que sua API externa retorne mensagens de erro claras (Ex: "Pedido não encontrado"). A IA lerá essa mensagem e poderá explicar ao usuário final o que aconteceu.
* Documentação Atualizada: Sempre que a sua API externa mudar (adicionar um novo campo obrigatório, por exemplo), lembre-se de atualizar o Schema nesta tela para evitar falhas na integração.


# Microsoft Fabric

O Conector Microsoft Fabric permitem que seus Agentes de IA consultem e analisem dados estruturados em tempo real (Lakehouses, Warehouses e Modelos Semânticos do Power BI).

{% hint style="warning" %}

#### **IMPORTANTE**

\
**Antes de configurar o conector Microsoft Fabric, conclua as etapas da documentação** \
[**Permissão Foundry User**](https://docs.poweromni.ai/permissao-foundry-user)**.**\
**Essa permissão é necessária para que os usuários possam utilizar o agente do Fabric pelo Power Omni.**
{% endhint %}

### Pré-requisitos <a href="#prerequisites" id="prerequisites"></a>

* Uma capacidade paga do F2 ou superior do Fabric ou uma capacidade do Power BI Premium por capacidade (P1 ou superior) com o Microsoft Fabric habilitado
* As [Configurações de locatário do agente de dados do Fabric](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) estão habilitadas.
* O [Processamento entre áreas geográficas de IA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) está habilitado.
* O [Armazenamento entre áreas geográficas de IA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#habilitar-as-configuracoes-de-servicos-de-ia-copilot-e-azure-openai) está habilitado.
* Pelo menos um destes, com dados: um armazém, um lakehouse, um ou mais modelos semânticos do Power BI, um banco de dados KQL ou uma ontologia.
* Os [Modelos semânticos do Power BI pela opção de locatário dos pontos de extremidade XMLA](https://docs.poweromni.ai/portal-de-administracao-e-configuracoes/artefatos/conectores/microsoft-fabric#enable-integration-of-power-bi-semantic-models-via-xmla-endpoints) estão habilitados para as fontes de dados do modelo semântico do Power BI.
* Permissão Foundry user nos usuários que vão utilizar o agente. [**Permissão Foundry User**](https://docs.poweromni.ai/permissao-foundry-user)**.**

### Parte 1: Pré-requisitos de Permissão no Microsoft Fabric

Para que o recurso de Agente de Dados do Fabric funcione e possa ser consumido pelo Power Omni, um administrador deve habilitar as seguintes configurações do Microsoft Fabric.

> 1. **Entrar no Microsoft Fabric** com uma conta de administrador.
> 2. **Abra o portal de administração**:
>    * Selecione o ícone de engrenagem no canto superior direito.
>    * Selecione **Portal de Administração**.
> 3. **Navegar até as Configurações de Locatário**:
>    * No Portal de Administração, selecione **Configurações de Locatário** no painel de navegação à esquerda.

* ### Habilitar as Configurações de Serviços de IA (Copilot e Azure OpenAI)

Esta configuração é essencial para que os recursos de IA, incluindo o Agente de Dados, funcionem corretamente.

1. **Usuários podem usar o Copilot e outros recursos do Azure OpenAI**

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

2. **Os dados enviados ao OpenAI do Azure podem ser processados fora da sua região geográfica da capacidade, do limite de conformidade ou da instância de nuvem nacional**

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

3. **Dados enviados para o Azure OpenAI podem ser armazenados fora da região geográfica da capacidade, do limite de conformidade ou da instância de nuvem nacional**

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

* ### Habilitar as configurações de locatário do agente de dados do Fabric <a href="#enable-fabric-data-agent-tenant-settings" id="enable-fabric-data-agent-tenant-settings"></a>

Por padrão, este recurso está desativado no nível do *tenant* e deve ser ativado para permitir que os usuários criem e compartilhem itens de Agente de Dados do Fabric.

1. **Os usuários podem criar e compartilhar tipos de item do Agente de dados**

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

* ### Habilitar a integração de modelos semânticos do Power BI por meio de pontos de extremidade XMLA <a href="#enable-integration-of-power-bi-semantic-models-via-xmla-endpoints" id="enable-integration-of-power-bi-semantic-models-via-xmla-endpoints"></a>

Se sua organização armazena dados em diferentes regiões geográficas, as configurações de processamento e armazenamento geográfico cruzado para IA devem estar habilitadas para garantir o acesso aos dados.

1. **Permitir pontos de extremidade XMLA e análise no Excel com modelos semânticos locais**

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

{% hint style="danger" %} <mark style="color:$danger;">Importante: Pode levar até uma hora para que as alterações entrem em vigor.</mark>
{% endhint %}

### Parte 2: Criação do Agente de Dados no Microsoft Fabric

O Agente de Dados do Fabric é o item que atua como um sistema de perguntas e respostas conversacionais para seus dados.

#### 2.1 Criando o Item

1. No seu Workspace do Fabric, clique em "+ Novo item" e procure por "Agente de Dados" (*Data Agent*).

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

2. Dê um nome ao seu agente (Ex: "Agente de Vendas e Faturamento").

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

#### 2.2 Configurando as Fontes de Dados

1. Adicionar Fontes: No Agente de Dados, selecione a opção para adicionar fontes de dados. Você pode adicionar até cinco fontes de dados no total, em qualquer combinação dos tipos suportados.

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

2. Escolha: Selecione uma ou mais fontes, como um *Lakehouse* ou um *Modelo Semântico* do Power BI.

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

3. Após adicionar as fontes, o Explorer no painel esquerdo é preenchido com as tabelas disponíveis.
   * Use as caixas de seleção para tornar as tabelas disponíveis para a IA.
   * Dica Essencial: Use nomes descritivos para tabelas e colunas (Ex: `DadosDeVendas` é melhor que `TabelaA`). Isso ajuda a IA a gerar consultas mais precisas.

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

{% hint style="info" %}
&#x20;<mark style="color:purple;">Observação</mark>

<mark style="color:purple;">Você só precisa da permissão de Leitura para adicionar um modelo semântico do Power BI como uma fonte de dados. A permissão de gravação não é necessária porque o agente de dados do Fabric emite consultas somente leitura.</mark>
{% endhint %}

#### 2.3 Refinamento Comportamental do Agente

1. Fornecer Instruções:

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

* Selecione Instruções do Agente de Dados para abrir o painel de configuração.
* Você pode escrever até 15.000 caracteres de texto em inglês para guiar o comportamento da IA.
* Exemplos de Uso: Você pode especificar a fonte de dados exata a ser usada para determinados tipos de perguntas. Exemplos de opções de fonte de dados podem envolver a orientação da IA a ser usada

  * Modelos semânticos do Power BI para consultas financeiras
  * um lakehouse para dados de vendas
  * um banco de dados KQL para métricas operacionais

  Essas instruções garantem que a IA gere consultas apropriadas, seja SQL, DAX ou KQL, com base em suas diretrizes e no contexto das perguntas.
* Teste o desempenho do agente

<p align="center"> <img src="/files/vyYsE46CfLYQAvQ7ESAL" alt=""></p>

2. Publicação:

   * Após testar e validar o desempenho, selecione Publicar.

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

   * A publicação cria uma versão publicada (para compartilhamento e consumo) e mantém uma versão de rascunho (para refinamento).

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

   * Descrição: Fornece contexto quando o agente aparece em outras experiências. A descrição é usada por outros sistemas orquestradores de IA (como o Power Omni) para invocar o agente corretamente.

   <figure><img src="/files/4rXPTTMidNMBjbDxaCTR" alt=""><figcaption></figcaption></figure>

* Após o agente de dados ser publicado, clique em Exibir detalhes da publicação

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

* Irá aparecer a URL publicada, copie a URL ela será usada para fazermos a conexão dentro do Power Omni.

### Parte 3: Configuração do Conector no Power Omni

O Power Omni irá consumir o Agente de Dados do Fabric que você acabou de criar.

#### 3.1 Criação do Conector Fabric

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

1. Acesse o Portal de Administração do Power Omni e navegue até Conectores.
2. Clique em "Adicionar Conector" e selecione o tipo "Conector Microsoft Fabric". ![](/files/tLzdpfVgVxxdBsJfFGnM)
3. Preencha as informações:

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

* Selecione o projeto.
* Nome do Conector: Nome interno para identificação (Ex: "Análise de Vendas").
* Descrição da Ferramenta: Descreva a função do conector para o Agente de IA (Ex: "Use esta ferramenta para consultar métricas de vendas, faturamento e estoque em tempo real.").

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

* Em configuração de conexão: Seleciona criar Nova conexão.
* Preencha um nome para a Conexão, pois caso queira utilizar posteriormente a mesma conexão em outro conector é só Importar Conexão Existente utilizando o nome dela.
* E cole a URL que foi copiada dentro do Fabric na opção de URL do Fabric Data Agent, onde ele irá identificar automáticamente o  Workspace ID e Artifact ID.
* Clique em "Salvar".

#### 3.2 Relacionamento do Conector ao Agente

O último passo é dar a permissão de uso do novo conector ao seu Agente de IA.

1. Acesse Artefatos > Agentes no Portal de Administração.

<div align="left"><figure><img src="/files/yVp4YD1cjhig2rx7uv01" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0pTQ6y6wABVJw0HQwr1l" alt=""><figcaption></figcaption></figure></div>

2. Selecione o Agente de IA que fará perguntas ao Fabric.
3. Navegue até a aba Relacionamentos > *Conectores*.
4. Localize e adicione o Conector do Microsoft Fabric recém-criado.

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

5. Clique em "Salvar".
6. Lembre-se também de dar permissão ao um usuário, grupo ou workspace para visualizar aquele agente!

#### ✅ Resultado Final

O Agente de IA está agora conectado ao seu ambiente de dados. Quando um usuário perguntar, por exemplo, "Qual foi o faturamento total no último trimestre?", o Agente irá:

1. Reconhecer a intenção (baseado na "Descrição da Ferramenta").
2. Chamar o Agente de Dados do Fabric.
3. O Agente do Fabric traduzirá a pergunta em SQL/DAX/KQL.
4. O Agente receberá os dados do Fabric e os formatará como uma resposta em linguagem natural para o usuário.

> <mark style="color:purple;">Qualquer duvida em relação ao procedimento de integração do Microsoft Fabric, entre em contato com o</mark> [<mark style="color:purple;">Suporte</mark>](/suporte)<mark style="color:purple;">.</mark>


# Logic Apps

Esta documentação detalha como criar um fluxo no Azure Logic Apps e utilizá-lo como um conector no Power Omni, permitindo que os Agentes de IA executem ações em sistemas externos (ex: APIs, bancos de dados, ERPs).

### 1. Habilitar permissão no Azure

Antes de criar o Logic App, é obrigatório atribuir a permissão correta ao Power Omni no nível da sua Assinatura do Azure (Subscription).

1. Acesse o [Portal do Azure](https://portal.azure.com/) e faça login.&#x20;
2. No campo de busca, pesquise por "Assinaturas" (*Subscriptions*).

   <figure><img src="/files/Pz7vV1kHrsC0gnPhIhSO" alt=""><figcaption></figcaption></figure>
3. Selecione a assinatura onde está instalado o Power omni.

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

4. Clique em IAM (Controle de acesso) após isso clique em Adicionar > Adicionar atribuição de função

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

5. Pesquise por Aplicativo Lógico (Logic App) e selecione a Colaborador de Aplicativo Lógico (Logic App Contributor)  e clique em Próximo.

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

6. Na próxima tela (Membros), clique em "+ Selecionar membros".

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

7. Procure por Power Omni, após encontrar pode selecionar e avançar

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

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

* Clique em "Examinar + Atribuir" para finalizar a atribuição da função.

Pronto! Após realizar a atribuição de função, você já pode seguir para a criação do Logic App.

### 2. Configuração do Logic App no Azure

O Logic App funcionará como a ponte que recebe a solicitação do Power Omni e executa a lógica de negócios desejada.

#### 2.1 Criação do Recurso Logic App

1. Acessar o Azure: [Portal do Azure](https://portal.azure.com/).
2. Pesquise por "Logic Apps" e clique em "Criar".

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

3. Configuração: Na tela de criação, utilize as seguintes configurações:

* Tipo de Plano: Selecione a opção "Consumo" (Multilocatário).

<figure><img src="/files/3RTdqaUm4J00jCj0QUXH" alt=""><figcaption></figcaption></figure>

* <mark style="color:$danger;">É importante que o Logic App seja criado no MESMO Grupo de Recursos (Resource Group) onde os recursos do Azure AI Foundry (e o próprio Power Omni) foram instalados e na mesma região.</mark>

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

* Após preencher é só clicar em Revisar + Criar e posteriormente clicar em criar.
* Só aguardar a implantação.

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

* Após a implantação, clique em Ir para o recurso.

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

#### 2.2 Design do Fluxo (Workflow)

Após a criação do Logic App, você deve desenhar o fluxo de trabalho no *Logic App Designer,* Clique em ferramentas de Desenvolvimento>Designer do aplicativo lógico

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

1. Gatilho (Trigger): O fluxo deve obrigatoriamente começar com o gatilho "When an HTTP request is received" (Quando uma solicitação HTTP é recebida).

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

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

2. Método: Nas configurações do gatilho HTTP, defina o Método (Method) como "Allow all methods".

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

3. Schema: Para garantir que o Power Omni possa enviar dados estruturados ao Logic App, é necessário definir o schema JSON. Este schema define quais parâmetros o Agente de IA pode enviar para o Logic App.
4. Ações: Adicione as ações necessárias (ex: conectar-se a um sistema via API, enviar e-mail, buscar dados, etc.).

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

5. Resposta (Response): O fluxo deve obrigatoriamente terminar com a ação "Response" (Resposta), que enviará o resultado da execução de volta ao Power Omni.

<figure><img src="/files/7k4d2HVMnniVG0OjcbkH" alt=""><figcaption></figcaption></figure>

6. Após o fluxo estar criado, pode clicar em salvar.

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

### 3. Configuração do Conector no Power Omni

Após o Logic App estar criado, o Power Omni irá identificá-lo automaticamente na listagem dentro do conector.

#### 2.1 Criação do Conector

1. Acesse a Área de Administração do Power Omni.
2. Navegue até a seção de Artefatos > Conectores.
3. O Power Omni fará a listagem dos Logic Apps que estão no mesmo Grupo de Recursos. Localize e selecione o Logic App desejado.

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

4. Preencha as informações do Conector:

* Nome do Conector: Dê um nome descritivo para o conector (ex: "Consulta de Estoque ERP").
* Descrição: Defina o texto que o Agente de IA usará para reconhecer e acionar este conector (ex: "consultar\_estoque", "verificar\_API").

5. Configuração de Conexão.

* Criar nova Conexão, Se for a primeira vez utilizando esse Logic App, basta informar um nome para criar a conexão.
* Caso a conexão já tenha sido criada anteriormente, clique em **“Importar Conexão Existente”** e informe o nome da conexão.

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

6. Verifique se o Schema foi configurado automáticamente.
7. Clique em salvar.

### 4. Relacionando o Conector ao Agente

Para que um Agente de IA possa usar o novo Logic App, ele precisa ser relacionado:

1. Navegue até a seção de Agentes (no Portal de Administração).
2. Edite (ou crie) o Agente de IA que deverá ter acesso ao conector.

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

3. Na configuração do Agente, relacione o conector recém-criado.

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

4. Salve as alterações.

{% hint style="success" %}
Feito isso seu agente já está pronto para usar o logic app que foi criado, lembre sempre de ajustar as intruções do seu agente para que ele funcione de acordo com o logic app criado.
{% endhint %}


# N8N

{% hint style="danger" %}

### Link do Template pré-configurado do N8N

[<mark style="color:$danger;">Clique aqui</mark>](https://stpowergptprodeastus.blob.core.windows.net/public/TemplateOmniOpenApi.json)
{% endhint %}

O Conector N8N permite que o Power Omni utilize fluxos de trabalho (workflows) criados na plataforma N8N para executar automações complexas, conectar-se a sistemas externos e processar dados, atuando como um poderoso orquestrador de automação.

### Parte 1: Preparação a Importação do Fluxo N8N

Para que o N8N se comunique corretamente com o Power Omni, é necessário importar um *template* de fluxo predefinido com a estrutura correta de gatilho (`Trigger`) e resposta (`Response`).

#### 1.1 Obtenção e Importação do Template

1. Obtenha o Template: Acesse o link do template OpenAPI pré-configurado: \
   [<mark style="color:red;">Clique aqui</mark>](https://stpowergptprodeastus.blob.core.windows.net/public/TemplateOmniOpenApi.json)
2. Salve o Arquivo (`TemplateOmniOpenApi.json`) em seu computador clicando com o botão direito do mouse e selecionando a Opção Salvar como.

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

3. Importe no N8N: Acesse sua instância do N8N, clique em Create Workflow (Criar Fluxo de Trabalho).

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

4. Clique no ícone de três pontos (`...`) e selecione Import from File (Importar de Arquivo).

<figure><img src="/files/36feyJK5E8XkCWQQqhIr" alt=""><figcaption></figcaption></figure>

#### 1.2 Configuração da Autenticação no Fluxo

O *template* importado requer a configuração de dois nós de credenciais (`Credentials`) para autenticação no Power Omni.

1. Ajuste o Fluxo: Dentro do fluxo importado, você deve personalizar o fluxo para adicionar sua lógica de negócios (ex: nó de HTTP Request, nó de integração com um CRM, etc.).

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

2. Configure o Nó de Credenciais: Localize o nó responsável pelas credenciais de autenticação do N8N.

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

<figure><img src="/files/4t05TlVkQwRu0mKtPZBO" alt=""><figcaption></figcaption></figure>

* Preencha o campo com sua credencial do N8N, ou crie uma nova.<br>

3. Configure o Webhook com a credencial para o Omni ter acesso ao fluxo.

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

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

* O *Webhook* deve ser configurado com Header Auth para que o Omni tenha acesso seguro ao fluxo.

4. Salve o Fluxo: Salve as alterações do seu fluxo personalizado.

### Parte 2: Ativação do Fluxo e Coleta da URL

O N8N expõe um *endpoint* para que o Power Omni possa enviar a solicitação.

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

1. Localize o nó de Get OpenApi dentro do seu fluxo N8N.

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

2. Dentro das configurações do nó, localize e clique na opção para visualizar o URL de Produção. \
   (Esta é a URL que o Power Omni utilizará para invocar o fluxo.)
3. Copie o URL.
4. Ative o Fluxo: Certifique-se de que o *toggle* na parte superior do seu fluxo esteja ATIVADO para que ele possa receber requisições externas.&#x20;

<figure><img src="/files/3HNMNKkafCDi6W9oQYug" alt=""><figcaption></figcaption></figure>

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

5. Salve o Fluxo e acesse o Power Omni.

### Parte 3: Criação do Conector no Power Omni

Com o fluxo N8N ativo e a URL de produção em mãos, o último passo é configurar o conector no Power Omni.

#### 3.1 Criação do Conector N8N

1. Acesse o **Portal de Administração** do Power Omni e navegue até **Conectores**.
2. Clique em **"Criar"** e selecione o tipo "Conector N8N".

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

* **Projeto**: Escolha o projeto onde este conector será registrado.
* **Nome**: Para identificação no Portal de Administração (Ex: "Automação Criação de Ticket").
* **Descrição**: Descreva a função do fluxo N8N para o Agente de IA (Ex: "Use para criar enviar um comunicado no Telegram.").

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

* **Importar conexão existente**: Utilize esta opção caso já tenha criado a conexão com este fluxo em outro momento e deseje reutilizá-la.
* **Criar Nova Conexão**: Utilize caso seja a primeira vez configurando este fluxo. Preencha os detalhes de autenticação abaixo:
* **Nome da Conexão**: Nome interno para a conexão.
* **API Key**: Insira a chave de autenticação (Key) que foi cadastrada no N8N.

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

* **URL Base**: Cole o URL de Produção que você copiou do nó `Get OpenApi` no N8N.
* **Salve o Conector** após preencher todos os campos.

#### 3.2 Conectando ao Agente

1. Acesse **Artefatos > Agentes** no Portal de Administração.
2. Selecione o Agente de IA que deve usar a automação do N8N.
3. Navegue até a aba **Relacionamentos>Conectores**.
4. Localize e adicione o Conector N8N recém-criado.
5. Clique em **"Salvar"**.

#### ✅ Resultado Final

O Agente está pronto para usar a automação. Quando o usuário fizer uma solicitação que corresponda à Descrição da Ferramenta (Ex: "Crie um novo ticket para o cliente X"), o Agente irá acionar o fluxo N8N via WebHook, executando a automação desejada.


# SharePoint

{% hint style="warning" %}

#### **IMPORTANTE**

\
**Antes de configurar o conector do SharePoint, conclua as etapas da documentação** \
[**Permissão Foundry User**](https://docs.poweromni.ai/permissao-foundry-user)**.**\
**Essa permissão é necessária para que os usuários possam utilizar o agente do SharePoint pelo Power Omni.**
{% endhint %}

### **1. Introdução**

Essa seção descreve o processo de integração entre o SharePoint e o Power Omni via conector. Ao seguir estas instruções, poderá configurar o acesso aos documentos e sites do SharePoint para que sejam consumidos por agentes de IA no Power Omni.

***

### 2. Pré-requisitos

Certifique-se de que todos os itens abaixo estão atendidos antes de iniciar a configuração.

<table><thead><tr><th width="283">Requisito</th><th>Descrição</th></tr></thead><tbody><tr><td>Assinatura Azure</td><td>Acesso como <strong>Owner</strong> ou <strong>Contributor</strong> na assinatura e no grupo de recursos</td></tr><tr><td>Licença Microsoft 365 Copilot</td><td>Ao menos <strong>1 licença ativa</strong> durante todo o período de uso</td></tr><tr><td>Permissão de Leitura no SharePoint</td><td>O usuário precisa de acesso de leitura nos sites e documentos a serem consultados</td></tr><tr><td>Serviço Pay-as-you-go da API Retrieval</td><td>(Melhor Alternativa para não precisar contratar licenças copilot para os usuários)</td></tr></tbody></table>

{% hint style="info" %}

## 💡 **Recomendação**

O modelo Pay-as-you-go é a alternativa mais econômica para equipes que não precisam de licenças Copilot completas, pagando apenas pelo uso efetivo da API.
{% endhint %}

***

### 3. Configuração

A configuração é dividida em duas partes independentes que devem ser executadas na ordem apresentada.

***

#### **Parte 1 — Ativar o serviço Pay-as-you-go no Microsoft 365**

> 🔐 **Quem executa:** Administrador do tenant Microsoft 365.

**Passo 1 — Acessar o Admin Center**

1. Acesse <https://admin.microsoft.com>
2. Faça login com a conta de administrador do tenant.

**Passo 2 — Criar a política de cobrança**

1. No menu lateral, navegue até **Copilot → Billing & Usage**.

   <figure><img src="/files/4pc4lhwl330N5TMaNEA5" alt=""><figcaption></figcaption></figure>
2. Selecione a aba **Billing policies e +Add a billing policy**.
3. Preencha as configurações da política:

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

* **Nome** da política de cobrança
* **Assinatura Azure** e **Resource Group** para faturamento
* **Escopo de usuários:** todos os usuários ou um grupo específico

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

* **Orçamento (opcional):** ative *Set a budget for this policy* e defina um valor máximo, ou deixe sem limite

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

1. Revise as informações e clique em **Create policy**.

**Passo 3 — Confirmar a ativação**

1. Ainda em **Billing & Usage**, selecione a aba **Pay-as-you-go**.

   <figure><img src="/files/6G1vNBHtSVZfD195gsbh" alt=""><figcaption></figcaption></figure>
2. Localize o item **Microsoft 365 Copilot Retrieval API**.
3. Confirme que o status está como **Connected**.

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

{% hint style="warning" %}

## ⚠️ **Atenção — Tempo de propagação**

Após a ativação, aguarde até **2 horas** para o serviço ser propagado por todo o tenant. A primeira chamada de API após esse período pode falhar, este é um comportamento esperado. A partir da segunda chamada, o serviço funcionará normalmente.
{% endhint %}

***

#### **Parte 2 — Criar o Agente no SharePoint**

> 🔐 **Quem executa:** Usuário com licença Microsoft 365 Copilot ativa.

**Passo 1 — Acessar o site do SharePoint**

Navegue até o site do SharePoint cujos arquivos o agente deverá acessar.

**Passo 2 — Criar o agente**

1. Clique em **+ New → Agent**.

   <figure><img src="/files/1LKoMNQRgjLjRm39F7PB" alt=""><figcaption></figcaption></figure>
2. Preencha:

   * **Nome** do agente
   * **Objetivo** do agente

   <figure><img src="/files/wfcfNJEeFOWU95TZaEU3" alt=""><figcaption></figcaption></figure>
3. Adicione as **fontes de dados** (arquivos específicos ou todo o conteúdo do site).

   <figure><img src="/files/EBXPUzOJy4ygxq86F80b" alt=""><figcaption></figcaption></figure>
4. Defina as **instruções de comportamento** do agente.

   <figure><img src="/files/FwSQ1yrCbpmzIKCYOMgB" alt=""><figcaption></figcaption></figure>
5. Clique em **Create agent**.

**Passo 3 — Copiar a URL do site**

Após salvar, copie a URL do site para uso na próxima etapa. O formato esperado é:

```
https://<empresa>.sharepoint.com/sites/<nome_do_site>
```

***

#### **Parte 3 — Configurar o Conector no Power Omni**

**Passo 1 — Criar o conector**

1. Acesse **Configurações → Artefatos → Conectores**.

   <figure><img src="/files/AC1lEf3DccyBzAP9OdYD" alt=""><figcaption></figcaption></figure>
2. Clique em **Create**.

   <figure><img src="/files/yEtCijhbS5VBoStOsX7F" alt=""><figcaption></figcaption></figure>
3. Selecione o conector do **SharePoint**.
4. Preencha:

   * **Nome** do conector
   * **Descrição**
   * **Projeto** do Power Omni associado

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

**Passo 2 — Criar a conexão**

1. Clique em **Criar nova conexão**.
2. Preencha:

   * **Nome da conexão** (pode ser o mesmo nome do conector)
   * **URL do site SharePoint:** `https://<empresa>.sharepoint.com/sites/<nome_do_site>`

   <figure><img src="/files/jHBh1TBFXLYQaet4glvY" alt=""><figcaption></figcaption></figure>
3. Clique em **Salvar**.

**Passo 3 — Vincular o conector ao agente**

1. Acesse **Artefatos → Agentes**.
2. Selecione o agente desejado e vá até a aba **Relacionamentos**.

   <figure><img src="/files/HSAq1fmqUaiz56e6cLH3" alt=""><figcaption></figcaption></figure>
3. Adicione o conector criado.

   <figure><img src="/files/cXxX862w8sI1eCooDmeF" alt=""><figcaption></figcaption></figure>
4. Salve e teste o agente.

{% hint style="info" %}

## 📌 **Limitação**

Apenas **1 conexão SharePoint por agente** é permitida. Para acessar múltiplos sites, crie agentes separados para cada um.
{% endhint %}

***

### 4. Permissões e Modelo de Cobrança

#### 4.1 Acesso para outros usuários

* Usuários sem licença Copilot podem usar o agente se estiverem incluídos na política de cobrança Pay-as-you-go.

#### 4.2 Custos

| Item                             | Valor                                                    |
| -------------------------------- | -------------------------------------------------------- |
| Chamada do serviço Pay-as-you-go | US$ 0,10 por chamada (preço de preview)                  |
| Monitoramento de consumo         | Azure Cost Management                                    |
| Limites de uso                   | Configuráveis (diário e mensal) via política de cobrança |

***

### 5. Conclusão

A integração do SharePoint ao Power Omni permite consultar dados diretamente de sites e documentos do SharePoint dentro de agentes do Power Omni. Siga as três partes da configuração na ordem apresentada e valide cada etapa antes de avançar para a próxima.

Em caso de dúvidas ou falhas, verifique:

* Se a política Pay-as-you-go está com status **Connected**
* Se o tempo de propagação de 2 horas já foi aguardado
* Se a URL do site SharePoint foi copiada corretamente


# MCP

O conector MCP permite conectar um agente do Power Omni a um servidor compatível com Model Context Protocol.

Na prática, ele funciona como uma ponte entre o agente e ferramentas externas. Essas ferramentas podem estar em um servidor próprio, em uma API preparada para MCP ou em um serviço mantido por outro fornecedor.

### Quando usar o conector MCP?

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

Use o conector MCP quando você já possui um servidor MCP disponível e quer permitir que o agente execute as ferramentas publicadas por esse servidor.

Alguns exemplos de uso:

* consultar dados em um sistema externo;
* executar ações em uma API própria;
* integrar o agente a ferramentas internas da empresa;

Esse conector é indicado para cenários mais técnicos, onde existe um servidor MCP pronto de algum sistema ou ferramenta que a empresa usa ou uma equipe responsável por criar e manter esse servidor.

### Como funciona no Power Omni

Ao criar o conector, você informa a URL do servidor MCP, define um nome para o servidor, escolhe o tipo de autenticação e, se necessário, limita quais ferramentas o agente poderá usar.

No momento, o Power Omni permite conectar servidores MCP de duas formas:

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

1. Sem autenticação, para servidores públicos.
2. Com API Key, para servidores que exigem uma chave de acesso.

A Microsoft também recomenda armazenar credenciais em conexões do projeto, em vez de deixar chaves fixas diretamente no código da aplicação.

### Criando um conector MCP

Para criar um conector MCP, acesse:

Configurações → Artefatos → Conectores → Criar Conector

Depois, selecione o tipo Servidor MCP.

Preencha os campos conforme o servidor que deseja conectar.

### Campos do conector

<table><thead><tr><th width="216">Campo</th><th>Como preencher</th></tr></thead><tbody><tr><td>Tipo de Conector</td><td>Selecione Servidor MCP.</td></tr><tr><td>Projeto</td><td>Escolha o projeto onde o conector será criado.</td></tr><tr><td>Nome</td><td>Dê um nome simples para identificar o conector no Power Omni.</td></tr><tr><td>Descrição</td><td>Explique quando e como o agente deve usar esse conector.</td></tr><tr><td>Label do Servidor</td><td>Informe um identificador único para esse servidor MCP. Exemplo: meu_servidor_mcp.</td></tr><tr><td>URL do Servidor</td><td>Informe a URL do endpoint MCP. Exemplo: https://exemplo.com/api/mcp.</td></tr><tr><td>Autenticação</td><td>Escolha Nenhuma ou API Key, conforme o servidor.</td></tr><tr><td>Tools Permitidas</td><td>Informe quais ferramentas desse servidor o agente poderá usar. Deixe vazio para permitir todas.</td></tr><tr><td>Política de Aprovação</td><td>Defina se as chamadas serão automáticas ou se exigirão aprovação.</td></tr></tbody></table>

### Label do Servidor

O Label do Servidor é o identificador usado para reconhecer aquele servidor MCP.

Use um nome curto, sem espaços e fácil de entender.

Exemplos:

```
github_mcp financeiro_mcp crm_mcp meu_servidor_mcp
```

O ideal é que o nome indique qual sistema ou finalidade aquele MCP representa.

### URL do Servidor

A URL do Servidor deve apontar para o endpoint MCP remoto.

Exemplo:

```
https://exemplo.com/api/mcp
```

O servidor precisa estar acessível. Se a URL estiver protegida por rede privada, firewall, bloqueio de IP ou autenticação não suportada, o conector pode não funcionar corretamente.

### Autenticação

O Power Omni suporta, no momento, dois tipos de autenticação para o conector MCP.

#### Nenhuma

Use essa opção quando o servidor MCP for público e não exigir chave, token ou credencial.

Esse modo é útil para testes, servidores internos sem autenticação ou serviços que já possuem outra camada de proteção antes do endpoint.

#### API Key

Use essa opção quando o servidor MCP exigir uma chave de acesso.

Ao selecionar API Key, o Power Omni exibirá a área de Configuração de Conexão.

Você pode importar uma conexão existente ou criar uma nova conexão.

Para criar uma nova conexão, preencha:

<table><thead><tr><th width="225">Campo</th><th>Como preencher</th></tr></thead><tbody><tr><td>Nome da Conexão</td><td>Dê um nome para identificar a credencial.</td></tr><tr><td>Token / API Key</td><td>Cole a chave ou token exigido pelo servidor MCP.</td></tr></tbody></table>

### Tools Permitidas

O campo Tools Permitidas permite limitar quais ferramentas do servidor MCP o agente poderá usar.

Se o servidor MCP expõe várias ferramentas, você pode liberar apenas as necessárias para aquele agente.

Exemplo:

```
consultar_cliente listar_pedidos abrir_chamado
```

Essa configuração ajuda a reduzir riscos e evita que o agente use ferramentas que não fazem parte do objetivo dele.

### Política de Aprovação

A Política de Aprovação define se o agente poderá executar as ferramentas automaticamente ou se será necessário algum tipo de aprovação antes da chamada.

No Power Omni, a opção Nunca (execução automática) permite que o agente execute a ferramenta sem pedir aprovação manual a cada uso.

Use execução automática apenas quando a ferramenta for segura para o fluxo do agente.

Recomendamos exigir aprovação em operações de maior risco, principalmente quando a ferramenta escreve dados ou altera recursos.&#x20;

### Testando o conector

Depois de salvar o conector, associe ele a um agente e faça testes simples.

Você pode perguntar ao agente:

```
Quais ferramentas estão disponíveis?
```

Depois, teste uma ferramenta específica do servidor MCP.

Exemplo:

```
Consulte os dados do cliente João usando a ferramenta disponível.
```

Se o agente não conseguir usar a ferramenta, revise:

* se a URL do servidor está correta;
* se o servidor está online;
* se a API Key está correta;
* se a ferramenta está na lista de Tools Permitidas;
* se o agente está vinculado ao conector;
* se a descrição do conector deixa claro quando ele deve ser usado.

### Preciso de ajuda?

Se tiver qualquer dúvida para configurar um servidor MCP, validar autenticação, preencher os campos ou entender quais ferramentas liberar para o agente, procure o suporte do Power Omni.


# Toolboxes

As **Toolboxes** permitem reunir várias ferramentas em um único conjunto e disponibilizá-las aos Agentes do Power Omni.

Em vez de configurar recursos relacionados separadamente, você pode criar uma Toolbox para uma finalidade específica, selecionar as ferramentas que fazem parte dela e depois associá-la aos agentes que precisam desses recursos.

Por exemplo, uma Toolbox de atendimento pode reunir uma API de tickets, um servidor MCP e a Busca na Web.

### Acessar Toolboxes

Acesse:

**Configurações → Artefatos → Toolboxes**<br>

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

Na tela de Toolboxes você pode visualizar os conjuntos já cadastrados e criar novas configurações.

A listagem apresenta:

* Nome
* Descrição
* Projeto
* Ações<br>

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

Para adicionar uma nova Toolbox, clique em **Criar**.

***

## Criar uma Toolbox

Ao clicar em **Criar**, será aberto o painel de configuração.

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

Preencha os campos:

### Projeto

Projeto do Microsoft Foundry associado ao seu Power Omni vai ser selecionado automaticamente.

### Nome

Informe um nome para identificar a Toolbox.

Exemplos:

* Atendimento ao Cliente
* Pesquisa na Web
* Consulta de Documentos
* Integrações Financeiras

### Descrição

Informe quando a Toolbox deve ser utilizada.

Exemplo:

`Ferramentas utilizadas pelos agentes responsáveis por consultar e gerenciar chamados de atendimento.`

Uma descrição clara ajuda a identificar a finalidade da Toolbox quando ela for associada aos agentes.

***

## Adicionar ferramentas

Na seção **Tools**, escolha quais recursos farão parte da Toolbox.

O Power Omni organiza as ferramentas disponíveis por categoria.

#### Conectores MCP Server

Permite adicionar servidores MCP disponíveis para o projeto selecionado.

Caso nenhum MCP esteja disponível, a interface exibirá:

`Nenhum conector MCP disponível.`

#### Conectores OpenAPI

Permite adicionar conectores criados a partir de APIs que utilizam o padrão OpenAPI.

Os conectores disponíveis aparecem na lista para seleção.

#### Conectores Logic App

Permite incluir integrações com Logic Apps disponíveis no projeto.

#### Conectores N8N

Permite incluir integrações N8N disponíveis no projeto.

#### Ferramentas nativas

Também é possível adicionar ferramentas fornecidas diretamente pelo Power Omni.

Atualmente, a tela permite selecionar:

* **Manipulador de Arquivos**
* **Busca na Web**

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

Marque as ferramentas que deseja incluir e clique em **Salvar**.

A Toolbox ficará disponível na página de Toolboxes do projeto.

***

## Associar uma Toolbox a um Agente

Depois de criar a Toolbox, é necessário definir quais agentes poderão utilizá-la.

Acesse:

**Configurações → Artefatos → Agentes**

Localize o agente desejado e abra o menu de ações.

Selecione **Toolboxes**.

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

Será aberta a tela de associação de Toolboxes.

<figure><img src="/files/80HxOxjP1WCoAMm6pFQm" alt=""><figcaption></figcaption></figure>

Na parte superior são exibidas as Toolboxes que já estão associadas ao agente.

Na seção **Selecionar Toolboxes**, são apresentadas as Toolboxes disponíveis para seleção.

Depois de definir quais Toolboxes o agente poderá utilizar, clique em **Salvar Seleção**.

O agente passa então a ter acesso às ferramentas incluídas nas Toolboxes selecionadas.

***

## Toolboxes e Conectores

Toolboxes e Conectores possuem funções diferentes.

Um **Conector** representa uma integração específica, como um servidor MCP, uma API OpenAPI, uma Logic App ou uma integração N8N.

Uma **Toolbox** reúne essas ferramentas em um conjunto.

Por exemplo:

```
Toolbox: Atendimento

├── OpenAPI - Tickets
├── MCP - Sistema Corporativo
├── Busca na Web
└── Manipulador de Arquivos
```

Essa Toolbox pode ser associada aos agentes que trabalham com atendimento, sem que seja necessário reconstruir o mesmo conjunto de ferramentas para cada agente.

***

### Resumo

O fluxo de configuração é:

**Criar ou configurar as ferramentas → Criar a Toolbox → Selecionar as ferramentas → Salvar → Associar a Toolbox ao Agente**

As Toolboxes tornam mais simples organizar e reutilizar conjuntos de ferramentas entre os agentes do Power Omni.


# Usuários

O módulo de Usuários é o centro administrativo onde você gerencia o acesso da sua equipe, define níveis de responsabilidade e controla a distribuição de licenças do Power Omni.

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

#### Visão Geral

Na parte superior do painel, você encontra as métricas cruciais de licenciamento e administração:

* **Total de Usuários:** Quantidade total de contas cadastradas na plataforma.
* **Com Licença:** Número de usuários que possuem uma licença ativa e podem interagir com os Agentes de IA.
* **Sem Licença:** Usuários cadastrados, mas sem licença ativa. Eles não consomem o seu saldo de licenças e não possuem acesso às funcionalidades de IA.
* **Administradores:** Quantidade de usuários que possuem permissões totais de gestão no sistema.

#### Gestão de Usuários

A tabela exibe todos os usuários, permitindo ações rápidas de gestão de acesso:

<table><thead><tr><th width="153">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Email</strong></td><td>Identificador principal da conta (utilizado para o login).</td></tr><tr><td><strong>Telefone</strong> </td><td>Número de contato do usuário (Campo opcional).</td></tr><tr><td><strong>Licença</strong></td><td>Ação <strong>Desassociar Licença</strong>. Clique aqui para remover imediatamente a licença de um usuário, liberando-a para outro.</td></tr><tr><td><strong>Função</strong></td><td>Identificador do nível de permissão (Administrador, Colaborador ou Usuário).</td></tr><tr><td><strong>Orçamento/Uso</strong></td><td>Exibe o limite de crédito/uso habilitado para o usuário e o quanto já foi consumido.</td></tr><tr><td><strong>Ações</strong></td><td>Ícones para Editar (detalhes), Excluir (remover registro) e Relacionamentos (vincular a Agentes, Grupos e Workspaces).</td></tr></tbody></table>

### Níveis de Permissão

O sistema utiliza permissões baseadas em funções para garantir a segurança e a governança dos dados.

<table data-header-hidden><thead><tr><th width="156"></th><th width="368"></th><th></th></tr></thead><tbody><tr><td><strong>Nível</strong></td><td><strong>Descrição de Acesso</strong></td><td><strong>Ideal para...</strong></td></tr><tr><td>Administrador</td><td>Acesso Total. Possui controle completo sobre o sistema, incluindo faturamento, dados fiscais, compra e atribuição de licenças, além de todos os agentes e workspaces.</td><td>Gestores de TI, proprietários da conta e diretores...</td></tr><tr><td>Colaborador</td><td>Gestão de Conteúdo. Pode criar e gerenciar agentes, workspaces e grupos. Tem liberdade para configurar automações (Conectores), mas não possui acesso ao faturamento ou gestão de licenças.</td><td>Líderes de projeto ou departamento, Analistas..</td></tr><tr><td>Usuário</td><td>Acesso Restrito. Só consegue visualizar e interagir com os Agentes de IA que foram explicitamente compartilhados com ele ou com o grupo/Workspace ao qual pertence.</td><td>Equipes de atendimento, vendas ou colaboradores que apenas consomem a IA.</td></tr></tbody></table>

***

### Segurança e Governança

* Hierarquia: Um Colaborador não pode promover a si mesmo ou a outros para Administrador. Essa ação é exclusiva de quem já possui o nível de Adm.
* Visibilidade de Agentes: Lembre-se que para o nível Usuário, não basta estar cadastrado; após o cadastro, você deve ir até as configurações do Agente desejado e dar a permissão de acesso para este usuário ou para o grupo/Workspace dele.

{% hint style="info" %}

### Dica:

Use a função de Colaborador para descentralizar a criação de Agentes entre seus departamentos sem o risco de alterações acidentais no faturamento ou no plano de licenças da empresa.
{% endhint %}

### Ações Principais na Tela de Usuários

#### Cadastrar Novo Usuário (Individual)

Para adicionar um novo membro à plataforma:

1. Clique no botão![](/files/8e85VMCrOqs3csRpU2Kl) (+ Criar).
2. Insira o E-mail (necessário para autenticação via Microsoft Entra ID).
3. Informe o Telefone (opcional) e selecione o Nível de Permissão.
4. Clique em Salvar. Após a criação, lembre-se de atribuir a licença na tabela principal.

#### Importar Usuários (Lote)

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

1. Clique no botão "Importar".
2. O arquivo deve ser obrigatoriamente do tipo .CSV e conter uma coluna de e-mail.
3. Atenção: Não inclua cabeçalhos no arquivo. Outras informações como código do país e telefone são opcionais.
4. Selecione o arquivo e confirme a importação.

#### Exportar

Para exportar a lista de usuários cadastrados:

* Clique no botão "Exportar" para gerar um arquivo .CSV com a lista completa de usuários, e-mails, permissões e status de licenciamento para fins de auditoria.

#### Gerenciar Licenças

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

O controle de licenças é feito individualmente na listagem de usuários:

* Atribuir Licença: Para que um usuário consiga logar e utilizar a plataforma, ele precisa de uma licença ativa. Ative a chave de licença na linha correspondente ao usuário.
* Remover Licença: Ao desativar uma licença, ela retorna para o seu "pool" de licenças disponíveis, permitindo que seja atribuída a outra pessoa sem custo adicional.

***


# Grupos

O menu Grupos é a ferramenta essencial para organizar seus usuários e simplificar a aplicação de regras de acesso a Agentes e Áreas de Trabalho. Em vez de gerenciar permissões por usuário individual, você as gerencia por Grupo.

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

#### Visão Geral

A tabela principal exibe todos os Grupos cadastrados na sua organização (Ex: Comercial, Diretoria, Financeiro, RH).

#### Como Criar e Gerenciar um Grupo

#### 1. Criação de um Novo Grupo

* Clique no botão **Criar** no canto superior direito.
* Defina o **Nome** do Grupo (Ex: Marketing, ADM, Financeiro).

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

#### 2. Gerenciamento de Relacionamentos (Permissões)

Ao clicar no botão de ações (`...`) ao lado de um Grupo, você acessa o menu **Relacionamentos**. Esta é a etapa fundamental para atribuir as permissões do Grupo:

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

* **Usuários:** Vincule os **Usuários** da sua organização a este Grupo. Todos os membros do Grupo herdarão as mesmas permissões de acesso.
* **Agentes:** Defina quais **Agentes** (assistentes de IA) os membros deste Grupo terão permissão para visualizar e interagir no portal de chat.
* **Áreas de Trabalho:** Defina quais **Áreas de Trabalho** (organização lógica) o Grupo pode acessar.

{% hint style="info" %}

## Importância da Hierarquia

A segurança no Power Omni é baseada em: Usuário → Pertence a um GRUPO → Tem acesso a AGENTES e Áreas de Trabalho. O uso de Grupos simplifica a conformidade e facilita a auditoria na seção Visualizar Permissões.
{% endhint %}


# Áreas de Trabalho

O menu Áreas de Trabalho é uma ferramenta organizacional que permite agrupar Agentes (assistentes de IA) por equipe, projeto ou departamento, facilitando a navegação e a organização do portal do usuário sem, necessariamente, impactar as permissões fundamentais.

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

#### Visão Geral

A tabela exibe as Áreas de Trabalho que já foram criadas (Ex: Comercial, RH, Financeiro,ADM).

#### Como Criar e Gerenciar uma Área de Trabalho

#### 1. Criação

* Clique no botão **Criar** no canto superior direito.
* Defina o **Nome** da Área de Trabalho.

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

#### 2. Gerenciamento de Relacionamentos (Organização)

Ao clicar no botão de ações (`...`) ao lado de uma Área de Trabalho, você acessa o menu **Relacionamentos**. É aqui que você define o que pertence a essa área:

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

* **Agentes:** Vincule os **Agentes** que serão exibidos nesta Área de Trabalho. Por exemplo, a Área de Trabalho "RH" deve conter os Agentes "PC Interno" e "Agente de Políticas Internas".
* **Usuários:** Vincule os **Usuários** que verão esta Área de Trabalho no menu de navegação.
* **Grupos:** Vincule os **Grupos** de usuários que verão esta Área de Trabalho.

{% hint style="info" %}
Diferença Importante: Enquanto os Grupos controlam a segurança e o acesso (quem pode usar), as Áreas de Trabalho controlam a organização e a visibilidade (onde o Agente aparece). Use-as para tornar a interface mais limpa para o usuário final.
{% endhint %}


# Orçamento

O Power Omni oferece ferramentas avançadas na Área de Administração para monitorar e controlar o consumo de tokens de Inteligência Artificial (cobrado diretamente pela Microsoft no seu Azure).

Você pode definir limites de uso para evitar gastos excessivos, tanto a nível geral da organização quanto para entidades específicas (usuários, agentes, grupos e áreas de trabalho).

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

### Visão Geral do Controle de Custos

O controle de custos é acessível no Portal de Administração e permite definir orçamentos mensais, limitando a quantidade de tokens que podem ser consumidos no período.

#### Orçamento Global da Organização

* Configuração Geral: É possível definir um limite de consumo mensal em dólares (USD) para toda a organização.
* Sem Limite: Se o campo de orçamento for deixado vazio ou com valor zero, o consumo da organização será ilimitado (limitado apenas pelo seu plano Azure).

#### Limite por Entidade Específica

Para otimizar e gerenciar o consumo de forma precisa, o Power Omni permite aplicar orçamentos segmentados. Esses orçamentos atuam garantindo um controle específico e detalhado sobre o gasto de tokens por áreas ou indivíduos.

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

***

### Fluxo de Prioridade e Contabilização

O Power Omni segue um fluxo de hierarquia para determinar o caminho de acesso à IA e aplicar as regras de orçamento.

#### Hierarquia de Acesso (Prioridade)

O sistema prioriza o acesso aos agentes de IA buscando o caminho mais específico, seguindo a ordem de hierarquia abaixo:

1. Usuário → Agente
2. Usuário → Grupo → Agente
3. Usuário → Área de Trabalho → Agente
4. Usuário → Grupo → Área de Trabalho → Agente

A ordem de prioridade é sempre respeitada, mesmo que um ou mais níveis não possuam orçamento definido.\
Se a Organização, Usuário ou Agente possuir orçamento e exceder o limite, o sistema gerará uma falha específica conforme o nível que ultrapassou a cota.

***

#### Contabilização de Uso (Tokens)

* O orçamento refere-se exclusivamente ao consumo de tokens.\
  Funcionalidades com custos adicionais — como os Conectores Fabric, VectorStore e CodeInterpreter — não são contabilizadas no orçamento.
* Cada item (Usuário, Grupo, Área de Trabalho e Agente) tem seu uso contabilizado de forma independente, independente da existência de um orçamento.\
  Essa contabilização de uso ocorre de forma assíncrona, permitindo que as atualizações de consumo dos itens do caminho escolhido ocorram em paralelo, sem bloquear as execuções em andamento.
* Durante a execução, o consumo de tokens é contabilizado individualmente para cada item que compõe o caminho efetivamente utilizado (por exemplo, Usuário, Grupo e Agente).\
  Esses custos de utilização individuais são utilizados para verificar se algum orçamento foi excedido em qualquer nível do caminho percorrido.
* Um caminho de acesso entre o Usuário e o Agente é considerado bloqueado quando um ou mais itens que o compõem possuem orçamento definido e já expirado.\
  Nesses casos, o sistema tentará automaticamente o próximo caminho disponível, seguindo a ordem de prioridade.\
  Se todos os caminhos estiverem bloqueados, o sistema retornará um erro genérico ou específico, dependendo da natureza da falha.

#### Regras de Bloqueio e Tentativa de Próximo Caminho

O sistema monitora cada nível do caminho de acesso e aplica o bloqueio de forma inteligente:

***

{% hint style="danger" %}

## <mark style="color:$danger;">Aviso Importante sobre Excedente de Tokens</mark>

<mark style="color:$danger;">Devido à natureza em tempo real da contagem de tokens (que só é finalizada após a conclusão de uma resposta da IA), pode ocorrer um consumo que ultrapasse ligeiramente o limite de orçamento. Isso acontece apenas para garantir a finalização de uma solicitação em andamento, evitando que a conversa seja cortada no meio.</mark>
{% endhint %}

***

### Configurando um Orçamento

A configuração de orçamentos é realizada na área de administração da ferramenta, permitindo a definição de um valor limite e as ações a serem tomadas ao atingi-lo.

#### Passo a Passo

1. Acesse o Portal de Administração.
2. Navegue até a seção de Orçamentos.
3. Utilize o campo de Limite de Uso Mensal (USD) para definir o orçamento para organização em geral (Não é obrigatorio).
4. Para configurar o orçamento em uma permissão especifica é só clicar no Icone Azul ![](/files/aseFJG6P7AvbsbuBvObr) e selecionar o escopo (Usuário,agente,grupo e Área de trabalho) e o valor limite (USD).

<figure><img src="/files/6imdfoK9bfnLOYuwDf7J" alt=""><figcaption></figcaption></figure>

#### Opções ao Atingir o Limite

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

* Bloqueio Automático: Ao atingir o limite, o usuário receberá uma mensagem de erro logo após tentar enviar uma mensagem, informando que o limite de uso foi atingido. O acesso à funcionalidade de IA é bloqueado automaticamente para a entidade em questão e é restaurado no início do próximo mês.
* Liberação Manual: Caso queira liberar o uso mesmo após ultrapassar o limite, o administrador pode ajustar o orçamento (aumentando a capacidade em USD) diretamente nas configurações de orçamento.

### Visualização e Auditoria

O Power Omni registra o consumo de tokens de forma transparente. Os administradores podem visualizar o consumo acumulado no mês e o percentual em relação ao orçamento definido:

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

* Dashboards: Apresenta o consumo total da organização e o saldo restante do orçamento global.
* Auditoria de Permissões: No menu Auditorias > Visualizar permissões, é possível verificar os possíveis caminhos até um determinado agente e visualizar se há orçamentos e quanto de uso já foi utilizado em entidades específicas como grupos e áreas de trabalho.
* Relatórios Detalhados: É possível auditar o consumo de tokens por usuário, agente, grupo e área de trabalho.
* <mark style="color:$warning;">Reset Mensal: Todos os orçamentos e contadores de uso são resetados automaticamente no primeiro dia de cada mês, iniciando um novo ciclo de controle de gastos.</mark>


# Auditorias

A área de Auditorias é vital para a Governança e Controle Financeiro do uso da IA.

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

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Consumo de Tokens</td><td><a href="/files/ehWBZQUuAWMqaAy2MlOs">/files/ehWBZQUuAWMqaAy2MlOs</a></td><td><a href="/pages/PnmzCIrCMzmt462OE4by">/pages/PnmzCIrCMzmt462OE4by</a></td></tr><tr><td align="center">Visualizar Permissões</td><td><a href="/files/R7Jf8rGpbXbsHxaywlG2">/files/R7Jf8rGpbXbsHxaywlG2</a></td><td><a href="/pages/CpCSgVoeWCjiJRUcTzdL">/pages/CpCSgVoeWCjiJRUcTzdL</a></td></tr></tbody></table>


# Consumo de Tokens

O menu **Consumo de Tokens** é a sua fonte de dados para auditoria detalhada, apresentando um log transacional de cada interação de IA. Ele permite que o administrador rastreie o custo de tokens **por pergunta**, garantindo total transparência no consumo da sua conta Azure.

<figure><img src="/files/6yMdiHbWJWTlY9CBiqOd" alt=""><figcaption></figcaption></figure>

#### Propósito

* **Auditoria Financeira:** Identificar exatamente onde o custo está sendo gerado.
* **Otimização de Custos:** Analisar o consumo por **Modelo** e **Agente** para tomar decisões sobre a escolha do modelo mais eficiente para cada função.
* **Governança:** Vincular cada interação a um usuário e a um projeto específico.

#### Detalhamento da Tabela

A tabela de log mostra os seguintes campos para cada transação (pergunta/resposta):

<table><thead><tr><th width="207">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Projeto</strong></td><td>O recurso Azure que gerou o consumo.</td></tr><tr><td><strong>Modelo</strong></td><td>O modelo de IA específico utilizado na interação.</td></tr><tr><td><strong>Agente</strong></td><td>O assistente de IA que o usuário utilizou.</td></tr><tr><td><strong>Usuário</strong></td><td>O usuário que iniciou a interação.</td></tr><tr><td><strong>Tokens de Entrada</strong></td><td>A quantidade de tokens usados no prompt do usuário.</td></tr><tr><td><strong>Tokens de Saída</strong></td><td>A quantidade de tokens usados para gerar a resposta da IA.</td></tr><tr><td><strong>Custo Total</strong></td><td>O custo financeiro da interação específica em dólar (USD).</td></tr></tbody></table>


# Visualizar Permissões

O menu **Visualizar Permissões** oferece uma representação visual da **cadeia completa de permissões** na plataforma. Ele permite que os administradores realizem auditorias de segurança e confirmem que as regras de acesso aos Agentes e dados estão corretas e em conformidade.

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

#### Propósito

* **Rastreabilidade:** Permite que você visualize rapidamente quais Agentes (assistentes de IA) um usuário específico pode acessar.
* **Conformidade:** Garante que as permissões de acesso aos dados internos (via Agentes) estejam alinhadas com a estrutura da sua organização.

#### Utilização

Você pode pesquisar a cadeia de permissões usando um dos seguintes critérios:

1. **Usuário ou Grupo:** Pesquise pelo nome do usuário ou grupo.
2. **Agente:** Pesquise por um Agente para ver quem pode acessá-lo.
3. **Área de Trabalho:** Pesquise pela área de trabalho para ver os grupos e agentes vinculados.

#### Diagrama de Permissões (Estrutura Visual)

O diagrama mostra a hierarquia de acesso, com os nós representando a entidade e as linhas representando a permissão concedida.

* **Cadeia Principal:** **USUÁRIO** pertence a **GRUPO**.
* **Acesso a Agente:** O **GRUPO** tem permissão de acesso a diversos **AGENTES.**


# Licenças

O menu **Licenças** fornece o painel de controle financeiro e logístico sobre o uso das licenças de usuário contratadas. É aqui que você gerencia a **quantidade** de licenças e audita seu status e histórico de uso.

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

#### Visão Geral

A primeira linha do painel apresenta o status atual do seu contrato de licenciamento:

* **Contratadas:** O número total de licenças incluídas em seu plano de serviço.
* **Atribuídas:** O número de licenças que estão ativas e em uso por usuários no momento.
* **Disponíveis:** O saldo de licenças não utilizadas que podem ser atribuídas a novos usuários.
* **Desativadas:** O número de licenças removidas de usuários no período.

#### Tabela de Licenças e Ações

A tabela lista cada licença individualmente, com seu **ID** único, data de criação, **Status** (Ativo ou Desativado) e o **Email do Usuário** que a está utilizando.

<table><thead><tr><th width="204">Ação</th><th>Propósito</th></tr></thead><tbody><tr><td><strong>Desassociar Licença</strong></td><td>Remove a licença do usuário listado e move-a para o saldo disponível. O usuário perde o acesso aos Agentes.</td></tr><tr><td><strong>Detalhes</strong></td><td>Abre o <strong>Histórico de Eventos</strong> da licença, mostrando quando ela foi criada, quando foi atribuída ao usuário e se houve mudanças.</td></tr><tr><td><strong>Remover Licença</strong></td><td>Remove uma quantidade específica de licenças do seu pool Contratadas. Necessita de confirmação e impacta o seu contrato.</td></tr><tr><td><strong>Adicionar Licença</strong></td><td>Aumenta o número de licenças Contratadas. Se houver licenças solicitadas durante o mês, elas serão adicionadas automaticamente para atender a demanda.</td></tr></tbody></table>

{% hint style="warning" %}

## Importante

Caso uma licença seja removida durante o mês, o valor correspondente será mantido na fatura do ciclo vigente. A exclusão da cobrança será refletida automaticamente a partir do faturamento do mês subsequente.
{% endhint %}

<figure><img src="/files/3ZzJmtA6pEJlxmQAVxYo" alt=""><figcaption></figcaption></figure>


# Suporte

A seção **Suporte** no Portal de Administração permite que os administradores gerenciem o status de todos os tickets de suporte da organização e abram novos chamados para a equipe de atendimento do Power Omni.

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

#### Como Abrir um Novo Ticket de Suporte

Para solicitar assistência técnica, reportar um problema ou fazer uma solicitação, siga os passos abaixo:

1. Acesse o menu lateral e clique em **Suporte**.
2. Clique no botão **Novo Ticket** no canto superior direito da tela.

A janela de criação de ticket será aberta, solicitando as seguintes informações:

<table><thead><tr><th width="141">Campo</th><th>Propósito</th><th>Dica de Preenchimento</th></tr></thead><tbody><tr><td><strong>Título</strong></td><td>Descreva <strong>brevemente</strong> o problema ou solicitação.</td><td>Ex: "Agente RH não acessa novos arquivos" ou "Erro ao exportar log de tokens".</td></tr><tr><td><strong>Descrição Detalhada</strong></td><td>Descreva o problema de forma completa. Inclua <strong>passos para reproduzir o erro</strong>, mensagens de erro exatas e o horário da ocorrência.</td><td>Seja o mais específico possível. Você pode usar o botão <strong>Imagem</strong> para anexar screenshots que ilustrem o problema.</td></tr></tbody></table>

Após preencher as informações, clique em **Criar Ticket**. O novo chamado será registrado e aparecerá imediatamente na sua lista de tickets, com o status **Ativo**.

#### Gestão e Acompanhamento de Tickets

A tela principal de **Suporte** lista todos os tickets abertos, permitindo o acompanhamento do status e do histórico de cada chamado:

* **ID:** Número de identificação único do chamado.
* **Título/Descrição:** Breve resumo do problema.
* **Status:** Indica a situação atual do chamado (Ex: **Ativo**, Pendente, Fechado).
* **Última Atualização:** Data e hora da última interação (sua ou do time de suporte).

{% hint style="warning" %}

## Lembrete sobre Suporte

**Se sua organização possui o Plano Enterprise, você pode acionar o Suporte Prioritário diretamente via Grupo WhatsApp para questões urgentes. O sistema de tickets é o método padrão para o Plano Básico (Gratuito).**
{% endhint %}


# Faturamento

A seção Faturamento centraliza todas as informações financeiras, fiscais e de suporte do seu contrato Power Omni, fornecendo controle total sobre a cobrança e o status do serviço.

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Dados Fiscais</td><td><a href="/files/VLvxPBqqhJUu7Eg4kNBR">/files/VLvxPBqqhJUu7Eg4kNBR</a></td><td><a href="/pages/UZWh9veYyyTedi0CsGU2">/pages/UZWh9veYyyTedi0CsGU2</a></td></tr><tr><td align="center">Configurações</td><td><a href="/files/6fCGa9GMixchBKWd71og">/files/6fCGa9GMixchBKWd71og</a></td><td><a href="/pages/4CABYe2BfFtVCQVlSkDO">/pages/4CABYe2BfFtVCQVlSkDO</a></td></tr><tr><td align="center">Faturas</td><td><a href="/files/lVBMgxgdctTvhUkYmJqc">/files/lVBMgxgdctTvhUkYmJqc</a></td><td><a href="/pages/0yul9dOiapaDTZh5bogI">/pages/0yul9dOiapaDTZh5bogI</a></td></tr><tr><td align="center">Suporte</td><td><a href="/files/9Q5vaFXCqLpE6l4noaIi">/files/9Q5vaFXCqLpE6l4noaIi</a></td><td><a href="/pages/Hw2xNFYMmnN82pIEQ58q">/pages/Hw2xNFYMmnN82pIEQ58q</a></td></tr></tbody></table>


# Dados Fiscais

A tela de Dados Fiscais centraliza as informações jurídicas da empresa para garantir a conformidade tributária e a automação de faturas e Notas Fiscais de Serviço (NFS-e).

### Identificação da Empresa (Dados Cadastrais)

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

Nesta seção, você insere as informações que identificam a sua empresa.

* **CNPJ:** Cadastro Nacional da Pessoa Jurídica.
* **Nome Registro da Organização:** Deve ser preenchido com o nome jurídico completo da empresa (Razão Social).
* **Nome Fantasia:** Nesse campo pode utilizar o nome fantasia da Empresa.
* **Inscrição Municipal:** Número de identificação do contribuinte no Cadastro Tributário Municipal.
* **Dias para vencer as faturas mensais:** Data para o vencimento da sua fatura mensal (A data de vencimento da fatura mensal será calculada com base no dia da criação da fatura + o valor selecionado nesse campo).
* **E-mails:** Endereços de e-mail para comunicação de cobrança e faturamento. Digite cada e-mail e pressione Enter ou clique no botão + para adicionar múltiplos destinatários.

### Endereço Completo

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

O endereço informado aqui deve ser, o endereço de registro do CNPJ, pois ele aparecerá no corpo das Notas Fiscais.

* **País:** País onde a empresa está legalmente registrada.
* **Estado (UF):** Unidade da Federação onde a empresa se localiza.
* **CEP:** Ao digitar o CEP, o sistema buscará automaticamente os dados de endereço.
* **Rua:** Logradouro da empresa (Rua, Avenida, Praça, etc.).
* **Número:** Numeração específica do imóvel. Caso a localidade não possua número, utilize a sigla "S/N".
* **Complemento:** Espaço para detalhamento adicional, como: "Andar 5, Sala 502", "Bloco B" ou "Conjunto Comercial".
* Bairro: Nome da divisão distrital onde a empresa está localizada.
* **Código da Cidade:** Código associado ao municipio que a empresa se localiza, caso não saiba basta entrar no link > [Código dos municipios](https://www.ibge.gov.br/explica/codigos-dos-municipios.php)
* **Cidade:** Nome do município correspondente ao endereço fiscal.

### 4. Opções fiscais

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

* **Tipo de Pagamento:** Selecione a modalidade preferencial para o pagamento das faturas mensais do Power Omni (ex: Boleto, Cartão).

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

* **Complemento (Opcional):** Campo para incluir informações adicionais que devem constar na descrição das notas fiscais.
  * *Exemplo: Incluir o número de um Pedido de Compras (PO) específico.*
* **Simples Nacional ou MEI:** Seleção do enquadramento fiscal da empresa.

### Termo de Aceite

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

* **Termos de Uso:** Ao clicar em "[<mark style="color:blue;">Termos de Uso</mark>](https://stpowergptprodeastus.blob.core.windows.net/public/termofuse.pdf)", o documento com as condições comerciais e de utilização do Power Omni ficará disponível para leitura. A seleção do campo "Eu li e aceito" é obrigatória para prosseguir.

Após preencher todos os campos, localize o botão Salvar no final da página.

{% hint style="danger" %}
⚠️ Observação Importante: Qualquer alteração futura nestes dados só terá efeito nas faturas geradas após a alteração. Caso precise corrigir uma Nota Fiscal já emitida, será necessário entrar em contato diretamente com o suporte após atualizar os dados nesta tela.
{% endhint %}

***

#### ✅ Por que manter estes dados atualizados?

* **Continuidade do Serviço:** Dados fiscais incorretos podem impedir o processamento do pagamento, levando à suspensão automática dos Agentes de IA.
* **Conformidade:** Garante que sua contabilidade receba os documentos corretos para dedução de impostos e prestação de contas.
* **Transparência:** Facilita a comunicação entre o suporte do Power Omni e o seu departamento financeiro.


# Configuração

A seção Configuração lida com as faturas referentes à configuração inicial da conta, como a taxa de onboarding.

Na Aba de Configurações você consegue gerenciar as faturas Iniciais.

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

* **Cobrança:** Nº de parcelas
* **Data de vencimento:** Data com o limite de pagamento de cada parcela.
* **Valor de cobrança:** Valor de cada parcela.
* **Status:** Se o pagamento já foi efetuado ou ainda consta pendente.

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

* **Ações:** Para cada cobrança, você pode **Ver NF** (Nota Fiscal) e **Ver link** para o pagamento.


# Faturas

A tela de Faturas oferece uma visão completa e transparente do consumo de recursos, planos de suporte e histórico financeiro da sua conta no Power Omni.

### Fatura Atual

Nesta seção, você encontra o detalhamento em tempo real dos custos acumulados para o ciclo de faturamento em aberto.

<figure><img src="/files/7i4YrCE3vaFJYAVK9vAG" alt=""><figcaption></figcaption></figure>

* **Mês e Ano:** Indica o mês vigente referente à fatura atual.
* **Valor por Licença:** Exibe o valor unitário de cada licença contratada no Power Omni.
* **Valor de Licenças Desativadas no Mês:** Refere-se às licenças que foram utilizadas durante parte do mês e desativadas posteriormente.
  * *Nota: Estas licenças são faturadas no mês vigente e serão removidas automaticamente do faturamento do próximo ciclo.*
* **Valor Total (Licenças):** O montante consolidado referente ao uso de licenças no período.

### Informações de Suporte

Detalha os custos adicionais relacionados ao nível de serviço e atendimento contratado.

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

* **Tipo de Suporte:** Identifica o plano ativo (Básico ou Enterprise).
* **Valor do Suporte:** Caso o plano escolhido seja o *Enterprise*, este campo detalha o valor fixo referente aos benefícios exclusivos deste nível.
* **Valor Total (Geral):** Soma do valor de todas as licenças (ativas e desativadas no mês) com o valor do plano de suporte.

### Licenças

Painel visual para controle rápido da volumetria de usuários na plataforma.

<figure><img src="/files/07UZZWPheBS87OV6LaFa" alt=""><figcaption></figcaption></figure>

* **Licenças Ativas:** Quantidade de usuários que possuem acesso ativo no momento.
* **Desativadas no Mês:** Quantidade de licenças que foram cortadas durante o ciclo atual.
* **Quantidade Total:** Soma de todas as licenças que geraram custo no mês vigente.
* **Ver Detalhes:** Botão que direciona para o resumo detalhado de faturamento, onde é possível validar os cálculos e valores aplicados.

<figure><img src="/files/40ghWb2Oafv6rzgI5CbV" alt=""><figcaption></figcaption></figure>

***

### 2. Faturas passadas

Histórico completo de ciclos anteriores para auditoria e controle contábil.

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

* **Resumo de Licenças:** Quantidade de licenças (Ativas, Desativadas e Total) daquele respectivo mês.
* **Tipo de Suporte:** Nível de suporte contratado no período correspondente.
* **Status:** Indicador visual da situação da cobrança:
  * 🟢 **Pago:** Pagamento confirmado.
  * 🟡 **Pendente:** Aguardando processamento ou compensação bancária.
  * 🔴 **Atrasado:** Vencimento expirado sem identificação de pagamento.

#### 🛠️ Ações Disponíveis

Ao lado de cada fatura, você tem acesso às ferramentas de gestão:

* **Ver NF:** Acesso direto ao documento auxiliar da Nota Fiscal de Serviço (NFS-e).
* **Ver Link:** Gera o link direto para a página de pagamento da fatura.
* **Ver Detalhes:** Abre o resumo detalhado do faturamento selecionado para conferência de itens.

***

### ✅ Importância da Gestão de Faturas

O acompanhamento regular desta tela garante a saúde operacional do seu projeto:

* **Prevenção de Pausas:** Identificar faturas pendentes evita a suspensão automática dos seus Agentes de IA.
* **Organização Contábil:** Facilita o acesso imediato a notas fiscais e comprovantes sem a necessidade de solicitar ao suporte.
* **Transparência:** Permite auditar os valores cobrados em cada ciclo mensal de forma clara.

***

{% hint style="info" %}

#### 💡 Nota

Lembre-se que as faturas são enviadas automaticamente para o E-mail de Cobrança configurado na tela de Dados Fiscais, mas ficam sempre disponíveis aqui para consulta e segunda via.
{% endhint %}


# Suporte

A tela de Suporte é o painel informativo onde a organização consulta os detalhes do seu nível de serviço atual e conhece as opções de planos disponíveis no Power Omni.

### Planos Disponíveis

Nesta área, são apresentadas as duas modalidades de suporte, permitindo que o administrador avalie se o nível atual atende às necessidades críticas do negócio.

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

#### Suporte Básico

Ideal para operações que buscam um atendimento padrão e eficiente para questões do dia a dia.

* Canais: Atendimento via e-mail ou sistema de tickets via plataforma.
* Escopo: Suporte técnico para dúvidas de uso, bugs e incidentes gerais.
* SLA (Prazo de Resposta): Tempo de resposta padrão conforme a fila de atendimento.

#### Suporte Enterprise

Desenhado para empresas com operações críticas que exigem prioridade máxima e disponibilidade estendida.

* Canais Prioritários: Acesso direto via canais ágeis (WhatsApp).
* SLA Diferenciado: Garantia de resposta e resolução em prazos reduzidos (SLA de resposta agressivo).

#### Acordo de Nível de Serviço (SLA)

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

O SLA define os prazos de atendimento e resposta para garantir a qualidade e a continuidade das operações. Ele estabelece tempos máximos para retorno em casos críticos, como **Indisponibilidade do Power Omni** e demais casos, assegurando transparência no suporte.

### Atualização de Plano (Upgrade)

Caso a empresa identifique a necessidade de um nível de suporte mais robusto:

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

* Ao final da tela temos a opção de fazer a migração do seu plano para o Enterprise, basta aceitar os termos e clicar em Contratar.
* Após isso só aguardar nossa equipe entrar em contato via email com os próximos passos.&#x20;

{% hint style="info" %}

#### 💡 Nota

Lembre-se que o valor do plano de suporte escolhido nesta tela é refletido automaticamente na sua Fatura Mensa.
{% endhint %}


# Personalização


# Logotipo

### 1. Visão Geral

A funcionalidade de Personalização de Logotipo permite que administradores do Power Omni customizem a identidade visual da interface, substituindo o logotipo padrão pela marca da própria empresa. Isso garante uma experiência de uso mais alinhada à identidade corporativa da empresa.

### 2. Localização no Sistema

Para acessar a configuração:

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

1. Navegue até o menu lateral esquerdo.
2. Expanda a seção Personalização.
3. Clique no submenu Logotipo.

### 3. Requisitos Técnicos da Imagem

Para garantir a melhor exibição e performance da plataforma, a imagem do logotipo deve seguir os seguintes parâmetros:

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

* Dimensões Mínimas: 200x200 pixels.
* Dimensões Máximas: 1000x1000 pixels.
* Tamanho de Arquivo: Máximo de 2MB.
* Formatos Suportados: PNG, JPG ou SVG.

### 4. Passo a Passo para Alteração

1. Na tela de Logotipo, localize a área de upload centralizada.
2. Clique no botão \[↑ Enviar Logotipo].
3. Selecione o arquivo desejado em seu diretório local.
4. Após o carregamento, a interface atualizará automaticamente o ícone exibido no canto superior esquerdo e em demais áreas pertinentes do Power Omni.

### 5. Observações Importantes

* Sincronização: A alteração é refletida para todos os usuários vinculados à organização.
* Proporção: Imagens excessivamente retangulares ou muito finas podem ser redimensionadas automaticamente para caber no container do menu superior; utilize imagens com proporções equilibradas para evitar distorções.


# SQL Server

Esta página detalha como funciona e como instalar a integração do Power Omni com o SQL Server

O Power Omni consegue se conectar com seu banco de dados através de Stored Procedures que você ou o seu time pode definir, permitindo que você tenha uma IA que consiga extrair ou inserir dados direto no seu banco de dados, através de uma lógica controlada e que une o melhor dos dois mundos: a inteligência artificial, decidindo o que executar e quando executar, e a segurança, onde você mantém o controle sobre o que ela vai ler ou modificar.

Para que isso funcione, você precisa subir uma API HTTP que fica entre o Power Omni e a sua instância SQL Server. Esta API é um serviço exclusivo fornecido gratuitamente aos clientes do Power Omni. Esta documentação vai te guiar as diferentes maneiras como você pode configurar esta API, seja com o seu SQL Server on-premises ou em nuvem.

Fazer o Power Omni conversar com o seu SQL Server, envolve basicamente as seguintes etapas:

1. [Criar o acesso na sua instância SQL Server](#criar-o-acesso-no-sql-server)
2. [Deploy da API da integração](#deploy-da-api-da-integracao)
3. [Conectar o Power Omni com a API](#conectar-o-power-omni)
4. [Criar e documentar as procedures](#criar-e-documentar-as-procedures)

O diagrama abaixo fornece um resumo  do fluxo de dados de como esta integração funciona:

{% @mermaid/diagram content="sequenceDiagram
Usuario->>PowerOmni: pergunta
PowerOmni->>PowerOmni: decide quais procedures usar
PowerOmni->>ApiIntegracao: https post run procedure {param1,param2,...}

```
ApiIntegracao->>InstanciaSqlServer: exec proc (conexão com o sql server)...
Actor VoceOuTimeDev
VoceOuTimeDev->>InstanciaSqlServer: Criar/alterar procedures



InstanciaSqlServer->>ApiIntegracao: resultados ou errors
ApiIntegracao->>PowerOmni: resposta JSON
PowerOmni->>Usuario: usa o resultado da procedure e gera a resposta

```

" %}

{% hint style="success" %}
Se você quiser entender toda a arquitetura dessa integração, veja a página [Arquitetura](/integracoes/sql-server/sql-como-funciona), onde há mais detalhes técnicos.&#x20;
{% endhint %}

### Criar o Acesso no SQL Server

O primeiro passo é você preparar a sua instância SQL Server. Basicamente, você vai precisar criar um banco de dados (ou pode usar algum já existente) e um Login e Senha.

{% hint style="success" %}
Recomendamos criar um banco de dados novo, para que você separe e tenha mais controle onde as procedures que o Power Omni vai invocar estão.
{% endhint %}

Aqui está um exemplo de um script SQL que cria um banco e usuário chamados PowerOmni (copie e cole no Management Studio, por exemplo):

```sql
-- Execute com um usuário que tenha permissões e/ou converse com o DBA para seguir as melhores práticas para o seu ambiente
USE master
GO
CREATE LOGIN PowerOmni WITH PASSWORD = 'AlgumaSenhaMuitoForte';
GO
CREATE DATABASE PowerOmni; -- Cria um banco onde o PowerOmni vai se conectar
GO
USE PowerOmni --> Muda o contexto pro banco PowerOmni
GO
CREATE USER PowerOmni FROM LOGIN PowerOmni; --> cria o user PowerOmni (mapeado para o login PowerOMni)
GRANT EXECUTE, VIEW DEFINITION TO PowerOmni; --> permissoes minimas necessarias
GO

```

O script acima cria tudo o que o PowerOmni vai precisar para que você faça um teste mínimo de integração. Lembre-se que você pode ajustar ou mudar os nomes, conforme preferência ou padrões da sua empresa. A única exigência são as permissões acima.

{% hint style="warning" %}
A APÍ da integração suporta apenas conexão SQL Authentication. Futuras versões poderão adicionar outras formas.
{% endhint %}

O último passo é garantir que sua instância SQL Server estará acessível para a API que você irá subir.  Identifique o nome ou a porta pelos quais a API irá acessar a sua instância. Pode ser que seja necessário envolver o seu time de rede para ajustar regras de firewall, NAT, VPN, etc.&#x20;

Se você for subir em uma VM ou container na sua própria infraestrutura, o SQL Server deve estar acessível para esse host. Se você for usar algum serviço em cloud, como o App Service do Azure, a sua instância precisa ser liberada para o range de IPs. Veja o próximo passo baixo para determinar o que se encaixa melhor para o seu cenário;

### Deploy da API da Integração

O PowerOmni não se conecta diretamente com a sua instância SQL. Ele precisa de um serviço intermediário, que é uma API criada pela Power Tuning que faz todo o trabalho de identificar as procedures e transformar em um formato que o PowerOmni consiga usar.

Você pode subir esta API de várias formas. Aqui [neste repositório GitHub](https://github.com/soupowertuning/power-omni/tree/main/conectores/mssql/exemplos), você tem alguns exemplos prontos com docker compose, que você pode usar para subir a API na sua própria infraestrutura (como em uma VM ou contêiner, por exemplo).

Nesta documentação, os seguintes guias podem te ajudar:

* [Deploy App Service no Azure](/integracoes/sql-server/api-deploy/azure-app-service) (com poucos cliques)
* [Usando docker com traefik](/integracoes/sql-server/api-deploy/docker-traefik) (mais avançado, mas permite subir na sua infraestrutura)

Você pode adaptar os exemplos, se quiser usar outros serviços, como nginx, kubernetes, etc.

Esse serviço gera logs na saída padrão, que você pode usar para debugar possíveis erros de conexão com o banco ou outros que possam ocorrer.

Quando você fizer o deploy da API, você terá:

* A URL da sua API (exemplo: <https://sqlpoweromni.exemplo.com>)
* Uma ou mais API KEYS para acessr a API

{% hint style="danger" %}

#### **SEGURANÇA DA API**

Quando você configura a API, você está fazendo o deploy dela na porta https 443, e protegida através de APIKEYS que foram configuradas por você ou geradas automaticamente.

É de suma importância que você garanta que nenhuma porta além da 443 ou 80 estejam liberadas.

Também, faça um controle rígido sobre as API KEYS geradas, guardando em cofre de senhas e evite compartilhar em vídeos, prints, etc. Você deve tratá-las como um dado sensível.

Caso você precise aplicar proteções adicionais, procure o suporte do Power Omni para dúvidas
{% endhint %}

### Conectar o Power Omni

Neste ponto, você já conseguiu subir a API da integração, e já possui as API KEYS necessárias para acessar o serviço.  Agora chegou a hora de testar a conexão com o seu Power Omni. Vamos assumir que a URL que você possui é *<https://poweromni.exemplo.com>* e que uma das apis keys é *Abc123*.

Primeiro, crie uma procedure no banco que você configurou, exemplo:

```sql
CREATE PROCEDURE spOmniGetDate --> Cria uma procedure para testar a integracao!
AS
SELECT DataAtual = GETDATE()
```

Vamos fazer o PowerOmni invocar essa procedure para obter a data atual do banco de dados.

Confirme que a integração consegue listar a procedure, acessando no seu navegador:

```
https://poweromni.exemplo.com/openapi?apikey=Abc123
```

Se você configurou o seu SQL corretamente e criou a procedure, o browser deverá exibir um JSON e em algum lugar você verá o nome da procedure (utilize o CTRL + F para buscar pelo nome). Se ele não retornou um JSON ou não retornou a procedure, verifique o log do serviço por erros.

Uma vez que você confirmou que o JSON está funcionando, vamos criar um conector do Tipo OpenAPI no PowerOmni.&#x20;

{% hint style="success" %}
Esta integração usa um recurso nativo do Power Omni: Conector de OpenAPI.&#x20;

Leia mais na doc do [conector de OpenAPI](/administracao-e-configuracao/artefatos/conectores/openapi) se quiser aprender mais sobre ele  e as configurações
{% endhint %}

Vá em: Configurações -> Artefatos -> Conectores. Crie um conector do tipo OpenAPI, e preencha os campos conforme a seguir:

| Campo                     | Como Preencher                                                                                                                                                                                                                                                                                               |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Projeto                   | Escolha em qual projeto criar                                                                                                                                                                                                                                                                                |
| Nome                      | Dê um nome ao conector. Só aceita letras maiúsculas ou minúsculas                                                                                                                                                                                                                                            |
| Descrição                 | Breve descrição. Exemplo: Execute procedures em um banco de dados SQL                                                                                                                                                                                                                                        |
| Tipo de Autenticação      | Escolha API Key, e em configuração da conexão, escolha "Criar Nova Conexão"                                                                                                                                                                                                                                  |
| Nome da Conexão           | <p>Em "nome da conexão", escolha um nome de sua preferência. Exemplo: SqlConector1<br><br>Depois clique em "Adicionar Chaves de API"</p>                                                                                                                                                                     |
| Nome Chave                | Digite "apikey", sem as aspas                                                                                                                                                                                                                                                                                |
| Valor Chave               | Cole o valor de umas das chaves de api key que você tem. No nosso exemplo, seria o Abc123                                                                                                                                                                                                                    |
| Em Especificação OpenAPI  | Escolha a opção "Automático"                                                                                                                                                                                                                                                                                 |
| URL Base                  | <p>Coloque apenas o domínio da API<br><https://poweromni.exemplo.com></p>                                                                                                                                                                                                                                    |
| Endpoint da Especificação | <p>Coloque o seguinte valor, trocando a apikey:<br><br>/openapi?reload=1\&apikey=Abc123<br><br>Clique em "Buscar especificação" e o PowerOmni vai tentar ler aquele mesmo JSON que você leu acima<br><br>Se não houve erros, ele vai retornar o json e você pode conferir clicando no botão "Ver Schema"</p> |

Uma vez que você preencheu tudo e o Schema foi carregado com sucesso, salve o conector. Neste ponto, o seu Power Omni já consegue identificar as procedures disponíveis.

Agora, basta associar esse conector com um Agente:&#x20;

* Vá em Artefatos -> Agentes
* Escolha o agente desejado (ou crie um novo)
* Nas instruções, certifique de colocar algo como: "Utilize as ferramentas para responder ao usuário"
* Em relacionamentos, clique em "Conectores" e escolha o conector que você criou.
* Confirme que você tem permissão no agente

Agora, vamos testar se o agente consegue identificar a lista de procedures. Abra uma nova conversa e pergunte: "Quais ferramentas estão disponíveis?".  Ele deverá listar o nome das procedures (ou algo semelhante).

Então, peça para ele executar a procedure, por exemplo: "Me de a data do banco". Neste momento, ele deve disparar a invocação da procedure de data, através do conector de SQL que você configurou.

Pronto! Seu Power Omni está conectado com sucesso com o seu SQL Server, e você pode começar a testar procedures mais avançadas, que recebem parâmetros, e obtem dados de outros bancos.

{% hint style="warning" %}
Se houve qualquer erro na execução da procedure, seja por falta de permissão, seja por lógica, a integração vai capturar o erro e logar na saída padrão. E vai enviar uma resposta pro omni, genérica, indicando que houve erro na execução. Então, o Power Omni vai gerar a resposta de algo relacionado ao erro.

Se o Power Omni gerar um alerta de erro (com um id), significa que houve outro erro no processamento e deve ser investigado.

Você pode contatar o time de suporte do Power Omni para te ajudar.
{% endhint %}

### Criar e Documentar as Procedures

Agora, seu Power Omni já está configurado e consegue chegar na sua instância. Os próximos passos são criar mais procedures para que seu Power Omni consiga realmente fazer algo de útil com os seus dados.

Como você deve ter notado, você deve criar as suas procedures com o prefixo spOmni. O nome da sua procedure pode conter apenas letras maiúsculas ou minúsculas e underline. Essas regras podem ser flexibilizadas em versões futuras.

Aqui está um exemplo de como você criar uma procedure que acessa um outro banco e traz informações de pedidos de um cliente:

```sql
CREATE PROCEDURE spOmniListarPedidos (
	@cliente varchar(100)	
	,@StartDate datetime = NULL
	,@EndDate datetime = NULL
)
AS 
/*omni
description: Lista os pedidos de um dado cliente e um mes específico
params:
  cliente: O nome do cliente
  StartDate: "A data de inicio do pedido, no formato YYYYMMDD HH:mm:ss. Se não informado obtem as ultimas 24h"
  EndDate: "A data de fim do pedido, no formato YYYYMMDD HH:mm:ss. Se não informado, usa a data atual"
*/

IF @StartDate IS NULL 
	SET @StartDate = DATEADD(HH,-24,GETDATE())

IF @EndDate IS NULL 
	SET @EndDate = GETDATE()

SELECT
	 IdPedido
	,ValorTotal
	,DataEntrega
FROM
	Vendas.dbo.Pedidos P
	JOIN
	Vendas.dbo.Clientes C
		ON C.id = P.id_cliente
WHERE
	C.nome = @cliente
```

A procedure acima apresenta alguns elementos novos que não foram mostrados até agora:

* Agora há uma lista de parâmetros. O modelo de IA que você escolheu no Power Omni vai conseguir enviar o valor dos parâmetros conforme o contexto da conversa e as instruções do agente. E o conector de SQL é o responsável por montar o código SQL seguro que vai ser invocado, passando os parâmetros com o tipo de dados adequado
* Um comentário foi adicionado, logo início do corpo da procedure. Esse comentário é usado pelo conector de SQL para gerar a documentação que o Power Omni precisa. Essa documentação ajuda o seu agente a ter mais informações sobre a procedure, e como deve usá-la. Esse comentário é um código YAML (não use tabs para identação).&#x20;

Se você tentar invocar essa procedure no seu agente, ele não vai conseguir, por 2 motivos:

1. Você precisa atualizar o schema indo em Configurações -> Artefatos -> Conectores -> Escolher o conector, clicar no ícone de edição, e no final da página, clicar em 'Buscar especificação'.
2. Você precisa conceder as permissões para o Login. No caso, agora ele vai precisar acessar o banco Vendas, tabelas Pedidos e Clientes. Você precisa conceder as permissões (ou solicitar ao time responsável pelo banco)

Agora que você atualizou o metadado e permissões, basta ir ao agente. Neste caso, se eu perguntar "Me de os pedidos do cliente ContosoCorp", ele vai invocar passando esses filtros. Para mais detalhes sobre o uso de Procedures, incluindo dicas e exemplos, veja o[Guia de Procedures](/integracoes/sql-server/guia-de-procedures)


# Deploys da API

Esta seção documenta as opções de deploy da API do Conector de SQL

O Conector de SQL funciona através de um serviço que você coloca entre o Power Omni e a sua instância SQL Server.

Este Serviço é responsável por:

* Expor as procedures de um banco como um schema OpenAPI
* Prover endpoints HTTP para a execução dessas procedures
* Converter o resultado das execuções para um formato aceitável pelo Power Omni (incluindo erros do banco)

O desenvolvimento e manuntenção desse conector é de responsabilidade da Power Tuning, mas é você, ou seu time, que decide como e onde vai executá-lo.

Ele é uma aplicação Node.Js, que está disponível através de uma imagem docker linux, o que facilita você fazer o deploy em praticamente qualquer ambiente, cloud ou on-premises.

Esta seção traz alguns guias de como fazer os deploys, para que você tenha norte. Utilize a navegação lateral e escolha o método que for melhor para você

## Sobre a Imagem Docker

A API do serviço de integração é disponibilizada em uma imagem docker montada pelo time da Power Tuning. Independente da maneira como você for fazer o deploy, as mesmas variáveis de ambiente estão disponíveis para a configuração. Veja a  tabela abaixo:

<table><thead><tr><th width="171">Variável</th><th>Descrição</th></tr></thead><tbody><tr><td><code>SQL_CONNECTION</code></td><td>String de conexão com a instância SQL Server</td></tr><tr><td><code>PUBLIC_URLS</code></td><td>URL pública pelo qual a API estará acessível. O serviço vai gerar o OpenAPI schema usando essa URL e é ela que o omni vai usar quando for invocar a procedure</td></tr><tr><td><code>KEYS</code></td><td>Lista de ApiKeys separados por um ";".  Use valores aleatórios e fortes. Para reforçar a segurança, pode-se usar outros serviços que geram a apikey com criptografia</td></tr><tr><td><code>CUSTOM_AUTHSCHEME</code></td><td>String com um yaml especificando um Auth Scheme alternativo que será usado ao gerar o OpenAPI Schema. Use apenas se precisar usar outro tipo de autenticação que não seja ApiKey. É uma configuração avançada para ser feito com o apoio da Power Tuning</td></tr><tr><td><code>AUTO_RELOAD</code></td><td>Altera o AutoReload, especificando a frequência, em millisegundos, que a API vai carregar as procedures modificadas. Com base nesse tempo, a API frequentemente consulta o banco identificando as procedures que foram modificadas e recriando o schema. </td></tr></tbody></table>


# Azure App Service

Descreve como fazer o deploy da API de integração com o SQL Server Usando o App Service

O Azure App Service é um serviço do Azure em que você pode facilmente subir aplicações web usando imagens docker. Este é o jeito mais rápido de subir a API da integração se a sua instância SQL consegue estar disponível para o Range de IPs do Azure.

## Pré-Requisitos

1. Solicite o Registry Password no seu canal de suporte do Power Omni. Você vai precisar informá-lo
2. Prepare a string de conexão para sua Instância SQL

```
Server=endereco,porta;Database=NomeBanco;User Id=NomeLogin;Password=TroquePorUmaSenhaForte


```

## Passo a Passo

Para iniciar o processo, [clique nesse link](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fsoupowertuning%2Fpower-omni%2Frefs%2Fheads%2Fmain%2Fintegracoes%2Fmssql%2Fazdeploy.json), que vai abrir um formulário no seu portal do azure.

Preencha os campos: Assinatura, Resource Group, String Conexão e Registry Password com as informações que você preparou no pré-requisito. &#x20;

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

| Campo                                      | Orientações                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Subscription<br>Assinatura</p>          | Escolha a assinatura onde vai criar o recurso                                                                                                                                                                                                                                                                  |
| <p>Resource Group<br>Grupo de Recursos</p> | Escolha em qual resource group vai criar o App Service. Você pode escolher o mesmo onde instalou o Power Omni (geralmente possui poweromni no nome)                                                                                                                                                            |
| String Conexao                             | <p>Coloque a String de Conexão, conforme você preparou nos pré-requisitos. Você pode alterá-la depois, se precisar. <br><br>Se a instância ainda não está pronta, não tem problemas. Pode preencher a string de conexão com os valores que você planejar criar no sql ou deixar vazios para alterar depois</p> |
| Registry Password                          | Este é um token para que você consiga baixar a imagem criada pela Power Tuning. Peça no seu canal de suporte.                                                                                                                                                                                                  |

Os demais campos pode deixar como está. Altere somente se você entende o que está fazendo ou sob orientação do time do Power Omni.

Então, clique em Review +Create (Examinar + Criar), e em seguida no botão Criar/Create:

{% hint style="success" %}
Por padrão, o plano usado é o mais barato do Azure. Confira os preços aqui: <https://azure.microsoft.com/en-us/pricing/details/app-service/linux/>
{% endhint %}

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

O Azure vai fazer algumas validações quando você clicar neste botão. Se algum erro for retornado, você deve procurar ou administrador da sua conta do Azure ou o seu parceiro para ajudar a solucionar

{% hint style="success" %}
A [Azure Brasil](https://www.azurebrasil.cloud/) fornece serviços exclusivos que podem te ajudar a configurar e resolver problemas na sua conta no Azure, além de conseguirem preços especiais nas assinaturas.

Se você precisar de apoio com seu Azure, procure no canal de suporte do omni que conseguimos te colocar em contato com o time da Azure Brasil.
{% endhint %}

Se não houve erros na validação, o processo vai seguir e deve ser concluido em alguns minutos. É só aguardar.

Quando for concluído, você vai ver uma tela parecida com esta:

<figure><img src="/files/9i0MBkj3hiEwBiBdcwDG" alt=""><figcaption></figcaption></figure>

Clique em "Deployment Details", e clique no link referente ao recurso do tipo Microsoft.Web/sites:

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

Isso vai te levar para a página principal do seu App Service. Neste momento, ele deve estar tentando fazer o donwload da imagem docker do registro da Power Tuning. Para consultar o progresso, vá na lateral, em Settings -> Instances:

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

Se tudo ocorreu bem, você vai ver uma tela parecida com esta:

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

Caso tenha ocorrido erros, você vai ver nessas colunas de status. O erro mais provável é que o token que você forneceu possa estar incorreto (expirado, pode ter colado com algum caracter a mais, como um espaço ou quebra de linha, etc.). Caso tenha problemas aqui, procure o suporte do Power Omni.

Acessando a tela de overview, você poderá obter a URL da sua API. Clique nela para saber se o deploy jpa foi feito:

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

No exemplo acima, a url é: <https://poweromni-sql-7db5twmqfrol4.azurewebsites.net/>

Basta clicar nela, e uma nova janela do brower deverá ter sido aberta com a mensagem "Não autorizado!"

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

Isso indica que a instalação foi feito com sucesso, e você está recebendo esta mensagem porque não informou nenhuma API KEY.

Se aparecer "não autorizado" é porque o deploy foi feito com sucesso. Se ele demorar para carregar ou aparece outro erro que não seja a mensagem de autorização, ele pode estar fazendo o deploy ainda ou houve algum erro. Você pode tentar debugar pelos logs do App Service ou pedir apoio ao suporte do Power Omni.

### Configurações

Se você recebeu a mensagem de não autorizado é porque o serviço subiu e você precisa informar as ApiKeys.  Elas foram geradas aleatoriamente durante o deploy, e você vai encontrar indo no seu seu App Service -> Settings -> Environment Variables.

<figure><img src="/files/QOjAPXRddApjlgbkrwFG" alt=""><figcaption><p>Você pode clicar em "Show value" para ver o valor. </p></figcaption></figure>

Aqui é onde se encontram as configurações do seu App Service.

* A env KEYS contém a lista de keys geradas. Por padrão, 4 keys são geradas, cada uma separado por um ponto vírgula. Escolha uma delas para usar como teste, e acessa a url, passando https\:/../apikey=ApiKeyEscolhida.

  <figure><img src="/files/rTwum98Snb8utckOlaBl" alt=""><figcaption><p>Exemplo de keys criadas aleatoriamente</p></figcaption></figure>

  * Se você passou a api key certa, a mensagem de erro não autorizado irá mudar, e um texto "working" com um número de versão serão retornado

  <figure><img src="/files/aVouRfScRYG73u85qjEb" alt=""><figcaption></figcaption></figure>
* A env SQL\_CONNECTION, contém a string de conexão com o seu SQL Server. Se você precisa mudar algo, basta ajustar aqui.

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

{% hint style="warning" %}
[**IMPORTANTE: JAMAIS COMPARTILHAR ESSAS CONFIGURAÇÕES**](#user-content-fn-1)[^1]

Estes dados que você informou ou que foram gerados, são sensíveis. São dados que somente sua aplicação ou PowerOmni devem ter acesso (você configura a apikey ao configurar o conector no PowerOmni).

Então, jamais compartilhe como em prints acima.&#x20;

Para este guia, os compartilhamentos foram feitos, mas esse app service criado foi de teste e não existe mais. No seu caso, como será usado em produção, você jamais deve fazer algo parecido.
{% endhint %}

Você pode alterar qualquer umas dessa variáveis a qualquer momento (isso vai causar um restart do seu web app, e pode causar erros esporádicos no omni se ele tentar invocar enquanto ele faz o restart).

Para visualizar os da sua app, vá em Log Stream:

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

Neste log você consegue ter acesso a todos os logs que a API desta integração gera, incluindo os erros. Se algum usuáro estiver tendo problemas com as respostas, como erros que ocorrem no banco, ou a se conectar com ele, esse log pode ser de grande ajuda!

Em todo o caso, se tiver dificuldades, procure o suporte do Power Omni!

### Regras de Firewall com o SQL Server

É comum que você precise limitar a conexão com o seu SQL Server através de regras de firewall. Caso você precise liberar uma faixa de IPs, você pode obter a lista pelo quais os IPs da sua App Service saem usando o menu Settings -> Networking (configurações -> rede):

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

No canto direito dessa tela, você terá a lista de endereços que precisa liberar, pois a conexão com sua instância SQL pode sair por qualquer um deles. Clique em "Show more" para ver a lista completa.

Se você precisa isolar mais os números de IPs, você vai precisar fazer configurações mais avançadas de rede com o seu App Service. Procure o seu time responsável pela segurança no Azure para te ajudar.Se você não possui, pode solicitar uma consultoria do time da Azure Brasil, que é parceiro da Power Tuning. É só solicitar no seu grupo de suporte que colocamos em contato.

## Próximos passos

Agora que você já sabe como obter a URL da sua API e a APIKEY,[ pode prosseguir com a configuração no Power Omni](/integracoes/sql-server#conectar-o-power-omni)!

[^1]:


# Docker e Traefik

Será atualizado em breve...


# Arquitetura

Descreve como funciona o conector com o SQL Server

Esta página é contém alguns detalhes mais técnicos de como a Integração do SQL Server com o Power Omni funciona. Utilize como uma referência para entender todos os aspectos para que você saiba exatamente o que está configurando no seu ambiente.

Basicamente, a integração é um serviço de API que fica entre o Power Omni e a instância SQL Server. Este serviço é responsável por expor as procedures de um banco de dados como API, permitindo que que elas sejam executadas através de chamadas HTTPS POST, passando os parâmetros como um JSON.

O seguinte diagrama mostra o fluxo de dados que ocorre, e por quais componentes passam, quando o Power Omni decide invocar uma procedure de uma instância SQL:

{% @mermaid/diagram content="
sequenceDiagram
actor Usuario
Usuario ->> PowerOmni: Pergunta

```
PowerOmni ->> Conector OpenAPI: Proc {param1,param2}

Conector OpenAPI ->> ApiSql: HTTPS POST /spOmniProcName + ApiKey

ApiSql ->> InstanciaSqlServer: EXEC ProcName @Param ...
InstanciaSqlServer ->> ApiSql: ResultOuErro
ApiSql ->> Conector OpenAPI: Resultado

Conector OpenAPI ->> PowerOmni: Resultado 

PowerOmni -> Usuario: Resposta
```

" %}

## Como o Power Omni acessa as Procedures

O Power Omni não tem acesso direto ao seu banco.  Quem conecta no banco, é o serviço de API criado pela Power Tuning, e que você configura na instalação.

Esse serviço conecta na instância (usando as informações da string de conexão), obtém as procedures e gera um schema OpenAPI com base nos metadados e comentários de cada procedure. Esse é o schema que você configura nos conectores do Power Omni.

Esse schema é associado com um conector do tipo OpenAPI, suportado nativamente pelo Power Omni. É aqui que está a mágica que faz o seu Power Omni conhecer suas procedures: Graças ao conector de OpenAPI e ao serviço que traduz as procedures para um schema OpenAPI, nós conseguimos criar uma ponte com o seu banco de dados. E o efeito que temos é esse: Um agente que conhece as suas procedures e parâmetros, que podem ser invocadas via HTTPS.

<img src="/files/1es41Ahi2XYP3oITKwhi" alt="" class="gitbook-drawing">

## Como a API acessa a Instância SQL

Agora que você entende o papel do serviço de API, é importante conhecer melhor como ela funciona.&#x20;

Conforme a imagem anterior, a API fica entre o Power Omni e sua instância SQL. É ela quem, de fato, consegue chegar no seu SQL Server. E você faz na configuração, onde coloca a string de conexão com o seu SQL Server.

Ou seja, todas as permissões que ela usa estão sob seu controle e/ou do time que gerencia o banco de dados. O que o serviço o tempo inteiro é:

* Listar as procedures que ele tem acesso e criar os endpoints
* Executar as procedures quando o Power Omni pede

Um dos principais pontos que nos guiamos para desenvolver uma solução que usasse apenas procedures, e não código SQL gerado pela IA, é a questão de segurança. Definindo procedures previamente, você tem o total controle sobre que código é executado no seu banco de dados. O Power Omni vai apenas solicitar a invocação de procedures conforme os parâmetros da mesma, e é de sua responsabilidade criar o código da procedure. Isso traz vantagens e desvantangens:

* Vantagens
  * Não tem o risco da IA executar comandos perigosos ou que podem causar alguma lentidão
  * Reduz a chance de alucinação nas respostas, já que você pode guiar para o correto resultado
  * Você tem total controle sobre quais objetos e comandos T-SQL serão executados
* Desvantagem

  * A IA não tem liberade para montar e descobrir tabelas dinamicamente
  * Você precisa criar o código e lógica

{% hint style="warning" %}
Mesmo com procedures, você ainda pode deixar seu agente no Power Omni livre para executar consultas, criando uma procedure que, por exemplo retorna as tabelas e descrições do banco, e outra que roda um comando SQL. Apesar de não ser uma prática que recomendamos nesta versão da integração ainda.

Em futuras versões, podemos trazer soluções melhores que combinem respostas mais precisas com maior liberdade e segurança para os seus agentes! Fique ligado!
{% endhint %}

### Segurança da API

Conforme mencionado, a API é uma aplicação web com Node.Js. Nativamente, ela apenas escuta nos endpoints HTTP e faz algumas operações periodicamente. Ela também suporta as definições de API KEYS usando variáveis de ambiente, que podem ser trocadas facilmente.

Porém, você pode adicionar várias camadas de segurança. A mais simples e obrigatória é colocar atrás do protocolo HTTPS, já que o Power Omni não aceita um protocolo diferente no conector de OpenAPI. Os guias de deploy desse artigo sempre te mostram como fazer o deploy usando HTTPS e com API KEYS.

Você pode incrementar a segurança conforme as políticas da sua empresa de várias maneiras:

* Colocar sob o seu firewall, proxy, etc e limitar o range de IPs
* Adicionar checks de rate limit ou tentativa de acesso de força bruta

Nosso time também constatemente fará as revisões de segurança, procurando manter o core atualizado, robusto e seguro.


# Guia de Procedures

Contém um guia de como usar as procedures no conector de SQL

Será atualizado em breve...