> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/inteligencia-artificial/weknow-ask/como-utilizar-o-weknow-ask.md).

# Como utilizar o Weknow Ask

O Weknow Ask permite realizar consultas sobre os dados utilizando perguntas em linguagem natural. Para iniciar uma conversa no Weknow Ask, selecione o **Contexto de dados** que será utilizado e, quando aplicável, defina o **Provedor de IA**. Caso o provedor já esteja definido pelas configurações do ambiente, ele será utilizado automaticamente. Quando aplicável, informe também os parâmetros solicitados pelo metadado.

{% hint style="success" %}
**Importante:** O **Weknow Ask** é uma funcionalidade adicional, disponibilizada mediante contratação específica. Para consultar as condições comerciais, entre em contato com nossa equipe pelo artigo [Conheça os recursos de Inteligência Artificial](/wedocs-5.2/inteligencia-artificial/conheca-os-recursos-de-inteligencia-artificial.md).
{% endhint %}

### Como acessar

Para iniciar uma nova conversa:

1. Acesse o Weknow Ask.
2. Na tela inicial, selecione o **Contexto de dados** que será utilizado na conversa.
3. Confira o **Provedor de IA** definido para a conversa. Quando necessário, selecione um provedor disponível.
4. Preencha os parâmetros do metadado, quando forem apresentados.
5. Clique em **Criar conversa**.

