# Modelos

La pantalla "Modelos", dividida en "Modelos" y "Instancias de modelos", proporciona la posibilidad de conectar un modelo adicional al Sherpa AI Server, siempre que se disponga de los recursos de hardware correspondientes.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-0d046bb2b006071ada45c85d621dab5ffef270d5%2Fimage%20(278).png?alt=media" alt=""><figcaption></figcaption></figure>

Los usuarios pueden elegir entre un modelo local o en la nube, siempre que tengan los tokens necesarios para el acceso. También es posible integrar un modelo alojado en servidores externos dentro de la red local, pero no en el mismo servidor donde se encuentra el Sherpa AI Server.

En nuestro sistema se ha implementado un algoritmo que verifica la disponibilidad de modelos y responde con el primero disponible. Sin embargo, si se requiere utilizar un modelo específico, podemos simplemente crear una instancia de ese modelo en el grupo correspondiente, y funcionará con él de manera constante.

Cabe destacar que, gracias a la funcionalidad de agrupamiento, en realidad agrupamos no los modelos en sí, sino sus backends, lo que asegura la escalabilidad y la resistencia a fallos del sistema. Dentro de un grupo no se prohíbe alojar varios backends con diferentes modelos.

La sección "Modelos" permite crear y editar grupos de modelos.

La sección "Instancias de modelos" permite crear diferentes enlaces a modelos. Para cada modelo se pueden configurar conexiones separadas, cada una con sus parámetros y configuraciones individuales.

<table data-header-hidden><thead><tr><th width="53.5555419921875"></th><th width="261.6666259765625"></th><th valign="top"></th></tr></thead><tbody><tr><td><strong>N°</strong></td><td><strong>Elemento de interfaz</strong></td><td valign="top"><strong>Descripción</strong></td></tr><tr><td></td><td><strong>Tabla "Modelos"</strong></td><td valign="top"></td></tr><tr><td>1.</td><td>botón "Crear"</td><td valign="top">Permite crear nuevos grupos de modelos.</td></tr><tr><td>2.</td><td>botón "Actualizar"</td><td valign="top">Permite forzar la actualización de la tabla "Modelos".</td></tr><tr><td>3.</td><td>botón "Eliminar seleccionado"</td><td valign="top">Permite eliminar los grupos de modelos seleccionados del Sherpa AI Server. También se pueden eliminar grupos de modelos individuales haciendo clic en el botón en la fila correspondiente de la tabla Modelos. Al eliminar un grupo de modelos, aparece una ventana para confirmar la eliminación.</td></tr><tr><td>4.</td><td>botón "Exportar a CSV"</td><td valign="top">Genera un archivo de datos de grupos de modelos en formato CSV (Comma-Separated Values) para importar en hojas de cálculo y sistemas de contabilidad.</td></tr><tr><td>5.</td><td>botón "Exportar a XLSX"</td><td valign="top">Genera un archivo de datos de grupos de modelos en formato Microsoft Excel (XLSX) para importar en hojas de cálculo y sistemas de contabilidad.</td></tr><tr><td></td><td><strong>Tabla "Instancias de modelos"</strong></td><td valign="top"></td></tr><tr><td>1.</td><td>botón "Crear"</td><td valign="top">Permite crear instancias de modelos.</td></tr><tr><td>2.</td><td>botón "Actualizar"</td><td valign="top">Permite forzar la actualización de la tabla "Instancias de modelos".</td></tr><tr><td>3.</td><td>botón "Eliminar seleccionado"</td><td valign="top">Permite eliminar las instancias de modelos seleccionadas del Sherpa AI Server. También se pueden eliminar instancias de modelos individuales haciendo clic en el botón en la fila correspondiente de la tabla "Reglas". Al eliminar instancias de modelos, aparece una ventana para confirmar la eliminación.</td></tr><tr><td>4.</td><td>botón "Exportar a CSV"</td><td valign="top">Genera un archivo de datos de instancias de modelos en formato CSV para importar en hojas de cálculo y sistemas de contabilidad.</td></tr><tr><td>5.</td><td>botón "Exportar a XLSX"</td><td valign="top">Genera un archivo de datos de instancias de modelos en formato Microsoft Excel (XLSX) para importar en hojas de cálculo y sistemas de contabilidad.</td></tr></tbody></table>

## Selección de Modelo en otras pantallas del Sherpa AI Server

### Chat

