Mi Agente se Rebeló: Intentando Crear un Agente de Bedrock con S3 (y el Famoso Error [información recuperada])
Resumen rápido TL;DR En este laboratorio vas a crear un Bedrock Agent funcional que puede leer documentos en S3, extraer información, ejecutar funciones, responder preguntas de forma estructurada y razonar paso a paso usando Amazon Nova Micro. Todo 100 por ciento desde la consola, sin Studio ni código manual. Tiempo estimado 20–30 min. Servicios usados Bedrock Agents, S3, IAM. Costo muy bajo menor a 0.25 USD.
Objetivo y por qué importa Las empresas pasan de usar solo LLMs a construir agentes inteligentes que integran planificación, razonamiento, recuperación de datos y ejecución de acciones. Un agente bien diseñado planea, recupera datos y ejecuta acciones para responder en contexto sin que el usuario tenga que construir el pipeline completo. Esto es clave para soluciones de inteligencia artificial en empresas, agentes IA y aplicaciones a medida que necesitan grounding real y trazabilidad.
Qué vas a construir Arquitectura simple PDFs en S3 sirven como fuente de documentos. Un Action Group en Bedrock crea una Lambda que consulta S3. El agente usa Amazon Nova Micro para razonar y devolver una respuesta final basada en los documentos y en los resultados de las acciones.
Prerrequisitos Cuenta AWS con Bedrock y S3 habilitados en us-east-1, permisos IAM administrados y tres PDFs con información corporativa listos para subir.
Paso a paso resumido Paso 1 crear el bucket S3 con bloqueo de acceso público y encriptación SSE S3. Paso 2 subir PDFs company-overview.pdf internal-policies.pdf service-pricing.pdf. Paso 3 crear el Bedrock Agent, seleccionar Amazon Nova Micro y escribir instrucciones claras que indiquen cuándo usar datos de S3 y cómo proceder si no hay evidencia directa. Paso 4 crear un Action Group que lee S3 usando quick create para Lambda y definir un parámetro query de tipo String requerido. Paso 5 guardar y preparar el agente. Paso 6 probar con preguntas reales sobre los PDFs y revisar trazas en caso de error.
Problemas comunes y cómo resolverlos Error clásico 1 El agente responde Sorry I am unable to assist with this request Causa probable el role del agente no tiene permisos bedrock InvokeModel Solución editar la política IAM del role y añadir permisos bedrock InvokeModel y bedrock InvokeModelWithResponseStream para el role del agente.
Error clásico 2 Placeholder [retrieved information] o respuestas incompletas Causa probable las instrucciones del agente asumen una knowledge base que no existe o contienen mensajes plantilla que esperan reemplazo Solución actualizar las instrucciones para no exigir exclusivamente datos de una KB y evitar placeholders, por ejemplo indicar que el agente use únicamente los resultados devueltos por las acciones y que si no hay información busque dar la mejor respuesta basada en razonamiento general.
Configuración de instrucciones práctica Evita la palabra EXCLUSIVELY en las instrucciones porque bloquea la respuesta si no hay evidencia directa. Usa una instrucción tipo You are a corporate assistant designed to answer questions using the information provided by the system and the available action groups. Do not assume information; always rely on the results returned by the actions. Renombra action groups para evitar guiones y usa guiones bajos en su lugar read_company_docs y marca parámetros necesarios según su uso.
Depuración paso a paso Usa Trace y Amazon Q dentro de la consola Bedrock para investigar errores. Amazon Q sugiere causas comunes como permisos IAM insuficientes nombres inválidos en action groups y prompts demasiado restrictivos. Revisa el trace del Action invocation y la salida de la Lambda auto generada. Si la Lambda no devuelve datos útiles reemplázala por una que realmente lea los archivos del bucket y extraiga texto o fragmentos relevantes.
Lecciones aprendidas y recomendaciones prácticas 1 Mantén las instrucciones del agente orientadas al uso de acciones y resultados, no a supuestos de una KB inexistente 2 Revisa y corrige permisos IAM para permitir la invocación del modelo 3 Renombra parámetros y action groups sin guiones 4 Diseña respuestas estructuradas con un solo bloque thinking seguido de answer 5 Si necesitas una solución productiva, reemplaza la Lambda auto generada por una que implemente lectura de S3 y extracción de texto.
Errores encontrados resumen Síntomas habituales y causas Sorry I am unable to assist with this request permisos bedrock InvokeModel faltantes El agente pide aclaraciones activación de user__askuser por orquestación interna Placeholder [retrieved information] instrucciones asumían KB inexistente Action Group no se ejecuta parámetro obligatorio o nombre inválido Respuestas incompletas placeholders o estructura inválida Lambda auto generada sin lógica útil.
Recursos oficiales para seguir aprendiendo Amazon Bedrock Agents y Action Groups doc oficial y guías de S3 e IAM son muy útiles para profundizar. En Q2BSTUDIO somos especialistas en desarrollo de software y aplicaciones a medida así como en inteligencia artificial para empresas y ciberseguridad. Si buscas llevar esto a producción podemos apoyarte con servicios de inteligencia artificial y consultoría técnica, incluyendo integración de agentes IA y arquitecturas cloud. Conoce nuestras capacidades en inteligencia artificial en servicios de inteligencia artificial y si tu proyecto requiere migración o integración cloud revisa nuestras opciones de servicios cloud para AWS y Azure en Servicios cloud AWS y Azure.
Palabras clave aplicadas en este artículo aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA power bi automatización de procesos.
Conclusión Este laboratorio muestra el potencial y las trampas al construir agentes Bedrock que interactúan con S3. Compartir tanto los éxitos como los problemas reales es la mejor forma de aprender. En Q2BSTUDIO combinamos experiencia en desarrollo, seguridad y AI para ayudar a transformar prototipos en soluciones productivas y seguras.
