> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/agentes.md). # Agentes
La funcionalidad de **Agentes** es el área central para crear y gestionar capacidades de inteligencia artificial dentro del sistema. Permite construir agentes conversacionales, estructuras RAG (Generación Aumentada por Recuperación) y herramientas que amplían lo que los agentes pueden conocer y hacer. El objetivo principal de esta sección es ayudarte a diseñar el comportamiento, el conocimiento y las acciones de los agentes de forma estructurada, reutilizable y escalable. Al accceder a la sección **Agentes** verás: * Una barra lateral izquierda con la lista de todos los agentes creados * Un campo de búsqueda para localizar agentes rápidamente * Pestañas superiores para cambiar entre: * **Agentes** * **Herramientas** * **RAG** Un botón **( + )** para crear nuevos recursos
### 1. Cómo Configurar tu Agente 1. Acceder al Área de Agentes 2. En el menú de navegación izquierdo, haz clic en el ícono **Agentes**. 3. Serás dirigido a la pantalla de creación y gestión de agentes. 4. Esta pantalla funciona como un panel de control central donde puedes: 1. Crear nuevos agentes 2. Editar agentes existentes 3. Gestionar herramientas y bases de conocimiento 4. Definir cómo se comporta cada agente dentro del sistema ### 2. Crear un Nuevo Recurso 1. Haz clic en el botón **( + )** en la parte superior de la pantalla. 2. Selecciona una de las opciones disponibles: 1. **Nuevo agente de chat:** Crear un agente conversacional con personalidad, objetivos y reglas definidas 2. **Nuevo RAG:** Crear una base de conocimiento contextual para recuperación de información 3. **Nueva herramienta:** Crear una herramienta que realice acciones o integraciones *** ### Cómo Crear un Nuevo RAG (Generación Aumentada por Recuperación) Un **RAG** es una capa de conocimiento que permite a los agentes recuperar información desde documentos y archivos, utilizando ese contenido para generar respuestas más precisas, contextuales y confiables. En lugar de depender únicamente del conocimiento general del modelo, el RAG permite que el agente base sus respuestas en tus propios datos. El RAG está diseñado para: * Proporcionar respuestas basadas en hechos utilizando documentos internos * Reducir alucinaciones fundamentando las respuestas en contenido real * Permitir que los agentes trabajen con: * Archivos CSV * Documentos de texto (PDF, .doc, .txt, .md, .pptx, etc.) * Datos estructurados y semiestructurados (.json, .png, .jpg, .mp3, .mp4, etc.) {% hint style="info" %} Un RAG no actúa por sí solo. Debe estar vinculado a un Agente de Chat para ser utilizado durante las conversaciones. {% endhint %} Está dividida en dos áreas principales: * **Panel izquierdo →** Definición y comportamiento del RAG * **Panel derecho →** Selección y gestión de archivos
Al abrir el panel, se recomienda: * Ingresar un nombre claro y descriptivo que refleje el conjunto de datos o dominio * Describir el tipo de información proporcionada * Definir cuándo el agente debe consultar este archivo #### Sección Archivos Puedes: * Utilizar el campo de búsqueda para filtrar archivos por nombre * Seleccionar uno o más archivos de la lista Una vez seleccionados, el contenido de estos archivos se vuelve consultable por el agente. {% hint style="info" %} Para importar archivos, consulta la sección de [**Ingesta de Archivos**](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/s5LvtI2rJrSMh1YBcgCB/herramientas/tasks/etl/files-ingest) en este documento. {% endhint %} ## Cómo Configurar Nuevas Herramientas Las **Herramientas** definen qué acciones puede realizar un agente más allá de la conversación. Amplían sus capacidades permitiendo integraciones, acceso seguro a datos, consultas controladas y manejo de archivos multimedia.Un agente solo puede utilizar herramientas que hayan sido explícitamente creadas y asignadas, garantizando seguridad, previsibilidad y gobernanza. En la pantalla de Herramientas puedes crear y gestionar distintos tipos.
En la pantalla Herramientas, puede crear y gestionar los siguientes tipos de herramientas: | Herramienta | Propósito | | ---------------- | ---------------------------------------------------- | | HTTP Request | Llamar a API y servicios externos | | MCP | Conéctese a API y servicios basados en MCP. | | Verified Queries | Ejecutar consultas SQL preaprobadas de forma segura. | | Media File | Seleccionar y recuperar recursos multimedia | Cada tipo de herramienta está diseñado para una clase específica de acción y tiene su propio modelo de configuración. 1. **Crear una Nueva Herramienta** 1. Abre la sección **Herramientas** 2. Haz clic en el tipo de herramienta deseado 3. Configura los parámetros 4. Haz clic en **Guardar** ### Solicitud HTTP La herramienta **Solicitud HTTP** permite a un agente interactuar con API externas utilizando métodos HTTP estándar.
**Casos de uso:** * Obtener datos de servicios externos * Enviar datos a sistemas externos * Activar flujos o webhooks **Características:** * Compatible con APIs REST * Parámetros definidos explícitamente * El agente solo puede llamar endpoints configurados #### MCP Permite integración con APIs compatibles con MCP.
**Casos de uso:** * Acceder a servicios internos o de socios * Interacciones API estandarizadas * Acceso controlado a sistemas empresariales **Características:** * Acceso API altamente estructurado * Diseñado para integraciones empresariales * Reutilizable entre múltiples agentes ### Consultas Verificadas Permite que los agentes ejecuten consultas SQL previamente aprobadas de forma segura.
Propósito: * Evitar ejecución arbitraria de consultas * Garantizar gobernanza de datos * Asegurar rendimiento y seguridad Funcionamiento: * Las consultas se definen y validan previamente * Solo esas consultas pueden ejecutarse * El agente puede pasar parámetros, pero no modificar la lógica {% hint style="warning" %} Los agentes no pueden escribir ni modificar SQL. Solo pueden ejecutar consultas verificadas. {% endhint %} ### Archivos Multimedia La herramienta **Archivo multimedia** permite a un agente acceder, consultar y, opcionalmente, enviar archivos durante una conversación. Se utiliza habitualmente cuando un agente necesita compartir documentos, imágenes u otros recursos como parte de su respuesta. Esta herramienta es ideal para materiales de apoyo, informes, recursos visuales y contenido descargable.
Uso ideal para: * Compartir documentos * Entregar imágenes o activos visuales * Proporcionar descargas controladas * Enriquecer respuestas con material de apoyo ### Cómo Crear tu Agente de Chat Una vez creadas las Herramientas y los RAG, el desarrollador puede ensamblar un **Agente de Chat**. Este paso define: * Quién es el agente * Cómo se comporta * A qué información puede acceder Un Agente de Chat actúa como capa de orquestación, combinando: * Identidad e intención * Reglas de comportamiento * Fuentes de conocimiento (RAG o datos tabulares) * Diagramas (relaciones entre tablas) * Capacidades de acción (Herramientas)
En la pestaña **General**, puedes: * Proporcionar un nombre claro y significativo * Escribir una descripción breve * Definir identidad, tono, capacidades y límites * Describir el objetivo principal y criterios de éxito * Proporcionar contexto, restricciones y dominio * Agregar preguntas de ejemplo para guiar al usuario final Después de definir la identidad del agente, el desarrollador **configura a qué recursos puede acceder.** {% @arcade/embed flowId="XZMXCSkFswdfAiYiYxkG" url="" %} {% hint style="info" %} Para la configuración de descubrimiento, [consulta la sección correspondiente.](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/0nQtybzWIM5HC0Kikp7Z/herramientas/discovery) {% endhint %} {% hint style="info" %} Para la creación de esquemas, [consulta la sección correspondiente.](https://docs.gaiodataos.com/gaio-dataos-spanish/~/revisions/0nQtybzWIM5HC0Kikp7Z/herramientas/diagrama-esquema) {% endhint %} --- # 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: ``` GET https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/agentes.md?ask= ``` 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.