# Guia de Integração do Intelligence

## Introdução

Este manual descreve o fluxo de trabalho de integração padrão do GBS Intelligence, que permite a busca biográfica no banco de dados. Qualquer chamada de API mencionada neste manual deve ser realizada de acordo com a [Especificação de API do GBS Intelligence](https://gitbook.griaule.com/apis/intelligence) .

{% hint style="info" %}
Todas as chamadas para o GBS Intelligence devem ser realizadas para o servidor ETR, conforme mencionado na especificação da API.
{% endhint %}

## Login

Qualquer solicitação à GBS Intelligence requer um login autenticado `session-guid`. Para obtê-lo , é necessário enviar `session-guid`uma solicitação [de login, informando uma combinação válida de usuário/senha.](https://gitbook.griaule.com/apis/intelligence/endpoints#post-session)

{% hint style="info" %}
O usuário e a senha devem ser os mesmos usados ​​para fazer login no GBDS e outros aplicativos Griaule.
{% endhint %}

A operação de login retornará um session-guid que deve ser fornecido em todas as solicitações ao GBS Intelligence.

## Lista de Campos de Busca por Request

Qualquer request de busca submetida ao GBS Intelligence deve especificar o campo biográfico a ser usado. Para verificar os campos biográficos disponíveis, pode-se usar [listSearchFields](https://gitbook.griaule.com/apis/intelligence/fields)

{% hint style="info" %}
If the biographic field name specified in the search request does not match a field that exists within the database, an error will be returned.
{% endhint %}

## Pesquisando por Valor

Ao realizar uma solicitação de pesquisa, é recomendável dividir o fluxo de trabalho em duas etapas: contagem e lista.

Ao contar os resultados disponíveis para os critérios de pesquisa fornecidos antecipadamente, é possível paginar os resultados, evitando qualquer sobrecarga na recuperação e visualização dos resultados.

Após a contagem dos resultados, é possível solicitar e paginar os resultados da pesquisa por meio dos parâmetros de consulta da solicitação.

### Contar

A solicitação [de resultados da pesquisa de contagem](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list-count) deve conter os campos `name`e `value`a serem pesquisados.

{% hint style="info" %}
Qualquer perfil que contenha o valor a ser pesquisado dentro do campo biográfico fornecido será retornado como resultado da pesquisa, independentemente da posição.

por exemplo, uma expressão regular que descreve os critérios de pesquisa seria `*value*`, sendo `*`um curinga que abrange qualquer caractere em qualquer quantidade.
{% endhint %}

### Lista

A solicitação [de Resultados da Pesquisa de Lista](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list) também deve conter os campos `name`e `value`a serem pesquisados, e os critérios de pesquisa serão os mesmos usados ​​para contar os resultados.

Esta solicitação aceita parâmetros de consulta que podem ser usados ​​para filtrar a lista retornada, como `first`, que determina a posição do primeiro resultado retornado na lista, e `size`, que define o número de resultados a serem retornados, começando pelo `first`.

## Acessando detalhes do perfil

Após realizar a pesquisa e recuperar os resultados, é possível usar os PGUIDs retornados para acessar os detalhes do perfil por meio da chamada [Request Profile](https://gitbook.griaule.com/apis/intelligence/profiles#get-profile-person-pguid).

Este método retornará todos os dados do perfil do PGUID fornecido, incluindo dados biográficos e imagens codificadas em base64.

## Ferramenta de conversão de imagem

O GBS Intelligence também fornece um método para [converter imagens](https://gitbook.griaule.com/apis/intelligence/image-conversion#post-image-convert) em diferentes formatos, fornecendo a imagem original codificada em base64, seu formato e o formato desejado para conversão.


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://docs.griaule.com/integracao-do-gbds/guia-de-integracao-do-intelligence.md?ask=<question>
```

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

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