> 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.md).

# Weknow Ask

O **Weknow Ask** é uma funcionalidade do Weknow que utiliza Inteligência Artificial para permitir a interação com dados por meio de perguntas realizadas em linguagem natural.

Diferentemente da **Análise Inteligente**, que parte das informações apresentadas em um dashboard, o Weknow Ask utiliza um **Contexto de dados** como base para a conversa. Esse contexto corresponde a um metadado que fornece à Inteligência Artificial as informações necessárias para interpretar e consultar os dados.

A partir do contexto selecionado, o usuário pode realizar perguntas, solicitar informações e continuar a conversa de acordo com os resultados apresentados.

{% hint style="success" %}
**Importante:**

As funcionalidades **integradas à Inteligência Artificial (IA)** são disponibilizadas **como recurso adicional, mediante contratação específica**.

Para consultar as condições comerciais e contratar essas funcionalidades, entre em contato com nossa equipe:

* **E-mail:** <contato@weknowhealthtech.com.br>
* **WhatsApp:** [(11) 96835-0516](https://wa.me/5511968350516?text=Ol%C3%A1%21%20vi%20o%20WeDocs%20sobre%20funcionalidades%20integradas%20com%20IA%20e%20gostaria%20de%20saber%20mais%20sobre%20contrata%C3%A7%C3%A3o%20deste%20recurso)
  {% endhint %}

<div><figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FawrwYgP85ciq0yxEtDlB%2Fimage.png?alt=media&amp;token=c6802ff3-d496-449f-ad44-87edaf353d5d" alt=""><figcaption></figcaption></figure> <figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FqiqWVVvPC5KF50wBrXFj%2Fimage.png?alt=media&amp;token=4ae3fde2-dae7-4410-a95f-552519ae7ea0" alt=""><figcaption></figcaption></figure></div>

Os resultados gerados pela Inteligência Artificial devem ser utilizados como apoio à análise das informações e avaliados de acordo com o contexto dos dados. A funcionalidade não substitui a análise ou a tomada de decisão dos profissionais responsáveis.

***

### Como o Weknow Ask pode ajudar

O Weknow Ask permite consultar informações utilizando perguntas em linguagem natural, sem a necessidade de conhecer a estrutura técnica dos dados.

A interação por meio de uma conversa permite explorar as informações de forma mais dinâmica, fazendo novas perguntas com base nas respostas obtidas.

Entre as possibilidades de utilização estão:

* consultar informações disponíveis nos dados;
* fazer perguntas utilizando linguagem natural;
* explorar diferentes aspectos das informações;
* solicitar esclarecimentos ou informações complementares;
* continuar a conversa a partir dos resultados apresentados;
* utilizar o contexto dos dados para orientar as respostas da Inteligência Artificial.

***

### Como funciona o Weknow Ask

De forma simplificada, o funcionamento do Weknow Ask ocorre a partir da seleção de um contexto de dados e de um provedor de Inteligência Artificial.

O fluxo pode ser representado da seguinte maneira:

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FdqcG8KZ0VWhermxvqNxD%2Ffluxo%20ask.png?alt=media&amp;token=1e085da5-399d-4fb2-923c-410ab4261175" alt=""><figcaption><p>Fluxo de funcionamento do Weknow Ask</p></figcaption></figure>

### Contexto de dados

O **Contexto de dados** corresponde ao metadado utilizado como base para a conversa.

O metadado fornece informações sobre os dados que podem ser consultados, permitindo que a Inteligência Artificial compreenda sua estrutura e utilize essas informações para interpretar as perguntas realizadas pelo usuário.

O contexto também pode conter informações adicionais destinadas a orientar a interpretação dos dados, como regras de negócio, termos utilizados pela organização, cálculos e outras orientações.

{% hint style="warning" %}
Para que um metadado possa ser utilizado como Contexto de dados no Weknow Ask, o usuário deve possuir a permissão **Utilizar como fonte de dados de IA** para esse metadado.
{% endhint %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2Fbez242T50ky4dh7sEWFe%2Fimage.png?alt=media&amp;token=ba1d7abc-9796-40d9-811c-eb703ed3414c" alt=""><figcaption></figcaption></figure>

***

### **Provedor de IA**

O **Provedor de IA** é o serviço de Inteligência Artificial utilizado para processar as solicitações realizadas durante a conversa.

O provedor utilizado pelo Weknow Ask é definido de acordo com as configurações realizadas no ambiente. Quando houver um provedor configurado no **Weknow Desktop**, em **Configurações > 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 definido e houver mais de um provedor disponível, o usuário poderá selecionar um provedor ao criar a conversa.

Quando houver apenas um provedor disponível, ele será utilizado automaticamente.

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

As configurações de provedores são compartilhadas com as demais funcionalidades de Inteligência Artificial do Weknow.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FwADnXqxrD9tSkGuNK1QQ%2Fimage.png?alt=media&amp;token=d355a0dd-730a-4b4c-8221-ae242a5be64d" alt=""><figcaption><p>Campo de seleção de Provedor de IA (Quando aplicável)</p></figcaption></figure>

***

### Conversas em linguagem natural

Após definir o **Contexto de dados** e o **Provedor de IA**, o usuário pode criar uma conversa e realizar perguntas utilizando linguagem natural.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FSBnexbvHGIVeW7SrSWsC%2Fimage.png?alt=media&amp;token=fb518bbf-8626-45de-880e-4638c08cb957" alt=""><figcaption></figcaption></figure>

A Inteligência Artificial interpreta a solicitação considerando as informações disponíveis no contexto de dados e apresenta o resultado correspondente.

Durante a conversa, o usuário pode realizar novas perguntas para continuar explorando as informações.

O provedor utilizado é associado à conversa no momento de sua criação. Alterações posteriores na configuração do provedor não alteram as conversas existentes.

***

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

A barra lateral também pode ser **recolhida ou reaberta**, 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>Recolhendo e expandindo o menu lateral do Weknow Ask</p></figcaption></figure>

***

### Histórico de conversas

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

O usuário pode consultar seu histórico de conversas e acessar novamente as interações realizadas anteriormente.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FFhQIlA3tqVZJTaxZcz4X%2Fimage.png?alt=media&amp;token=1e69eb5d-9418-4858-9e28-b040f3493d39" alt=""><figcaption></figcaption></figure>

***

{% hint style="info" %}
**Nota:** A permissão **Utilizar como fonte de dados de IA** também pode ser configurada como padrão para novos metadados por meio da **Acessibilidade padrão**. Para saber mais, consulte **Acessibilidade padrão**.
{% endhint %}

***

### Disponibilizando metadados para o Weknow Ask <a href="#disponibilizando-metadados-para-o-weknow-ask-1" id="disponibilizando-metadados-para-o-weknow-ask-1"></a>

O **Weknow Ask** utiliza metadados autorizados como fonte de dados de IA para disponibilizá-los como **Contexto de dados**.

Para disponibilizar um metadado no Weknow Ask, é necessário habilitar a permissão **Utilizar como fonte de dados de IA** nas permissões do metadado.

**Como liberar um metadado**

1. No **Weknow Client**, localize e abra o metadado que deseja disponibilizar.
2. Acesse a opção **Permissões**.
3. Localize a permissão **Utilizar como fonte de dados de IA**.
4. Habilite a permissão para o usuário ou grupo que deverá utilizar o metadado no Weknow Ask.
5. Salve as alterações.

Após a liberação, o metadado poderá ser utilizado como **Contexto de dados** no Weknow Ask, de acordo com as permissões atribuídas ao usuário.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FM6QUqzwaQDOyGmwdbyRe%2Fimage.png?alt=media&amp;token=4cbae8c8-a9b0-4c77-8675-734e06490b66" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Nota:** A permissão **Utilizar como fonte de dados de IA** também pode ser configurada como padrão para novos metadados por meio da **Acessibilidade padrão**. Para saber mais, consulte **Acessibilidade padrão**.
{% endhint %}

***

### Segurança e utilização dos dados

O acesso ao Weknow Ask e aos dados utilizados como contexto depende das permissões configuradas no ambiente.

O usuário somente pode utilizar como contexto os metadados para os quais possui permissão de utilização como fonte de dados de IA.

O acesso ao Weknow Ask e aos dados utilizados como contexto depende das permissões configuradas no ambiente.

O usuário somente pode utilizar como contexto os metadados para os quais possui permissão de utilização como fonte de dados de IA.

***

### Saiba mais

Para saber como iniciar uma conversa e realizar perguntas utilizando o Weknow Ask, consulte [Como utilizar o Weknow Ask](/wedocs-5.2/inteligencia-artificial/weknow-ask/como-utilizar-o-weknow-ask.md).

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