# Guía de integración de Intelligence

## Introducción

Este manual describe el flujo de trabajo de integración estándar de GBS Intelligence, que permite la búsqueda biográfica en la base de datos. Cualquier llamada de API mencionada en este manual debe realizarse de acuerdo con la [Especificación de API de GBS Intelligence](https://gitbook.griaule.com/apis/intelligence) .

{% hint style="info" %}
Todas las llamadas a GBS Intelligence deben realizarse al servidor ETR, según lo mencionado en la especificación de la API.
{% endhint %}

## Inicio de sesión

Cualquier solicitud a GBS Intelligence requiere un inicio de sesión autenticado `session-guid`. Para obtenerlo, es necesario enviar `session-guid`una solicitud [de inicio de sesión, informando una combinación válida de usuario/contraseña.](https://gitbook.griaule.com/apis/intelligence/endpoints#post-session)

{% hint style="info" %}
El usuario y la contraseña deben ser los mismos que se usan para iniciar sesión en GBDS y otras aplicaciones de Griaule.
{% endhint %}

La operación de inicio de sesión devolverá un session-guid que debe proporcionarse en todas las solicitudes a GBS Intelligence.

## Lista de campos de búsqueda por request

Cualquier request de búsqueda enviada a GBS Intelligence debe especificar el campo biográfico que se utilizará. Para verificar los campos biográficos disponibles, se puede usar [listSearchFields](https://gitbook.griaule.com/apis/intelligence/fields)

{% hint style="info" %}
Si el nombre del campo biográfico especificado en la solicitud de búsqueda no coincide con un campo que exista dentro de la base de datos, se devolverá un error.
{% endhint %}

## Búsqueda por valor

Al realizar una solicitud de búsqueda, se recomienda dividir el flujo de trabajo en dos etapas: conteo y lista.

Al contar los resultados disponibles para los criterios de búsqueda proporcionados de antemano, es posible paginar los resultados, evitando cualquier sobrecarga en la recuperación y visualización de los resultados.

Después de contar los resultados, es posible solicitar y paginar los resultados de la búsqueda mediante los parámetros de consulta de la solicitud.

### Contar

La solicitud [de resultados de búsqueda de conteo](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list-count) debe contener los campos `name`y `value`a ser buscados.

{% hint style="info" %}
Cualquier perfil que contenga el valor a buscar dentro del campo biográfico proporcionado será devuelto como resultado de la búsqueda, independientemente de la posición.

por ejemplo, una expresión regular que describe los criterios de búsqueda sería `*value*`, siendo `*`un comodín que abarca cualquier carácter en cualquier cantidad.
{% endhint %}

### Lista

La solicitud [de resultados de búsqueda de lista](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list) también debe contener los campos `name`y `value`a ser buscados, y los criterios de búsqueda serán los mismos usados para contar los resultados.

Esta solicitud acepta parámetros de consulta que pueden usarse para filtrar la lista devuelta, como `first`, que determina la posición del primer resultado devuelto en la lista, y `size`, que define el número de resultados a devolver, comenzando por el `first`.

## Acceso a los detalles del perfil

Después de realizar la búsqueda y recuperar los resultados, es posible usar los PGUIDs devueltos para acceder a los detalles del perfil mediante la llamada [Request Profile](https://gitbook.griaule.com/apis/intelligence/profiles#get-profile-person-pguid).

Este método devolverá todos los datos del perfil del PGUID proporcionado, incluidos datos biográficos e imágenes codificadas en base64.

## Herramienta de conversión de imágenes

GBS Intelligence también proporciona un método para [convertir imágenes](https://gitbook.griaule.com/apis/intelligence/image-conversion#post-image-convert) en diferentes formatos, proporcionando la imagen original codificada en base64, su formato y el formato deseado para la conversión.


---

# 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/gbs/es/integracion-de-gbds/guia-de-integracion-de-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.