La sección "Modelos" permite visualizar y editar grupos de modelos que el Usuario podrá seleccionar al [crear un nuevo diálogo](https://docs.sherparpa.ru/es/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/chat) en el Sherpa AI Server.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-d16d0c2ce818f7a1663d1a47023fa6f5f3d41e1c%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(13).png?alt=media" alt=""><figcaption></figcaption></figure>

### Asistentes

La sección "Modelos" permite visualizar y editar grupos de modelos que el Usuario podrá seleccionar al crear un [Asistente](https://docs.sherparpa.ru/es/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/assistenty).

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-ec3b4371fd7ec6b840ab3343a2bc24cdd04f5bb7%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(16).png?alt=media" alt=""><figcaption></figcaption></figure>

## Crear modelo

Para crear un nuevo grupo de modelos, es necesario hacer clic en el botón "Crear" en la tabla "Modelos" y completar el formulario que aparece.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-c817ccb8d2e30b83c97d34cc69f76e116632e5db%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(28).png?alt=media" alt=""><figcaption></figcaption></figure>

## Crear instancia

Para crear una nueva instancia de modelo, es necesario hacer clic en el botón "Crear" en la tabla "Instancias de modelo" y completar el formulario que aparece.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-967ff5b8d61a7275ea1db0ba9749ded36ef997b9%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(29).png?alt=media" alt=""><figcaption></figcaption></figure>

Los campos a completar en la ventana emergente "Crear instancia":

* "Nombre \*" – campo obligatorio para el nombre de la instancia de modelo;
* "Descripción" – campo para ingresar la descripción de la instancia de modelo;
* "Host \*" – campo obligatorio para indicar la dirección IP o el nombre de dominio del servidor donde se aloja la instancia de modelo;
* "Puerto \*" – campo obligatorio para indicar el número de puerto del servicio de la instancia de modelo;
* "Protocolo \*" – campo obligatorio para seleccionar el protocolo de conexión;
* "Timeout \*" – campo obligatorio para establecer el tiempo máximo de espera para la respuesta de la instancia de modelo (en segundos).

También existe la posibilidad de crear conexiones a modelos en la nube (seleccionando la casilla "En la nube" en la ventana "Crear instancia"). Para ello, se prevén configuraciones especiales, que incluyen servidores proxy y tokens de acceso adicionales. En el caso de modelos locales, la configuración incluye la indicación del host, puerto y protocolo. El protocolo se mantiene como nuestro estándar, similar al formato de OpenAI, asegurando uniformidad y compatibilidad en el trabajo con diferentes modelos.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-dbfe154b3dcdab74fcb55f88372d1627d1757cd2%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(15).png?alt=media" alt=""><figcaption></figcaption></figure>

Campos adicionales para completar en la ventana emergente "Crear modelos" (al seleccionar la casilla "En la nube" en la ventana "Crear instancia"):

* "Proveedor \*" – campo para seleccionar el proveedor del modelo;
* "Modelo del proveedor" – campo para indicar el modelo específico del proveedor seleccionado;
* "Token / API Key \*" – campo para ingresar la clave API o token de autorización del proveedor;
* "Usuario" – campo para ingresar el nombre de usuario (al utilizar autenticación básica);
* "Contraseña" – campo para ingresar la contraseña (al utilizar autenticación básica).

Este es un contenedor especial, diseñado para ejecutar un modelo. En esencia, es una plataforma universal en la que se puede ejecutar cualquier modelo, pero solo uno a la vez. Para utilizar varios modelos, basta con iniciar varios de estos contenedores, cada uno con su propia configuración. En cada contenedor, será necesario cambiar el puerto por el cual se accede al modelo. Este enfoque permite utilizar eficazmente un servidor, ejecutando en él cualquier cantidad de modelos (la limitación depende únicamente de los recursos de hardware).

## Editar modelo

Para ver y editar las propiedades de un grupo de modelos, es necesario seleccionar el grupo deseado en la lista y hacer clic en el botón ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Después de esto, se abrirá un formulario con la configuración del modelo, en el que se pueden realizar los cambios necesarios. No hay nuevos campos en el modelo creado anteriormente.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-05a1498a89b00e1ce660c662decdd604a7ac9226%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(487).png?alt=media" alt=""><figcaption></figcaption></figure>

## Editar instanciaPara ver y editar las propiedades de una instancia del modelo, es necesario seleccionar la instancia deseada en la lista y hacer clic en el botón ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Después de esto, se abrirá un formulario con la configuración de la instancia del modelo, en el que se pueden realizar los cambios necesarios. No hay nuevos campos en la instancia del modelo creada anteriormente.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-794eadf6ac8f9f890d9998bdf0142a5cefa35b90%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(488).png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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.sherparpa.ru/es/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/modeli.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.
