> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/espanol/skyone-studio/inteligencia-artificial/agentes.md). # Agentes Los **“Agentes”** son responsables de orquestar la interacción entre modelos, *Skills* y flujos de automatización en **Studio AI**. Actúan como “intérpretes” que reciben comandos, procesan la lógica configurada y devuelven la respuesta final al usuario. Cada agente: * Está vinculado a un modelo. * Puede utilizar una o más *Skills*. * Puede operar de forma aislada o en cooperación con otros agentes. *** ### Crear un Agente 1. Accede al menú lateral y haz clic en **“Agentes”**.
2. Haz clic en **“Nuevo Agente”**. 3. Elija el tipo de agente: **Asistente** o **Cooperación**.
Seleccione la pestaña correspondiente (Asistente o Cooperación) para acceder a las instrucciones de creación específicas de cada modalidad: {% tabs %} {% tab title="Asistente" %} 4\. Complete o seleccione los siguientes campos: #### Configuraciones principales * **Nombre del agente:** Nombre para la identificación del agente. * **Prompt del sistema:** Escriba el prompt para el agente. Si desea agregar más prompts, simplemente haga clic en “**Agregar prompt**”. {% hint style="success" %} Diferentes prompts en el mismo agente son útiles para separar tareas y facilitar el mantenimiento. {% endhint %} * **Modelo:** Seleccione un modelo ya existente. Será la base de interpretación del agente. * **Tipo de respuesta:** El agente podrá responder de tres modos diferentes: * **Texto:** El agente responderá por texto. * **Audio:** El agente responderá por audio. Al seleccionar esta opción, las siguientes configuraciones de voz son necesarias: * **Voz del agente:** Seleccione, entre las opciones disponibles en la plataforma, la identidad vocal que mejor represente a su agente. * **Instrucciones de habla:** Describa el tono de voz deseado (ej.: empático, formal, entusiasta) y otras posibles orientaciones de locución. * **Híbrido:** Posee la capacidad de alternar entre texto y audio, entregando una experiencia mixta dentro de la misma interacción. Al seleccionar esta opción, se requieren las mismas configuraciones de voz mencionadas anteriormente. {% hint style="info" %} La disponibilidad del **Tipo de Respuesta** está directamente vinculada al modelo seleccionado. El modo **Híbrido** no es compatible con todos los modelos de IA disponibles en la plataforma. {% endhint %} * **Habilitar generación de gráficos:** Al activar la casilla (flag), es posible la creación de gráficos a partir de los datos del agente, excepto gráficos de tipo telaraña. {% hint style="info" %} La disponibilidad de generación de gráficos está vinculada al modelo seleccionado y no es compatible con todos los modelos {% endhint %} * **Mensaje de error predeterminado:** Defina un mensaje para los momentos en que el agente no logre interpretar el prompt o encontrar una respuesta adecuada. * **Límite de mensajes de contexto:** define la cantidad máxima de mensajes anteriores del historial de conversación que se mantendrán en memoria y se enviarán al modelo de lenguaje (LLM) con cada nueva interacción. #### **Guardrails** Permiten agregar capas ordenadas de validación para las entradas (inputs) y salidas (outputs) del agente. Para configurar un Guardrail, complete los campos a continuación: * **Nombre:** identificación del guardrail. * **Tipo:** define si la validación se aplicará en la entrada (pregunta del usuario) o en la salida (respuesta del agente). * **Instrucción:** la directriz o regla que el modelo debe seguir. Ejemplo: "Bloquear preguntas con contenido discriminatorio." * **Mensaje de error:** El texto que se mostrará al usuario en caso de que la validación falle. * **Modelo base:** El modelo de lenguaje (LLM) opcional que ejecutará específicamente esta validación. #### **Reglas** En esta área es posible agregar capacidades específicas y ordenadas al agente. Al hacer clic en **Agregar reglas,** configure las siguientes opciones: * **Aplicar siempre:** Cuando está activado, fuerza la aplicación de esta habilidad en todas las interacciones del usuario, ignorando la necesidad de clasificación contextual. * **Descripción:** Explicación detallada de en qué escenarios o contextos se debe activar esta habilidad (esencial para que el agente sepa cuándo usarla). * **Instrucción:** El comando práctico o comportamiento dirigido que la habilidad debe ejecutar cuando se active. #### **Gestione sus tools** Agregue una o más Skills para definir las capacidades técnicas y funciones que el agente podrá ejecutar durante el flujo de automatización. #### **Base de Conocimiento** Permite vincular documentos (como archivos PDF) para que el agente los utilice como fuente de consulta. Puede seleccionar archivos existentes en la plataforma o cargar nuevos documentos directamente en esta etapa. #### **Configuraciones avanzadas** {% hint style="warning" %} Las opciones de configuración avanzada pueden variar según el modelo de IA elegido. {% endhint %} En esta área, puede ajustar los parámetros técnicos que rigen la generación de respuestas del modelo de IA. Estas configuraciones permiten equilibrar creatividad, precisión, velocidad y costo operativo. Las definiciones: * **top\_k:** Limita el vocabulario del modelo a las *k* palabras más probables en cada etapa de la generación. Por ejemplo, si se configura en 50, el modelo elegirá la siguiente palabra solo entre las 50 mejores opciones clasificadas por el contexto. * **top\_p:** Muestreo de núcleo (Nucleus Sampling). Filtra las palabras candidatas basándose en la suma acumulada de sus probabilidades. Por ejemplo: si se define en 0.9, el modelo considera solo el subconjunto de palabras que, juntas, suman el 90% de la probabilidad de ocurrencia, descartando opciones irrelevantes. * **Temperatura:** Define el nivel de previsibilidad de la respuesta. Valores bajos (ej.: 0.2) generan respuestas más directas y exactas, ideales para análisis técnicos. Valores altos (ej.: 0.8) incentivan respuestas más libres y creativas. * **token\_limit:** Determina el límite de generación de tokens. Define cuántos tokens (palabras o fragmentos de palabras) puede generar el modelo en la respuesta, ayudando al control de costos y evitando respuestas excesivamente largas. * **context\_limit:** Define el límite de memoria de la conversación. Este límite determina el volumen máximo de tokens (historial de mensajes e instrucciones) que el modelo puede procesar simultáneamente para mantener la coherencia y el flujo de la conversación. * **repeat\_penalty:** Ajusta el rigor del modelo para evitar la repetición excesiva de palabras, términos o frases idénticas en una misma respuesta. * **max\_completion\_tokens:** Define el límite máximo de tokens que el modelo puede generar en una sola respuesta. #### **Carga de tools** Define cómo las herramientas (tools), la base de conocimientos y los agentes de cooperación se cargarán durante la ejecución del agente principal. Es posible elegir entre las siguientes estrategias: * **Todo (Predeterminado):** Inicializa y carga todos los recursos simultáneamente en el momento de la ejecución del agente. * **Agéntico:** Delega la decisión a un agente orquestador, que evalúa el contexto y decide dinámicamente qué necesita ser cargado. * **Relevancia:** Carga los recursos bajo demanda, basándose en el cálculo de proximidad y relevancia contextual entre la solicitud y las herramientas. {% hint style="info" %} La opción de **Carga de tools** solo estará visible en la interfaz después de la selección de una o más tools en la plataforma. {% endhint %} #### **Configuraciones de privacidad** Configure el nivel de acceso de los agentes entre las siguientes opciones: * **Público:** cualquier persona puede visualizar y editar las configuraciones de el agente. * **Privado:** solo los usuarios seleccionados podrán visualizar los detalles y editar el agente actual. * **Configurar usuarios:** al seleccionar la opción Privado, esta opción se activa. Elija los usuarios que tendrán acceso a el agente y, a continuación, haga clic en "**Concluir**".
{% hint style="info" %} Los usuarios no autorizados pueden usar los agentes, pero no pueden visualizar detalles técnicos ni editarlos. {% endhint %} {% endtab %} {% tab title="Cooperación" %} 4\. Complete o seleccione los siguientes campos: #### Configuraciones principales * **Nombre del agente:** Nombre para la identificación del agente. * **Prompt del sistema:** Escriba el prompt para el agente. Si desea agregar más prompts, simplemente haga clic en “**Agregar prompt**”. {% hint style="success" %} Diferentes prompts en el mismo agente son útiles para separar tareas y facilitar el mantenimiento. {% endhint %} * **Modelo:** Seleccione un modelo ya existente. Será la base de interpretación del agente. * **Tipo de respuesta:** El agente podrá responder de tres modos diferentes: * **Texto:** El agente responderá por texto. * **Audio:** El agente responderá por audio. Al seleccionar esta opción, las siguientes configuraciones de voz son necesarias: * **Voz del agente:** Seleccione, entre las opciones disponibles en la plataforma, la identidad vocal que mejor represente a su agente. * **Instrucciones de habla:** Describa el tono de voz deseado (ej.: empático, formal, entusiasta) y otras posibles orientaciones de locución. * **Híbrido:** Posee la capacidad de alternar entre texto y audio, entregando una experiencia mixta dentro de la misma interacción. Al seleccionar esta opción, se requieren las mismas configuraciones de voz mencionadas anteriormente. {% hint style="info" %} La disponibilidad del **Tipo de Respuesta** está directamente vinculada al modelo seleccionado. El modo **Híbrido** no es compatible con todos los modelos de IA disponibles en la plataforma. {% endhint %} * **Gestione los agentes para cooperación:** seleccione dos o más agentes creados previamente. Para ello: * Haga clic en “Seleccionar agentes". * En el modal, seleccione dos o más haciendo clic en sus respectivas casillas de verificación. * **Mensaje de error predeterminado:** Defina un mensaje para los momentos en que el agente no logre interpretar el prompt o encontrar una respuesta adecuada. * **Límite de mensajes de contexto:** define la cantidad máxima de mensajes anteriores del historial de conversación que se mantendrán en memoria y se enviarán al modelo de lenguaje (LLM) con cada nueva interacción. #### **Guardrails** Permiten agregar capas ordenadas de validación para las entradas (inputs) y salidas (outputs) del agente. Para configurar un Guardrail, complete los campos a continuación: * **Nombre:** identificación del guardrail. * **Tipo:** define si la validación se aplicará en la entrada (pregunta del usuario) o en la salida (respuesta del agente). * **Instrucción:** la directriz o regla que el modelo debe seguir. Ejemplo: "Bloquear preguntas con contenido discriminatorio." * **Mensaje de error:** El texto que se mostrará al usuario en caso de que la validación falle. * **Modelo base:** El modelo de lenguaje (LLM) opcional que ejecutará específicamente esta validación. #### **Reglas** En esta área es posible agregar capacidades específicas y ordenadas al agente. Al hacer clic en **Agregar reglas,** configure las siguientes opciones: * **Aplicar siempre:** Cuando está activado, fuerza la aplicación de esta habilidad en todas las interacciones del usuario, ignorando la necesidad de clasificación contextual. * **Descripción:** Explicación detallada de en qué escenarios o contextos se debe activar esta habilidad (esencial para que el agente sepa cuándo usarla). * **Instrucción:** El comando práctico o comportamiento dirigido que la habilidad debe ejecutar cuando se active. #### **Configuraciones avanzadas** {% hint style="warning" %} Las opciones de configuración avanzada pueden variar según el modelo de IA elegido. {% endhint %} En esta área, puede ajustar los parámetros técnicos que rigen la generación de respuestas del modelo de IA. Estas configuraciones permiten equilibrar creatividad, precisión, velocidad y costo operativo. Las definiciones: * **top\_k:** Limita el vocabulario del modelo a las *k* palabras más probables en cada etapa de la generación. Por ejemplo, si se configura en 50, el modelo elegirá la siguiente palabra solo entre las 50 mejores opciones clasificadas por el contexto. * **top\_p:** Muestreo de núcleo (Nucleus Sampling). Filtra las palabras candidatas basándose en la suma acumulada de sus probabilidades. Por ejemplo: si se define en 0.9, el modelo considera solo el subconjunto de palabras que, juntas, suman el 90% de la probabilidad de ocurrencia, descartando opciones irrelevantes. * **Temperatura:** Define el nivel de previsibilidad de la respuesta. Valores bajos (ej.: 0.2) generan respuestas más directas y exactas, ideales para análisis técnicos. Valores altos (ej.: 0.8) incentivan respuestas más libres y creativas. * **token\_limit:** Determina el límite de generación de tokens. Define cuántos tokens (palabras o fragmentos de palabras) puede generar el modelo en la respuesta, ayudando al control de costos y evitando respuestas excesivamente largas. * **context\_limit:** Define el límite de memoria de la conversación. Este límite determina el volumen máximo de tokens (historial de mensajes e instrucciones) que el modelo puede procesar simultáneamente para mantener la coherencia y el flujo de la conversación. * **repeat\_penalty:** Ajusta el rigor del modelo para evitar la repetición excesiva de palabras, términos o frases idénticas en una misma respuesta. * **max\_completion\_tokens:** Define el límite máximo de tokens que el modelo puede generar en una sola respuesta. #### **Configuraciones de privacidad** Configure el nivel de acceso de los agentes entre las siguientes opciones: * **Público:** cualquier persona puede visualizar y editar las configuraciones de el agente. * **Privado:** solo los usuarios seleccionados podrán visualizar los detalles y editar el agente actual. * **Configurar usuarios:** al seleccionar la opción Privado, esta opción se activa. Elija los usuarios que tendrán acceso a el agente y, a continuación, haga clic en "**Concluir**".
{% hint style="info" %} Los usuarios no autorizados pueden usar los agentes, pero no pueden visualizar detalles técnicos ni editarlos. {% endhint %} {% endtab %} {% endtabs %} 5. Para finalizar, haga clic en “**Crear agente**". ¡Listo! Su agente ha sido creado. Pruebe sus agentes en el [Playground](/espanol/skyone-studio/inteligencia-artificial/playground.md). **Lea también:** [**Cómo editar o eliminar sus agentes**](/espanol/skyone-studio/inteligencia-artificial/agentes/gestion-de-agentes.md)**.** *** ### FAQ – Agentes de IA
¿Qué es un agente de IA? Es una entidad configurada para ejecutar tareas, responder preguntas e interactuar de forma autónoma, combinando modelos de lenguaje, reglas y *skills*.
¿Puedo crear mi propio agente de IA en Skyone Studio? Sí. La plataforma ofrece total autonomía para crear agentes personalizados alineados con tu estrategia de negocio.
¿Cuál es la diferencia entre un agente nativo y un agente personalizado? * **Nativo:** ya viene listo para usar, con configuraciones estándar. * **Personalizado:** tú defines el comportamiento, el tono, las *skills*, los datos y el modelo de lenguaje.
¿Un agente puede tener más de una skill? Sí. Es posible asignar múltiples *skills* a un agente y definir cuándo y cómo se activará cada una.
¿El agente puede acceder a mis datos internos? Sí, siempre y cuando se configuren las integraciones y permisos necesarios.
¿Puedo cambiar el modelo de lenguaje del agente después de creado? Sí. Es posible modificar el modelo, ajustar parámetros y actualizar *skills* sin necesidad de recrear todo el agente.
¿El agente aprende por sí solo? El agente no “aprende” en el sentido tradicional. Funciona con base en las reglas, fuentes de datos y modelos configurados. Es posible mejorar su desempeño ajustando *prompts* y *skills*.
¿Es posible usar un agente de IA sin conocimientos técnicos avanzados? Sí. Skyone Studio fue diseñado para permitir que los usuarios configuren agentes de manera intuitiva, incluso sin experiencia en programación.
¿El agente funciona sin conexión (offline)? No. Es necesario que esté conectado al entorno de Skyone Studio y, cuando corresponda, a las integraciones configuradas.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.skyone.cloud/espanol/skyone-studio/inteligencia-artificial/agentes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.