{% hint style="info" %}
A disponibilidade do Weknow Ask e dos contextos de dados depende das permissões e configurações definidas para o ambiente. O usuário somente poderá selecionar metadados autorizados para utilização como fonte de dados de IA.
{% endhint %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FFkMskKsuRM87sf306HTM%2FComo%20utilizar%20o%20Weknow%20Ask%2001.gif?alt=media&amp;token=f1024c93-6da9-42df-80c1-bfd8f59e6724" alt=""><figcaption></figcaption></figure>

***

### Selecionando o Contexto de dados

O **Contexto de dados** corresponde ao metadado que será utilizado como fonte para a conversa.

Para selecionar um contexto:

1. Clique no campo **Contexto de dados**.
2. Localize o metadado que deseja utilizar.
3. Se necessário, utilize a pesquisa para localizar o contexto.
4. Selecione o metadado.

A lista apresenta somente os metadados para os quais o usuário possui permissão **Utilizar como fonte de dados de IA**. Metadados sem essa permissão não são disponibilizados para seleção ou pesquisa.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FqjJsMj1l1NhJGhIVfxdm%2FSele%C3%A7%C3%A3o%20do%20Contexto%20de%20dados%20no%20Weknow%20Ask..gif?alt=media&amp;token=c41382eb-1457-4325-a4b7-a415c8d09ae5" alt=""><figcaption></figcaption></figure>

***

### Definindo o Provedor de IA

O **Provedor de IA** utilizado na conversa é definido de acordo com as configurações disponíveis no ambiente.

Quando houver um provedor configurado em **Parâmetros > Ask**, ele será utilizado nas novas conversas.

Caso não exista um provedor definido em **Parâmetros > Ask**, será utilizado o provedor marcado como padrão no cadastro de provedores de IA.

Quando não houver um provedor padrão e houver mais de um provedor disponível, será necessário selecionar o provedor que deseja utilizar.

Quando houver apenas um provedor cadastrado, ele será utilizado automaticamente e o campo de seleção não será apresentado.

Caso não exista nenhum provedor cadastrado, o sistema apresentará uma mensagem informando a situação.

{% hint style="info" %}
Para mais detalhes sobre a configuração de provedores de IA, consulte o artigo [Broken mention](broken://pages/N7F8CuWDuEXUmCQxxgS6).
{% endhint %}

{% tabs %}
{% tab title="Sem provedor padrão" %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FTY1ZqUguikPh61XAFEb8%2Fimage.png?alt=media&amp;token=85ad3412-e513-47e6-b637-7cbee3aff1e4" alt=""><figcaption><p>Neste exemplo, não há provedor pradrão configurado.</p></figcaption></figure>
{% endtab %}

{% tab title="Com provedor padrão" %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FxbuE9dBD8nxYYVJ698Ad%2Fimage.png?alt=media&amp;token=b470accd-d323-4edd-8ec1-4cf79f00912c" alt=""><figcaption><p>Neste exemplo, não é possível selecionar o provedor, póis está configurado com um padrão.</p></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Consulte o artigo [Broken mention](broken://pages/N7F8CuWDuEXUmCQxxgS6) para obter maiores detlahes sobre parametrização de provedores.
{% endhint %}

***

### Informando os parâmetros do metadado

Alguns metadados possuem parâmetros que precisam ser informados antes da criação da conversa.

Quando existirem parâmetros configurados para o metadado selecionado, eles serão apresentados abaixo do campo **Provedor de IA** e antes da opção **Criar conversa**.

Preencha os parâmetros conforme as informações solicitadas.

Os campos podem apresentar regras específicas, como:

* preenchimento obrigatório;
* valor padrão;
* formato;
* intervalo permitido;
* valores permitidos.

Quando houver um parâmetro obrigatório sem valor padrão, será necessário informá-lo antes de criar a conversa. Enquanto existir um parâmetro obrigatório vazio ou inválido, a conversa não poderá ser criada.

Quando o metadado não possuir parâmetros configurados, nenhum campo adicional será apresentado.

**Imagem 4: Parâmetros do metadado apresentados antes da criação da conversa.**

***

### Criando uma conversa

Depois de selecionar o **Contexto de dados**, definir o **Provedor de IA** e preencher os parâmetros necessários:

1. Confira o **Contexto de dados** selecionado.
2. Confira o **Provedor de IA** definido para a conversa, quando apresentado.
3. Preencha os parâmetros necessários, quando houver.
4. Clique em **Criar conversa**.
5. Aguarde a abertura da conversa.

<div><figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F5jzXJj2tQaQzM1KdOPrd%2Fimage.png?alt=media&amp;token=4badb1ba-8e8e-4b25-aa79-e8080d9cce54" alt=""><figcaption></figcaption></figure> <figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FIaAmYFUS8G0y5Q80TZ88%2Fimage.png?alt=media&amp;token=925c4941-37f5-4913-9e5a-b48e7a482ec0" alt=""><figcaption></figcaption></figure></div>

***

#### Alterações no provedor

O provedor utilizado é associado à conversa no momento de sua criação.

Alterações posteriores na configuração do provedor não alteram o provedor associado às conversas existentes. As novas configurações serão consideradas somente na criação de novas conversas.

***

### Fazendo perguntas

Na conversa, utilize o campo de digitação para realizar perguntas relacionadas às informações disponíveis no contexto selecionado.

Digite a pergunta utilizando linguagem natural e envie a solicitação.

Por exemplo:

> Quantos atendimentos foram realizados no período?

Ou:

> Qual unidade apresentou o maior volume de atendimentos?

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FWamxSrbJ8x3BhpUAfrmB%2FComo%20utilizar%20o%20Weknow%20Ask%2003.gif?alt=media&amp;token=6f8e2935-6836-4265-87b8-1534ca9d9356" alt=""><figcaption></figcaption></figure>

A Inteligência Artificial interpreta a pergunta considerando o metadado selecionado, seus parâmetros e as informações de contexto disponíveis para a consulta. A resposta deve ser compatível com os dados retornados pelo metadado e com os filtros aplicados.

***

### Continuando a conversa

Após receber uma resposta, você pode realizar novas perguntas para continuar explorando as informações.

A conversa pode considerar as informações das interações anteriores para orientar a continuidade da consulta, conforme o contexto disponível.

Quando necessário, a Inteligência Artificial pode:

* sugerir perguntas relacionadas ao contexto selecionado;
* solicitar informações complementares;
* solicitar o preenchimento de filtros necessários antes de executar a consulta.

As sugestões apresentadas devem estar relacionadas ao metadado selecionado.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FcohWz2ilq38hFz67Wu5q%2Fimage.png?alt=media&amp;token=738aeb15-f5ac-4025-abbb-fca4e210229a" alt=""><figcaption></figcaption></figure>

### Consultando as informações do metadado

Durante a conversa, a interface disponibiliza a aba **Metadado**, na qual podem ser consultadas informações sobre o contexto utilizado.

A aba apresenta informações como:

* identificação do metadado;
* quantidade de campos;
* data de atualização;
* descrição;
* pesquisa de campos;
* tabela de campos.

A tabela apresenta informações como **Título**, **Nome** e **Tipo** dos campos.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FSpF9XqyMWmfFQ1tJGmsS%2Fimage.png?alt=media&amp;token=3cccc9ed-da2d-4ec0-8bc9-cb7d027d0980" alt=""><figcaption></figcaption></figure>

***

#### Barra lateral de conversas

A barra lateral reúne as principais opções para gerenciamento e navegação das conversas no **Weknow Ask**, como **Nova conversa**, **Pesquisa**, **Pastas** e **Chats**.

Com a nova opção, o usuário também poderá **recolher ou reabrir a barra lateral**, permitindo ampliar a área disponível para visualização da conversa quando necessário.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FU2PwXl0eJ7LBFFrlkYgd%2Fesconder%20menu%20lateral%20ask.gif?alt=media&amp;token=16d67da2-63ca-47cc-a4fa-7bf108264bd0" alt=""><figcaption><p>Expandindo e recolhendo o menu de chats</p></figcaption></figure>

***

### Consultando o histórico de conversas

As conversas realizadas no **Weknow Ask** ficam disponíveis no histórico apresentado no painel lateral da funcionalidade.

Para acessar uma conversa anterior:

1. Localize a conversa no painel lateral.
2. Clique na conversa que deseja consultar.
3. A conversa será apresentada na área principal.

O histórico permite ao usuário acessar novamente as conversas realizadas anteriormente no Weknow Ask, além de poder retomá-las quando necessário.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FjVOl9O9531iLpnD5VMcA%2Fimage.png?alt=media&amp;token=92d2309e-6db5-4008-82f1-0b16fff0e8be" alt=""><figcaption></figcaption></figure>

#### Alterando o título de uma conversa

É possível alterar o título de uma conversa já criada para facilitar sua identificação no histórico.

Para alterar o título:

1. Localize a conversa no painel lateral.
2. Clique no menu de opções **(...)** da conversa.
3. Selecione a opção **Renomear**.
4. Informe o novo título da conversa.
5. Confirme a alteração.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FUJV5ZxFL73t92F3FNxJi%2Fimage.png?alt=media&amp;token=4164971f-1a9a-457e-bcee-37c30dc1a2c5" alt="" width="401"><figcaption></figcaption></figure>

O novo título será apresentado no histórico de conversas.

***

### Importante

A utilização do Weknow Ask depende das configurações de acesso, das permissões do usuário, da disponibilidade de um provedor de IA e dos limites de utilização definidos para a função.

Ter acesso ao Weknow Ask não concede automaticamente permissão para utilizar todos os metadados como contexto de dados. Da mesma forma, possuir limite de utilização disponível não concede permissão para acessar um metadado sem a respectiva autorização.

***

### Saiba mais

Para conhecer o funcionamento do Weknow Ask e os conceitos relacionados à funcionalidade, consulte **Weknow Ask**.

Para conhecer as configurações relacionadas às funcionalidades de Inteligência Artificial, consulte [Configurações de Inteligência Artificial](/wedocs-5.2/inteligencia-artificial/configuracoes-de-inteligencia-artificial.md).