Traiga datos estructurados y no estructurados juntos con Amazon Quick
Bring structured and unstructured data together with Amazon Quick
Puneeth Komaragiri
Las organizaciones recopilan datos en muchas formas. Los datos estructurados viven en bases de datos y hojas de cálculo, mientras que los datos no estructurados se encuentran en documentos, informes y archivos almacenados en sistemas de archivos. Analizar ambos juntos generalmente requiere cambiar entre varias herramientas, ejecutar consultas separadas y correlacionar manualmente los resultados.
Conectar Amazon Simple Storage Service (Amazon S3) como fuente de datos y crear una base de conocimiento.
Crear un Espacio que combina datos estructurados y no estructurados.
Crear y configurar un agente de chat personalizado que consulta en ambos tipos de datos.
Hacer preguntas que abarcan fuentes estructuradas y no estructuradas en una sola conversación.
Arquitectura de la solución
El siguiente diagrama ilustra cómo cada componente se conecta para ofrecer una experiencia de datos unificada a través de Amazon Quick.
Figura 1: Arquitectura de la solución para combinar datos estructurados y no estructurados en Amazon Quick
La arquitectura tiene tres capas:
Capa de datos: Sus datos existen en dos formas. El contenido no estructurado (documentos, PDF, informes) se almacena en Amazon S3 y se indexa a través de una base de conocimientos. Los datos estructurados (métricas, cifras de ventas y indicadores clave de rendimiento operativo) se cargan como conjuntos de datos enriquecidos con descripciones semánticas que el agente utiliza para traducir preguntas a SQL.
Capa de espacio de trabajo: Un Espacio reúne ambos tipos de datos en un solo espacio de trabajo. El Espacio hace referencia a su base de conocimientos para consultas no estructuradas y a sus conjuntos de datos para consultas estructuradas. También puede incluir paneles, cargas de archivos y conectores de acción. Esta es la capa donde los datos de diferentes fuentes convergen en un contexto unificado.
Capa de agente: El agente de chat personalizado se vincula al Espacio y lo utiliza como su fuente de conocimiento. Cuando un usuario hace una pregunta, el agente determina si debe consultar la base de conocimientos, el conjunto de datos o ambos, y devuelve una respuesta combinada con citas. Amazon Quick también aplica guardrails de IA integrados, como la detección de seguridad de contenido, a las interacciones de chat.
Con este enfoque en capas, puede expandir la solución con el tiempo. Cuando agrega una nueva fuente de datos al Espacio, el agente vinculado a ese Espacio puede utilizarla, y las respuestas respetan los permisos del usuario que hace la pregunta.
Requisitos previos
Para seguir este tutorial, necesita:
Una cuenta de Amazon Quick con una suscripción Enterprise para el usuario que sigue este tutorial (crear conjuntos de datos requiere Enterprise). Para obtener más detalles, consulte precios de Amazon Quick.
Un bucket de Amazon S3 para los documentos de su negocio. Para crear uno, consulte la Guía del usuario de Amazon S3.
Acceso de Amazon Quick a su bucket de S3, otorgado por un administrador de Amazon Quick. En la consola de administración, el administrador elige Permisos, luego Recursos de AWS, selecciona Amazon S3 y elige Seleccionar buckets de S3. Los buckets seleccionados tienen permisos de solo lectura por defecto.
Permisos para crear integraciones, bases de conocimientos, conjuntos de datos, espacios y agentes de chat en Amazon Quick.
Preparar sus datos de muestra
Documentos no estructurados: Suba estos a su bucket de Amazon S3 para la base de conocimientos:
Comience conectando Amazon Quick a su bucket de S3. Desde la consola de Amazon Quick, seleccione Conocimiento en el panel de navegación izquierdo.
La página de conocimiento muestra los tipos de conectores disponibles, incluidos Amazon Q Business, Web Crawler, Amazon S3 y opciones de terceros como Google Drive, OneDrive y Microsoft SharePoint.
En Amazon S3, elija Agregar. En el diálogo de creación de la base de conocimiento de S3, en la página Conectar bucket de S3, proporcione los siguientes detalles:
Nombre: Un nombre descriptivo para su integración (por ejemplo, “Mi integración de acceso a datos”).
Ubicación del bucket de S3: Elija Cuenta de instancia de Quick Suite para utilizar un bucket en la misma cuenta de AWS que Amazon Quick, o Otra cuenta de AWS para un bucket en una cuenta diferente.
URL del bucket de S3: El URI de S3 del bucket que contiene sus datos. El bucket debe estar en la misma región que Amazon Quick.
Elija Siguiente.
Figura 2: Diálogo de creación de integración que muestra los campos de conexión de S3
Paso 2: Crear una base de conocimiento
Después de crear la integración de S3, Amazon Quick lo invita a crear una base de conocimiento. La base de conocimiento indexa el contenido de S3 para la búsqueda con capacidad de inteligencia artificial.
Configure la base de conocimiento:
Nombre: “Base de conocimiento empresarial”.
Descripción (opcional): Notas sobre cómo se utilizará la base de conocimiento.
Contenido: Seleccione “Agregar todo el contenido” para indexar todo en el bucket de S3 conectado, o “Agregar contenido específico” para especificar los prefijos de S3 para las carpetas y archivos que se van a incluir (los filtros de prefijos distinguen mayúsculas y minúsculas).
Siguiente: Configuraciones adicionales abre configuraciones opcionales para listas de control de acceso a nivel de documento (ACL) y una carpeta de archivos de metadatos. Decida si utilizar ACL antes de crear la base de conocimiento, porque no podrá cambiar esa elección más tarde. Esta guía utiliza datos de ejemplo, por lo que la configuración predeterminada es suficiente. Para obtener más detalles, consulte Configuración y administración de la integración de Amazon S3.
Elige Crear. Un banner de éxito confirma la integración de S3, y la base de conocimiento comienza a indexar en segundo plano.
Figura 3: Diálogo para crear base de conocimiento con el nombre de Base de conocimiento empresarial y opciones de contenido
Paso 3: Crear y enriquecer un conjunto de datos
Un conjunto de datos es su archivo de datos estructurado cargado en Amazon Quick. Al enriquecer el conjunto de datos con descripciones semánticas, instrucciones personalizadas y tipos de datos correctos, el agente de inteligencia artificial puede interpretar sus datos de manera más precisa. Luego puede traducir preguntas en lenguaje natural a consultas SQL.
Crear el conjunto de datos
Desde la página de inicio de Amazon Quick, navegue hasta Datos en la navegación izquierda.
Elige Crear conjunto de datos, luego selecciona Cargar archivo.
Seleccione el archivo Product_Sales.csv que descargó anteriormente y elija Abrir.
En la pantalla de confirmación, revise los nombres de las columnas y los tipos de datos. Elige Siguiente para crear el conjunto de datos.
Amazon Quick ingesta el archivo en SPICE (el motor de cálculo en memoria) y el conjunto de datos aparece en su lista de conjuntos de datos.
El conjunto de datos toma su nombre del archivo cargado, por lo que aparece como Product_Sales.csv en su cuenta.
Enriquecer el conjunto de datos
Enriquecer su conjunto de datos con información semántica ayuda al AI a entender sus datos en contexto empresarial. El agente utiliza este contexto para traducir preguntas en lenguaje natural a consultas SQL más precisas. Desde la página del conjunto de datos, elija Editar conjunto de datos para ingresar a la vista de preparación de datos.
Transformar: Corregir tipos de datos
En la pestaña Transformar, actualice los tipos de datos para las columnas que se detectaron automáticamente de manera incorrecta. Para este conjunto de datos:
Cambie Fecha de pedido y Clave de fecha de Cadena a Fecha.
Cambie ID de cliente de Cadena a Entero.
Cambie Ventas, Descuento y Beneficio de Cadena a Decimal.
Cambie Cantidad y Precio unitario de Cadena a Entero.
Figura 4: Vista de transformación que muestra los cambios de tipo de datos aplicados al conjunto de datos Product_Sales.csv
Salida: Agregar contexto semántico
Seleccione la pestaña Salida para acceder a los campos de enriquecimiento a nivel de conjunto de datos. Aquí proporciona contexto que ayuda al AI a entender qué representa sus datos y cómo utilizarlos.
Descripción: Agregue una descripción a nivel de conjunto de datos:
“Datos de transacciones de ventas de productos para AnyCompany, que cubren pedidos desde el año fiscal 2024 hasta el año fiscal 2025 en América del Norte, EMEA, Asia Pacífico y América Latina. Incluye detalles de pedidos, información de clientes, líneas de productos y métricas de ingresos.”
Instrucciones personalizadas: Agregue orientación sobre cómo el AI debe consultar estos datos:
PAUTAS DE USO:
Los valores de ingresos están en USD.
Al comparar el rendimiento, agrupe por Región (América del Norte, EMEA, Asia Pacífico, América Latina).
La Fecha de pedido debe utilizarse para el análisis de tendencias basado en el tiempo. El año fiscal coincide con el año calendario.
La Clave de fecha es una representación numérica YYYYMMDD de la Fecha de pedido.
Ventas = Cantidad x Precio unitario x (1 – Descuento)
CASOS DE USO COMUNES:
Comparación del rendimiento de ventas regionales.
Análisis de ingresos de líneas de productos.
Identificación de tendencias trimestrales.
Segmentación de clientes por industria y segmento.
ETIQUETAS: Ventas, ingresos, pedidos, rendimiento regional, análisis de productos
Descripciones de columnas: Seleccione cada columna en el panel izquierdo y agregue una descripción. Por ejemplo:
Order ID: “Identificador único para cada transacción de ventas (formato: REGION-YYYY-NNNNNN)”
Región: “Región geográfica de ventas: Norteamérica, EMEA, Asia Pacífico o América Latina”
Producto: “Nombre del producto de AnyCompany: Analytics Pro, Connect, Automate, AI Assistant, Data Catalog o Integration Hub”
Ventas: “Ingresos de la orden en USD después del descuento”
Segmento: “Segmento de tamaño del cliente: Empresa, Mid-Market o SMB”
Figura 5: Vista de salida que muestra los detalles del conjunto de datos con la descripción y las instrucciones personalizadas configuradas
Elige Guardar y publicar para guardar tus cambios. El resumen del conjunto de datos ahora muestra las columnas con sus tipos de datos correctos y las descripciones que agregaste.
Figura 6: Resumen del conjunto de datos Product_Sales.csv enriquecido que muestra las 16 columnas, los tipos de datos y las descripciones
Este conjunto de datos enriquecido proporciona la capa de datos estructurados para tu solución. Cuando el agente recibe una pregunta de lenguaje natural sobre datos de ventas, utiliza estas descripciones e instrucciones para generar consultas SQL más precisas. Combinado con la base de conocimientos del Paso 2, ahora tienes tanto datos estructurados como no estructurados listos para unir en un Space.
Paso 4: Crear un Space
Spaces en Amazon Quick actúan como espacios de trabajo de datos unificados. Un Space puede contener cargas de archivos, paneles, bases de conocimientos, acciones y conjuntos de datos, lo que le da a tu agente de chat una sola ubicación para consultar a través de tipos de datos.
Desde la navegación izquierda, selecciona Spaces y crea un nuevo Space. Asígnale el nombre “Centro de inteligencia empresarial”.
Agrega tu base de conocimientos y conjunto de datos al Space:
Elige Agregar conocimiento y selecciona Bases de conocimiento de la lista. Selecciona “Base de conocimiento empresarial” de la lista.
Elige Agregar conocimiento nuevamente y selecciona Conjuntos de datos de la lista. Selecciona “Product_Sales.csv” de la lista.
Ahora, el Space muestra tanto tu base de conocimiento (documentos no estructurados) como tu conjunto de datos enriquecido (datos de ventas estructurados) vinculados como fuentes de datos. Este es el centro central donde ambos tipos de datos se unen, brindando a tu agente de chat un solo lugar para consultar todo. La Figura 7 muestra el Space con ambos recursos en el estado Listo.
Figura 7: Business Intelligence Hub Space showing the Product_Sales.csv dataset and Business Knowledge Base
Paso 5: Crear un agente de chat personalizado
Navega a Agentes de chat en la navegación izquierda y elige Crear agente de chat. Amazon Quick presenta un constructor de prompts donde puedes describir tu agente en lenguaje natural o elegir entre plantillas como Guía de capacitación, Coordinador de proyectos y Asistente de incorporación.
Para esta guía, elige Omitir para configurar el agente manualmente.
Figura 8: Chat agent creation screen with the prompt builder and sample templates
Configurar la personalidad del agente
El panel de configuración tiene varias secciones. Comienza con la personalidad del agente:
Identidad del agente: “Asistente de inteligencia empresarial”
Descripción: “Un asistente de inteligencia artificial que rompe los silos de información analizando datos empresariales de tu base de conocimiento”
Para las instrucciones de la personalidad del agente, ingresa:
You are a Business Intelligence Assistant designed to help organizations break down information silos. Your primary functions are:
1. Analyze business data stored in S3
2. Retrieve relevant findings from the reports and memos in the knowledge base
3. Provide comprehensive insights that connect internal data with external trends
4. Generate clear, actionable recommendations based on data analysis
When answering questions, always cite your sources and explain how you arrived at your conclusions. Focus on delivering practical business value and highlighting patterns across different information sources.
Aparece una nota que confirma que tu agente de chat viene equipado con guardrails empresariales.
Figura 9: Configuración de la persona del agente con identidad y instrucciones de la persona llenadas
Establecer estilo de comunicación
En Estilo de comunicación, seleccione un estilo de respuesta preestablecido. Las opciones incluyen Ejecutivo, Técnico y Creativo. Para un caso de uso de inteligencia empresarial, seleccione Ejecutivo.
Vincular fuentes de conocimiento
En Fuentes de conocimiento, elija Vincular espacios y seleccione el espacio "Centro de inteligencia empresarial" que creó anteriormente. Esto da al agente acceso a su base de conocimientos de S3 y otras fuentes de datos en ese espacio. Cuando vincula un espacio, el agente responde a partir del conocimiento del modelo de lenguaje grande (LLM) y los recursos vinculados solo.
También puede adjuntar documentos de referencia (PDF, TXT, HTML, MD, CSV, DOC, DOCX) directamente al agente para proporcionar contexto adicional. Amazon Quick extrae hasta 100,000 caracteres de texto de los documentos de referencia que carga.
Figura 10: Sección Fuentes de conocimiento que muestra el espacio Centro de inteligencia empresarial vinculado
Personalizar el agente
En Personalización, configure:
Mensaje de bienvenida: “Hola. Soy su asistente de inteligencia empresarial. Puedo ayudarlo a analizar sus datos de ventas y documentos empresariales y proporcionar información comparando la información interna con las tendencias del mercado. ¿En qué puedo ayudarlo hoy?”
Prompts sugeridos: “Resumen de los conocimientos clave de nuestros informes” y “Análisis del desempeño de ventas trimestral”
Figura 11: Sección de personalización con el mensaje de bienvenida y las sugerencias de prompts
Iniciar el agente
Seleccione Iniciar agente de chat. El panel derecho muestra una vista previa en vivo de su agente con el mensaje de bienvenida y las sugerencias de prompts que se muestran.
Figura 12: Asistente de Inteligencia Empresarial iniciado con el mensaje de bienvenida y las sugerencias de prompts en el panel de chat
Paso 6: Consultar a través de datos estructurados y no estructurados
Con el agente en ejecución, comience con una pregunta sobre sus resultados comerciales:
¿Cómo cambió la venta por región en 2025?
Para esta pregunta, el agente combina los resultados del conjunto de datos Product_Sales.csv con los documentos de la base de conocimientos de S3. Devuelve una respuesta con desgloses de ventas regionales, tendencias y citas que se remontan a cada fuente.
La Figura 13 muestra la respuesta. Cada marcador de cita enlaza una figura con su documento de origen.
Figura 13: Respuesta del agente de chat que muestra el análisis de ventas regionales del conjunto de datos y los documentos de la base de conocimientos
Cuando hace una pregunta sobre datos estructurados, el agente utiliza text-to-SQL para traducir su lenguaje natural a una consulta SQL. Ejecuta la consulta contra el conjunto de datos y devuelve los resultados en un formato legible. Esto significa que puede hacer preguntas analíticas complejas sin escribir SQL usted mismo.
A continuación, pregunte sobre un documento específico:
¿Cuáles son las prioridades estratégicas clave delineadas en nuestro memorándum de estrategia de producto?
El agente resume los pilares estratégicos, la hoja de ruta para el año fiscal 2026 y los requisitos de inversión del Memorándum de Estrategia de Producto, como se muestra en la Figura 14.
Figura 14: Respuesta del agente de chat que resume las prioridades estratégicas del Memorándum de Estrategia de Producto
Finalmente, haga una pregunta que necesite ambos tipos de datos:
¿Cómo se alinean nuestros resultados de ventas de 2025 con las tendencias del mercado identificadas en nuestro informe de análisis?
El agente compara las tendencias en el Informe de Análisis de Mercado con los resultados de sus datos de ventas y cita cada fuente, como se muestra en la Figura 15.
Figura 15: Respuesta del agente de chat que compara los resultados de ventas de 2025 con las tendencias del mercado del Informe de Análisis de Mercado
Este es el valor central de combinar tipos de datos en un solo Espacio. El agente puede extraer datos de datos estructurados CSV y documentos no estructurados en la misma respuesta. No necesita saber dónde viven los datos.
Paso 7: Generar artefactos e informes utilizando lenguaje natural
El Asistente de Inteligencia Empresarial también puede generar documentos formateados, incluyendo presentaciones de Microsoft PowerPoint, hojas de cálculo de Microsoft Excel y documentos de Microsoft Word. Intente estas solicitudes en el agente de chat:
“Crear una presentación de PowerPoint que resuma el desempeño de las ventas de AnyCompany en el cuarto trimestre de 2025 por región, incluyendo tendencias clave y recomendaciones.”
“Generar una hoja de cálculo de Excel que muestre los 10 pedidos principales por ingresos con columnas de ID de pedido, Región, Producto y Ingresos.”
“Crear un documento de Word con un resumen de la revisión empresarial trimestral basado en nuestros datos de revisión anual.”
Figura 16: Agente de chat que confirma la solicitud y prepara un esquema de presentación de PowerPoint para el desempeño de ventas de AnyCompany en Q4 2025
Figura 17: Presentación de PowerPoint generada de ocho diapositivas con un archivo AnyCompany_FY2025_Sales_Performance.pptx descargable
Paso 8: Compartir el agente
Al lanzar un agente de chat, permanece privado hasta que lo compartas. Después de probar el agente, compártelo con tu equipo:
Desde la navegación izquierda, elige Agentes de chat.
En la columna Acciones para Asistente de inteligencia empresarial, elige el icono de menú y luego elige Compartir.
Ingresa los usuarios o grupos con los que deseas compartir, asigna permisos de Propietario o Visualizador y elige Compartir.
El agente devuelve respuestas que tienen en cuenta los permisos, y una base de conocimientos solo está disponible para su creador hasta que actualices sus permisos. Asegúrate de que las personas con las que compartas el agente también tengan acceso al Espacio, la base de conocimientos y el conjunto de datos. Para obtener más detalles, consulta Agentes de chat personalizados.
Lo que lograste
En esta guía paso a paso, lograste:
Conectar Amazon S3 como fuente de datos a través de una integración.
Crear una base de conocimientos que indexa documentos empresariales no estructurados.
Crear y enriquecer un conjunto de datos de ventas de productos para consultas de datos estructurados.
Crear un Espacio que sirve como un centro de datos unificado para tu agente de chat.
Configurar un agente de chat personalizado con una persona definida y fuentes de conocimientos vinculadas.
Consultar al agente en datos estructurados y no estructurados en una sola conversación.
Generar una presentación de PowerPoint a partir de una solicitud de chat.
Compartir el agente con tu equipo.
Prácticas recomendadas
Utilice las siguientes prácticas a medida que pasa de esta guía a sus propios datos:
Organice sus datos de S3: Utilice estructuras de carpetas claras y convenciones de nomenclatura de archivos. Una estructura clara también hace que sea más sencillo delimitar un conocimiento base a prefijos de S3 específicos.
Escriba instrucciones de persona específicas: Cuanto más específicas sean sus instrucciones, más consistentes serán las respuestas del agente. Incluya orientación sobre cómo citar fuentes y manejar consultas ambiguas.
Utilice Espacios para controlar el alcance: En lugar de dar a un agente acceso a todo, cree Espacios enfocados con solo las fuentes de datos relevantes para el propósito de ese agente.
Comience con sugerencias de prompts: Las sugerencias de prompts ayudan a los usuarios a entender qué puede hacer el agente. Elija prompts que demuestren el rango del agente en ambos datos estructurados y no estructurados.
Pruebe antes de compartir: Utilice el panel de vista previa para probar su agente con preguntas representativas antes de compartirlo con su equipo.
Consideraciones de seguridad
Bajo el modelo de responsabilidad compartida de AWS, usted es responsable de configurar el acceso a sus datos, bases de conocimiento y agentes. Considere lo siguiente al adaptar esta solución:
Conceda acceso a S3 con los privilegios mínimos necesarios: Otorgue a Amazon Quick acceso solo a los buckets que necesitan sus bases de conocimiento. Los buckets que selecciona un administrador tienen permisos de solo lectura por defecto. Si crea bases de conocimiento a través de la API, puede proporcionar un rol personalizado de AWS Identity and Access Management (IAM) para una fuente de datos de S3 individual en lugar de conceder acceso a S3 en toda la cuenta.
Control el acceso a los documentos: Si los documentos requieren acceso por usuario o por grupo, habilite los ACL de nivel de documento al crear la base de conocimiento. No podrá cambiar esta elección más adelante.
Agregue solo contenido de confianza: El agente utiliza los documentos en su base de conocimiento para formar respuestas, así que incluya solo contenido de fuentes que confíe.
Comparta de manera selectiva: Los agentes de chat y las bases de conocimiento son privados por defecto. Comparta solo con los usuarios y grupos que los necesiten.
Utilice los guardrails como una capa: Amazon Quick incluye una pantalla de seguridad de contenido integrada, y los administradores pueden agregar hasta 50 palabras o frases bloqueadas. Estos controles ayudan a reducir el riesgo, pero no reemplazan su responsabilidad de configurar el acceso y los permisos. Para obtener más detalles, consulte guardrails de IA en Amazon Quick.
Limpieza
Para evitar cargos continuos, elimine los recursos que creó:
Elimine el agente de chat de la página de agentes de chat.
Elimine el Space de la página de Spaces.
Elimine el conjunto de datos Product_Sales.csv de la página de conjuntos de datos.
Elimine la base de conocimiento y la integración de S3 de la página de conocimiento.
Si creó un bucket de S3 específicamente para este recorrido, vacíelo y elimínelo. La eliminación de un bucket y sus objetos es permanente, así que respalde cualquier dato que desee conservar.
Las suscripciones de usuario de Amazon Quick y las tarifas de cuenta se facturan por separado de estos recursos. Para obtener más detalles, consulte precios de Amazon Quick.
Conclusión
Amazon Quick le ayuda a combinar datos estructurados y no estructurados. En esta publicación, conectó S3 como base de conocimiento, enriqueció un conjunto de datos, creó un Space y creó un agente de chat personalizado. Los usuarios empresariales ahora pueden consultar ambos tipos de datos a través de una interfaz conversacional única, sin necesidad de saber dónde viven los datos o cómo escribir consultas.
Acerca de los autores
Organizations collect data in many forms. Structured data lives in databases and spreadsheets, whereas unstructured data sits in documents, reports, and files stored across file systems. Analyzing both together typically requires switching between multiple tools, running separate queries, and manually correlating results.
Amazon Quick addresses this with a unified experience. You can connect structured data through enriched datasets and unstructured data through S3-backed knowledge bases. You can then query both through a single conversational AI agent.
In this post, you learn how to:
Connect Amazon Simple Storage Service (Amazon S3) as a data source and create a knowledge base.
Build a Space that combines structured and unstructured data.
Create and configure a custom chat agent that queries across both data types.
Ask questions that span structured and unstructured sources in a single conversation.
Solution architecture
The following diagram illustrates how each component connects to deliver a unified data experience through Amazon Quick.
Figure 1: Solution architecture for combining structured and unstructured data in Amazon Quick
The architecture has three layers:
Data layer: Your data exists in two forms. Unstructured content (documents, PDFs, reports) is stored in Amazon S3 and indexed through a knowledge base. Structured data (metrics, sales figures, and operational key performance indicators) is loaded as enriched datasets with semantic descriptions that the agent uses to translate questions into SQL.
Workspace layer: A Space brings both data types together into a single workspace. The Space references your knowledge base for unstructured queries and your datasets for structured queries. It can also include dashboards, file uploads, and action connectors. This is the layer where data from different sources converges into a unified context.
Agent layer: The custom chat agent links to the Space and uses it as its knowledge source. When a user asks a question, the agent determines whether to query the knowledge base, the dataset, or both, and returns a combined response with citations. Amazon Quick also applies built-in AI guardrails, such as content safety screening, to chat interactions.
With this layered approach, you can expand the solution over time. When you add a new data source to the Space, the agent linked to that Space can use it, and responses respect the permissions of the user who asks.
Prerequisites
To follow along with this walkthrough, you need:
An Amazon Quick account with an Enterprise subscription for the user who follows this walkthrough (creating datasets requires Enterprise). For details, see Amazon Quick pricing.
An Amazon S3 bucket for your business documents. To create one, see the Amazon S3 User Guide.
Amazon Quick access to your S3 bucket, granted by an Amazon Quick administrator. In the admin console, the administrator chooses Permissions, then AWS resources, selects Amazon S3, and chooses Select S3 buckets. Selected buckets have read-only permissions by default.
Permissions to create integrations, knowledge bases, datasets, spaces, and chat agents in Amazon Quick.
Prepare your sample data
This walkthrough uses two types of data:
Unstructured documents: Upload these to your Amazon S3 bucket for the knowledge base:
Start by connecting Amazon Quick to your S3 bucket. From the Amazon Quick console, select Knowledge in the left navigation panel.
The knowledge page shows available connector types, including Amazon Q Business, Web Crawler, Amazon S3, and third-party options like Google Drive, OneDrive, and Microsoft SharePoint.
Under Amazon S3, choose Add. In the Create S3 knowledge base dialog, on the Connect S3 bucket page, provide the following details:
Name: A descriptive name for your integration (for example, “My Data Access Integration”).
S3 bucket location: Choose Quick Suite instance account to use a bucket in the same AWS account as Amazon Quick, or Other AWS account for a bucket in a different account.
S3 bucket URL: The S3 URI of the bucket containing your data. The bucket must be in the same Region as Amazon Quick.
Choose Next.
Figure 2: Create integration dialog showing the S3 connection fields
Step 2: Create a knowledge base
After the S3 integration is created, Amazon Quick prompts you to create a knowledge base. The knowledge base indexes your S3 content for AI-powered search.
Configure the knowledge base:
Name: “Business Knowledge Base”.
Description (optional): Notes about how the knowledge base will be used.
Content: Select “Add all content” to index everything in the connected S3 bucket, or “Add specific content” to specify the S3 prefixes for the folders and files to include (prefix filters are case-sensitive).
Next: Additional settings opens optional settings for document-level access control lists (ACLs) and a metadata files folder. Decide whether to use ACLs before you create the knowledge base, because you can’t change that choice later. This walkthrough uses sample data, so the default settings are sufficient. For details, see Set up and manage Amazon S3 integration.
Choose Create. A success banner confirms the S3 integration, and the knowledge base begins indexing in the background.
Figure 3: Create knowledge base dialog with the Business Knowledge Base name and content options
Step 3: Create and enrich a dataset
A dataset is your structured data file loaded into Amazon Quick. By enriching the dataset with semantic descriptions, custom instructions, and correct data types, the AI agent can interpret your data more accurately. It can then translate natural language questions into SQL queries.
Create the dataset
From the Amazon Quick home page, navigate to Data in the left navigation.
Choose Create dataset, then select Upload file.
Select the Product_Sales.csv file you downloaded earlier and choose Open.
On the confirmation screen, review the column names and data types. Choose Next to create the dataset.
Amazon Quick ingests the file into SPICE (the in-memory calculation engine) and the dataset appears in your dataset list.
The dataset takes its name from the uploaded file, so it appears as Product_Sales.csv in your account.
Enrich the dataset
Enriching your dataset with semantic information helps the AI understand your data in business context. The agent uses this context to translate natural language questions into more accurate SQL queries. From the dataset page, choose Edit dataset to enter the data preparation view.
Transform: Fix data types
In the Transform tab, update data types for columns that were auto-detected incorrectly. For this dataset:
Change Order Date and Date Key from String to Date.
Change Customer ID from String to Integer.
Change Sales, Discount, and Profit from String to Decimal.
Change Quantity and Unit Price from String to Integer.
Figure 4: Transform view showing data type changes applied to the Product_Sales.csv dataset
Output: Add semantic context
Select the Output tab to access the dataset-level enrichment fields. Here you provide context that helps the AI understand what your data represents and how to use it.
Description: Add a dataset-level description:
“Product sales transaction data for AnyCompany, covering orders from FY2024-FY2025 across North America, EMEA, Asia Pacific, and Latin America. Includes order details, customer information, product lines, and revenue metrics.”
Custom instructions: Add guidance for how the AI should query this data:
USAGE GUIDELINES:
Revenue values are in USD.
When comparing performance, group by Region (North America, EMEA, Asia Pacific, Latin America).
Order Date should be used for time-based trend analysis. The fiscal year matches the calendar year.
Date Key is a numeric YYYYMMDD representation of Order Date.
Column descriptions: Select each column in the left panel and add a description. For example:
Order ID: “Unique identifier for each sales transaction (format: REGION-YYYY-NNNNNN)”
Region: “Geographic sales region: North America, EMEA, Asia Pacific, or Latin America”
Product: “AnyCompany product name: Analytics Pro, Connect, Automate, AI Assistant, Data Catalog, or Integration Hub”
Sales: “Order revenue in USD after discount”
Segment: “Customer size segment: Enterprise, Mid-Market, or SMB”
Figure 5: Output view showing dataset details with Description and Custom instructions configured
Choose Save & publish to save your changes. The dataset summary now shows the columns with their correct data types and the descriptions you added.
Figure 6: Enriched Product_Sales.csv dataset summary showing all 16 columns, data types, and descriptions
This enriched dataset provides the structured data layer for your solution. When the agent receives a natural language question about sales data, it uses these descriptions and instructions to generate more accurate SQL queries. Combined with the knowledge base from Step 2, you now have both structured and unstructured data ready to bring together in a Space.
Step 4: Create a Space
Spaces in Amazon Quick act as unified data workspaces. A Space can hold file uploads, dashboards, knowledge bases, actions, and datasets, giving your chat agent a single location to query across data types.
From the left navigation, select Spaces and create a new Space. Name it “Business Intelligence Hub”.
Add your knowledge base and dataset to the Space:
Choose Add knowledge and select Knowledge bases from the list. Select “Business Knowledge Base” from the list.
Choose Add knowledge again and select Datasets from the list. Select “Product_Sales.csv” from the list.
The Space now shows both your knowledge base (unstructured documents) and your enriched dataset (structured sales data) linked as data sources. This is the central hub where both data types come together, giving your chat agent a single place to query across everything. Figure 7 shows the Space with both resources in the Ready state.
Figure 7: Business Intelligence Hub Space showing the Product_Sales.csv dataset and Business Knowledge Base
Step 5: Create a custom chat agent
Navigate to Chat agents in the left navigation and choose Create chat agent. Amazon Quick presents a prompt builder where you can describe your agent in natural language or choose from templates like Training Guide, Project Coordinator, and Onboarding Helper.
For this walkthrough, choose Skip to configure the agent manually.
Figure 8: Chat agent creation screen with the prompt builder and sample templates
Configure the agent persona
The configuration panel has several sections. Start with the Agent Persona:
Agent identity: “Business Intelligence Assistant”
Description: “An AI assistant that breaks down information silos by analyzing business data from your knowledge base”
For Agent Persona instructions, enter:
You are a Business Intelligence Assistant designed to help organizations break down information silos. Your primary functions are:
1. Analyze business data stored in S3
2. Retrieve relevant findings from the reports and memos in the knowledge base
3. Provide comprehensive insights that connect internal data with external trends
4. Generate clear, actionable recommendations based on data analysis
When answering questions, always cite your sources and explain how you arrived at your conclusions. Focus on delivering practical business value and highlighting patterns across different information sources.
A note appears confirming that your chat agent comes equipped with enterprise guardrails.
Figure 9: Agent persona configuration with identity and persona instructions filled in
Set communication style
Under Communication style, pick a response style preset. Options include Executive, Technical, and Creative. For a business intelligence use case, select Executive.
Link knowledge sources
Under Knowledge Sources, choose Link spaces and select the “Business Intelligence Hub” Space you created earlier. This gives the agent access to your S3 knowledge base and other data sources in that Space. When you link a Space, the agent answers from large language model (LLM) knowledge and the linked resources only.
You can also attach reference documents (PDF, TXT, HTML, MD, CSV, DOC, DOCX) directly to the agent for additional context. Amazon Quick extracts up to 100,000 characters of text from the reference documents that you upload.
Figure 10: Knowledge Sources section showing the linked Business Intelligence Hub Space
Customize the agent
Under Customization, configure:
Welcome message: “Hello! I’m your Business Intelligence Assistant. I can help you analyze your sales data and business documents and provide insights by comparing internal information with market trends. How can I help you today?”
Suggested prompts: “Summarize key insights from our reports” and “Analyze our quarterly sales performance”
Figure 11: Customization section with the welcome message and suggested prompts
Launch the agent
Choose Launch chat agent. The right panel shows a live preview of your agent with the welcome message and suggested prompts displayed.
Figure 12: Launched Business Intelligence Assistant with the welcome message and suggested prompts in the chat panel
Step 6: Query across structured and unstructured data
With the agent running, start with a question about your business results:
How did sales change by region in 2025?
For this question, the agent combines results from the Product_Sales.csv dataset with the documents in the S3 knowledge base. It returns a response with regional sales breakdowns, trends, and citations that point back to each source.
Figure 13 shows the response. Each citation marker links a figure back to its source document.
Figure 13: Chat agent response showing regional sales analysis from the dataset and the knowledge base documents
When you ask a question about structured data, the agent uses text-to-SQL to translate your natural language into a SQL query. It runs the query against the dataset and returns the results in a readable format. This means you can ask complex analytical questions without writing SQL yourself.
Next, ask about a specific document:
What are the key strategic priorities outlined in our product strategy memo?
The agent summarizes the strategic pillars, the FY2026 roadmap, and the investment requirements from the Product Strategy Memo, as shown in Figure 14.
Figure 14: Chat agent response summarizing strategic priorities from the Product Strategy Memo
Finally, ask a question that needs both data types:
How do our 2025 sales results align with the market trends identified in our analysis report?
The agent compares the trends in the Market Analysis Report with results from your sales data and cites each source, as shown in Figure 15.
Figure 15: Chat agent response comparing 2025 sales results with market trends from the Market Analysis Report
This is the core value of combining data types in a single Space. The agent can pull from structured CSV data and unstructured documents in the same response. You don’t need to know where the data lives.
Step 7: Generate artifacts and reports using natural language
The Business Intelligence Assistant can also generate formatted documents, including Microsoft PowerPoint presentations, Microsoft Excel spreadsheets, and Microsoft Word documents. Try these prompts in the chat agent:
“Create a PowerPoint presentation summarizing AnyCompany’s Q4 2025 sales performance by region, including key trends and recommendations.”
“Generate an Excel spreadsheet showing the top 10 orders by revenue with Order ID, Region, Product, and Revenue columns.”
“Create a Word document with a quarterly business review summary based on our annual review data.”
Figure 16: Chat agent confirming the request and preparing a PowerPoint outline for AnyCompany’s Q4 2025 sales performance
Figure 17: Generated eight-slide PowerPoint with a downloadable AnyCompany_FY2025_Sales_Performance.pptx file
Step 8: Share the agent
When you launch a chat agent, it remains private until you share it. After you test the agent, share it with your team:
From the left navigation, choose Chat agents.
In the Actions column for Business Intelligence Assistant, choose the menu icon, and then choose Share.
Enter the users or groups to share with, assign Owner or Viewer permissions, and then choose Share.
The agent returns permissions-aware responses, and a knowledge base is available only to its creator until you update its permissions. Make sure that the people you share the agent with also have access to the Space, the knowledge base, and the dataset. For details, see Custom chat agents.
What you accomplished
In this walkthrough, you:
Connected Amazon S3 as a data source through an integration.
Created a knowledge base that indexes unstructured business documents.
Created and enriched a Product Sales dataset for structured data queries.
Built a Space that serves as a unified data hub for your chat agent.
Configured a custom chat agent with a defined persona and linked knowledge sources.
Queried the agent across structured and unstructured data in a single conversation.
Generated a PowerPoint presentation from a chat prompt.
Shared the agent with your team.
Best practices
Use the following practices as you move from this walkthrough to your own data:
Organize your S3 data: Use clear folder structures and file naming conventions. A clear structure also makes it more straightforward to scope a knowledge base to specific S3 prefixes.
Write specific persona instructions: The more specific your instructions, the more consistent the agent responses. Include guidance on how to cite sources and handle ambiguous queries.
Use Spaces to control scope: Rather than giving an agent access to everything, create focused Spaces with only the data sources relevant to that agent’s purpose.
Start with suggested prompts: Suggested prompts help users understand what the agent can do. Choose prompts that demonstrate the agent’s range across both structured and unstructured data.
Test before sharing: Use the preview panel to test your agent with representative questions before sharing it with your team.
Security considerations
Under the AWS shared responsibility model, you are responsible for configuring access to your data, knowledge bases, and agents. Consider the following as you adapt this solution:
Grant least-privilege S3 access: Give Amazon Quick access only to the buckets that your knowledge bases need. Buckets that an administrator selects have read-only permissions by default. If you create knowledge bases through the API, you can provide a custom AWS Identity and Access Management (IAM) role for an individual S3 data source instead of granting account-wide S3 access.
Control document access: If documents require per-user or per-group access, enable document-level ACLs when you create the knowledge base. You can’t change this choice later.
Encrypted buckets: If your bucket uses AWS Key Management Service (AWS KMS) keys, follow the AWS KMS steps in the administrator setup guide.
Add only trusted content: The agent uses the documents in your knowledge base to form responses, so include only content from sources you trust.
Share selectively: Chat agents and knowledge bases are private by default. Share them only with the users and groups that need them.
Use guardrails as one layer: Amazon Quick includes built-in content safety screening, and administrators can add up to 50 blocked words or phrases. These controls help reduce risk but don’t replace your responsibility to configure access and permissions. For details, see AI guardrails in Amazon Quick.
Clean up
To avoid ongoing charges, remove the resources you created:
Delete the chat agent from the Chat agents page.
Delete the Space from the Spaces page.
Delete the Product_Sales.csv dataset from the Datasets page.
Delete the knowledge base and S3 integration from the Knowledge page.
If you created an S3 bucket specifically for this walkthrough, empty and delete it. Deleting a bucket and its objects is permanent, so back up any data that you want to keep.
Amazon Quick user subscriptions and account fees are billed separately from these resources. For details, see Amazon Quick pricing.
Conclusion
Amazon Quick helps you bring structured and unstructured data together. In this post, you connected S3 as a knowledge base, enriched a dataset, built a Space, and created a custom chat agent. Business users can now query both data types through a single conversational interface, without needing to know where the data lives or how to write queries.
About the authors
¿Tiene un proyecto de software o plataforma SaaS en mente?
Hable directamente con nuestros arquitectos de software en SoftAndino. Le brindamos asesoría técnica y cotización inmediata sin compromiso.