# Solicitud a Sherpa AI Server

Este bloque permite enviar solicitudes a los modelos generativos de Sherpa AI Server. Con él se pueden crear nuevos textos bajo demanda y realizar diversas tareas:

* clasificación,
* resumen,
* traducción y reescritura de textos,
* redacción de prototipos de código en distintos lenguajes de programación,
* análisis de datos semiestructurados y no estructurados,
* extracción y procesamiento de hechos,
* mantener diálogos sobre diversos temas, y mucho más.

El pago por el uso de esta funcionalidad se descuenta de la cuenta del cliente en la plataforma. Para fines de prueba, cada nuevo Usuario tiene la posibilidad de probar esta funcionalidad sin costo. Una vez finalizado el desarrollo del Robot, el uso de esta funcionalidad requiere pago.

<table data-header-hidden><thead><tr><th width="300.11663818359375" valign="top"></th><th width="323.56671142578125" valign="top"></th></tr></thead><tbody><tr><td valign="top">Historial del chat</td><td valign="top"><p>[Tabla de datos] Agregue el historial del chat en cuyo contexto la red neuronal debe generar la respuesta. La tabla de datos especificada debe contener columnas con los nombres "role" y "content".</p><p>Si no existen dichas columnas, se usará la primera columna de la tabla como "role" y la segunda como "content". En la columna "role" solo se puede especificar uno de los siguientes valores:</p><ul><li>system,</li><li>assistant,</li><li>user.</li></ul><p>El rol system está destinado a configurar el tono y los ajustes básicos de la red neuronal, por ejemplo:</p><ul><li>con el rol "system" se puede escribir: <code>"You are helpful assistant on used cars selection. You know everything on how to choose the best deal for used car"</code>,</li><li>con el rol "assistant" se recomienda incluir los mensajes anteriores generados por la propia red neuronal,</li><li>con el rol "user" se recomienda incluir las réplicas escritas por el usuario interlocutor.</li></ul><p>Los mensajes más antiguos deben ubicarse al inicio de la tabla y los más recientes al final. La columna "content" debe contener el mensaje en sí.</p><p>Esta propiedad puede dejarse vacía; en ese caso, la generación se realizará únicamente con el contenido de las propiedades "Rol" y "Solicitud".</p><p>Si se utiliza la propiedad "Herramientas", la tabla debe tener 4 columnas:</p><ul><li>"role",</li><li>"content",</li><li>"tool_call_id",</li><li>"name".</li></ul></td></tr><tr><td valign="top">Solicitud System</td><td valign="top">[Texto] Ingrese el texto de la nueva solicitud a la red neuronal. La solicitud se ejecutará con el rol system.</td></tr><tr><td valign="top">Solicitud User</td><td valign="top">[Texto] Ingrese el texto de la nueva solicitud a la red neuronal. La solicitud se ejecutará con el rol user.</td></tr><tr><td valign="top">Modelo</td><td valign="top">Seleccione el modelo para generar la respuesta.</td></tr><tr><td valign="top">Nombre personalizado del modelo</td><td valign="top">[Texto] Especifique el nombre personalizado del modelo compatible con Sherpa AI Server.</td></tr><tr><td valign="top">Palabras de parada</td><td valign="top"><p>[Texto/Lista] Cadena o lista que contiene no más de 4 cadenas que detendrán la generación.</p><p>El texto devuelto no contendrá estas palabras.</p></td></tr><tr><td valign="top">Temperatura</td><td valign="top"><p>[Número] Número decimal de 0 a 1 que indica el grado de "aleatoriedad" o "creatividad" del resultado, donde:</p><ul><li>0 - resultado menos creativo,</li><li>1 - máxima aleatoriedad.</li></ul><p>Para la mayoría de tareas creativas es más adecuado el valor 0.7; si desea obtener la misma respuesta a la misma solicitud en cada ejecución, establezca el valor en 0.</p></td></tr><tr><td valign="top">Longitud máxima</td><td valign="top"><p>[Número] Longitud máxima del resultado, expresada en tokens convencionales.</p><p>Para el inglés, 1 token equivale a 4 caracteres; para la mayoría de otros idiomas, 1 token equivale a 1 carácter. Reduzca este número si desea obtener respuestas más cortas en promedio; auméntelo para respuestas más largas. Tenga en cuenta que este número limita la longitud de la respuesta, aunque la respuesta obtenida no necesariamente tendrá la longitud indicada: dependiendo del contenido de la solicitud, puede ser más corta.</p></td></tr><tr><td valign="top">Límite automático de longitud</td><td valign="top"><p>Al activarse, la longitud máxima especificada se ajustará automáticamente.</p><p>Para ello se calcula la cantidad de tokens en la solicitud y se tiene en cuenta la cantidad máxima posible de tokens para el modelo seleccionado.</p></td></tr><tr><td valign="top">Herramientas</td><td valign="top"><p>[Tabla de datos] Tabla con la descripción de las herramientas que la red neuronal puede seleccionar para resolver la tarea en lugar de una respuesta de texto.</p><p>No todos los modelos admiten esta funcionalidad. La tabla de datos debe contener tres columnas:</p><ul><li>"name" - nombre de la herramienta (letras latinas y cifras, no más de 64 caracteres),</li><li>"description" - descripción de la herramienta (puede estar en idiomas distintos al inglés),</li><li>"parameters" - argumentos que se pasan a la herramienta al invocarla, en formato JSON.</li></ul><p>Ejemplo de descripción JSON de parámetros:</p><p><code>"{</code></p><p><code>"type": "object",</code></p><p><code>"properties":</code></p><p><code>{</code></p><p><code>"query":</code></p><p><code>{</code></p><p><code>"type": "string",</code></p><p><code>"description": "Request for a Google search result"</code></p><p><code>}</code></p><p><code>},</code></p><p><code>"required": ["query"]</code></p><p><code>}".</code></p><p>Al invocar la herramienta, la red neuronal seleccionará la herramienta adecuada de entre las disponibles, basándose en la descripción que usted proporcionó, y completará (generará) los valores de los parámetros especificados para invocar dichas herramientas.</p><p>Puede obtener más información sobre el mecanismo de uso de herramientas en la descripción de la propiedad de salida CalledTools.</p></td></tr><tr><td valign="top">Usar herramienta</td><td valign="top"><p>[Texto] Si es necesario, se puede indicar de forma forzada el nombre de la herramienta que la red neuronal debe usar en la solicitud actual.</p><p>El nombre debe coincidir con el nombre de una de las herramientas de la columna "name" en la tabla "Herramientas".</p></td></tr><tr><td valign="top">Esquema de respuesta</td><td valign="top"><p>[Texto] Esquema de respuesta en formato JSON.</p><p>Por ejemplo:</p><p><code>"{</code></p><p><code>"name": "capital-response",</code></p><p><code>"schema":</code></p><p><code>{</code></p><p><code>"type": "object",</code></p><p><code>"properties":</code></p><p><code>{</code></p><p><code>"answer":</code></p><p><code>{</code></p><p><code>"type": "string"</code></p><p><code>},</code></p><p><code>"is_correct":</code></p><p><code>{</code></p><p><code>"type": "boolean"</code></p><p><code>},</code></p><p><code>"category":</code></p><p><code>{</code></p><p><code>"type": "string",</code></p><p><code>"enum": ["geography", "history", "science", "other"]</code></p><p><code>},</code></p><p><code>"required": ["answer"]</code></p><p><code>}</code></p><p><code>}".</code></p></td></tr><tr><td valign="top">Tiempo de espera</td><td valign="top"><p>[Número] Tiempo máximo de espera de la respuesta en segundos.</p><p>El tiempo de espera real depende del modelo seleccionado, la longitud de la solicitud y la longitud prevista de la respuesta, así como de la carga actual de los servidores.</p><p>Si se supera el límite de espera establecido, se produce un error.</p></td></tr><tr><td valign="top">Rol de la respuesta</td><td valign="top">[Texto] Rol con el que respondió la red neuronal.</td></tr><tr><td valign="top">Respuesta</td><td valign="top">[Texto] Texto de la respuesta de la red neuronal.</td></tr><tr><td valign="top">Longitud total</td><td valign="top">[Número] Longitud total de la solicitud y el resultado (combinados), expresada en tokens convencionales.</td></tr><tr><td valign="top">Nivel de procesamiento</td><td valign="top"><p>Selección del nivel de procesamiento de errores. Valores posibles:</p><ul><li>"Default" - por defecto;</li><li>"Ignore" - los errores se ignoran;</li><li>"Handle" - los errores se procesan.</li></ul><p>Si se selecciona "Default", se utilizará el valor del bloque "Inicio" del diagrama actual.</p></td></tr><tr><td valign="top">Nivel de mensajes</td><td valign="top"><p>Selección del nivel de mensajes que mostrarán los bloques durante la ejecución. Valores posibles:</p><ul><li>"Default" - por defecto;</li><li>"Release" - salida desactivada;</li><li>"Debug" - salida de información básica;</li><li>"Detailed" - salida de información detallada.</li></ul><p>Si se selecciona "Default", se utilizará el valor del bloque "Inicio" del diagrama actual.</p></td></tr><tr><td valign="top">Texto de error</td><td valign="top">[Texto] Devuelve información detallada sobre el error en caso de ejecución incorrecta del bloque.</td></tr></tbody></table>


---

# 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-rpa/sherpa-designer/spravochnik-blokov/mashinnoe-obuchenie-machine-learning/zapros-k-sherpa-ai-server-sherpaaiserverrequest.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.
