Sesión 2 · Conceptos base
Conceptos base para usar un agente de IA en QuickSight
Conceptos de IA, Claude y la SKILL de Factor BI
Antes de empezar a hacer preguntas de negocio conviene tener claros cinco conceptos: qué modelo elegir, qué es un skill, por qué el agente necesita herramientas y permisos, cómo funcionan los proyectos y por qué todo lo valioso se documenta.
Alcance del proyecto
El objetivo es conectar Claude con los dashboards de QuickSight que su empresa ya usa, para poder hacerles preguntas de negocio en lenguaje natural.
- Se arranca con un solo dashboard. Normalmente el de Ventas: maneja ventas, pedidos, remisiones y cotizaciones, y compara contra cualquier periodo anterior que se seleccione, no solo contra año anterior.
- Cualquier otro dashboard de gerencia (compras, artículos, existencias, cuentas por cobrar) se puede conectar en fases posteriores. Requiere hacer antes el mapeo de datos de ese dashboard.
- Cada usuario tiene su propio acceso de QuickSight, y ese acceso es el que conecta con el dashboard. El agente ve exactamente lo que ese usuario tiene permitido ver.
- Un alcance a la vez. Otros proyectos de analítica que tenga en curso se mantienen separados de este; no se mezclan en la misma conversación.
Qué se le puede preguntar
El agente no devuelve solo una tabla: interpreta la pregunta, arma la consulta y analiza el resultado.
- Métricas del negocio con su vocabulario: ventas, pedidos, remisiones, cotizaciones, márgenes, utilidad.
- Acrónimos y atajos:
YTD(year to date, del inicio del año a hoy) o «dame el 80/20»: el agente los entiende sin explicárselos. - Cortes y filtros: por familia de producto, top 10 de clientes, top 10 de vendedores, concentración de cartera.
- Comparativos: contra el periodo que se le indique, con variaciones en porcentaje y en puntos porcentuales.
- Insights de negocio: al pedírselos explícitamente, señala qué movimientos son relevantes, cruza hallazgos entre sí (por ejemplo, la caída de un vendedor contra la caída de un cliente) y plantea hipótesis que uno puede confirmar o descartar.
- Preguntas de seguimiento: sobre el mismo resultado, sin volver a plantear todo el contexto.
Usar la palabra dashboard en la pregunta, para que el agente sepa que debe ir a QuickSight. Y pedirle el plan de la consulta antes de ejecutarla: así se revisa que entendió bien la pregunta antes de que traiga datos.
> Del dashboard de Ventas, dame las ventas YTD de la línea «ABC», con top 10 clientes y top 10 vendedores contra año anterior. Primero muéstrame el plan de la consulta. Al final, dame insights de negocio.
Insight que devuelve el agente: «El crecimiento es de calidad: la utilidad sube más rápido que la venta, así que no viene solo de volumen. Dos observaciones a revisar: un cliente pasó de $2.1 M a $4.7 M (+124 %), un salto atípico que conviene explicar; y la caída de un vendedor coincide casi peso por peso con la caída de un cliente, lo que apunta a reasignación de cartera más que a pérdida real.»
Las cifras de arriba son inventadas para ilustrar el formato de respuesta. En su implementación, los datos salen directamente de su dashboard.
Modelos: elegir con quién se habla
Claude es la aplicación. El modelo es el cerebro que procesa la pregunta, y no vive en su computadora: vive en los servidores de Anthropic. Al iniciar cada conversación se elige cuál usar.
Haiku es como un becario con tres meses en la compañía: contesta rápido, pero su razonamiento no es profundo. Opus es el especialista al que se le consulta un tema complejo. No tiene sentido pedirle al director de la empresa que conteste una pregunta sencilla, ni pedirle a un becario un análisis de cartera.
Qué es un skill
Es la respuesta a la pregunta obvia: si escribo «dame las ventas», ¿cómo sabe el agente que tiene que ir al dashboard de su empresa? Porque tiene un entrenamiento previo que se denomina SKILL.
- Un skill es un paquete de instrucciones que se envía al modelo junto con su pregunta, sin que usted lo vea ni lo escriba.
- El nuestro se llama Factor BI QuickSight Advisor. Contiene la identidad del agente, sus reglas de comunicación y una secuencia de pasos numerados que debe ejecutar para responder.
- Se instala una sola vez desde la configuración de Claude; a partir de ahí opera en cada conversación.
- Existen skills para otras cosas además de dashboards: es un mecanismo general para enseñarle al agente a hacer una tarea específica.
Herramientas y permisos
El mismo modelo que conversa también puede trabajar con herramientas: usar recursos de su computadora y conectarse a servicios externos. Eso es lo que le permite consultar el dashboard.
Solo conversación
Conversa, razona y responde con lo que sabe.
- Conversa y razona
- Puede buscar en internet
- Crea archivos, pero no modifica ningún directorio ni archivo actual de su computadora
Con herramientas
El mismo modelo, con acceso controlado a recursos de su computadora y a servicios externos.
- Lee y crea archivos: Word, Excel, PowerPoint, texto
- Ejecuta código de forma controlada
- Se conecta a Google Drive, Gmail, Calendar, apps de notas de reunión y otros
- Es lo que se necesita para consultar el dashboard
- Los permisos son explícitos. El agente no entra a cualquier carpeta: hay que autorizarle cada una. Y cada conector se autoriza una sola vez; después ya no vuelve a pedirlo.
- Ejemplo de la sesión: se le pidió conectarse a Google Drive, identificar todos los archivos relacionados con un cliente (Comercializadora Bajío, en el ejemplo) y construir con ellos un índice en Word, agrupado por categorías: manuales, diccionarios de datos, videos, documentos técnicos. Ese índice no existía; se armó en la conversación.
Proyectos
Un proyecto agrupa varias conversaciones sobre un mismo tema, con instrucciones fijas y una carpeta de archivos propia.
- Instrucciones del proyecto: un texto que el agente lee al inicio de cada conversación. Ahí van los objetivos, las decisiones ya tomadas, el estado actual del tema y las reglas de operación.
- Carpeta de archivos: el agente puede consultar cualquiera de esos archivos en el momento en que lo necesite. No los lee todos siempre.
- Se comparten: un proyecto puede compartirse con otros usuarios de la organización, y ellos pueden abrir conversaciones nuevas a partir de lo ya documentado.
- Uno por tema. Conviene separar ventas, cuentas por cobrar y comisiones en proyectos distintos, no mezclarlos.
Dentro de un proyecto se abren varias conversaciones, igual que con un cliente se abren varios hilos de correo: uno para facturación, otro para el contrato, otro para la definición del proyecto. A nadie se le ocurre mezclar los tres en un solo hilo.
Documenta todo lo importante
La conversación 2 no puede leer la conversación 1. Y el agente no puede buscar dentro de sus conversaciones pasadas.
Así funciona hoy el agente en un proyecto de Cowork local, que es como corre el conector de QuickSight: aunque estén dentro del mismo proyecto, las conversaciones no comparten historial entre sí. Si algo valioso salió en una conversación y se queda ahí, para efectos prácticos desaparece.
- La solución: en cuanto surja un hallazgo útil, pedirle al agente que lo documente en un archivo dentro de la carpeta del proyecto. Literalmente: «documenta este tema de manera precisa y guárdalo en un archivo».
- El formato importa. Use archivos
.md: texto plano, muy fácil de leer y modificar para el agente, y donde va acumulando información. Word y Excel le cuestan más trabajo. - Los
.mdse ven como código, pero existen visores que los presentan de forma amigable, y usted puede editarlos a mano cuando quiera. - Criterio simple: cualquier información valiosa que se genere en un chat tiene que quedar en algún lado: un
.md, un Excel, un documento. Nunca solo en el chat.
El valor no está en la respuesta puntual, sino en el conocimiento que se va acumulando en la carpeta del proyecto: definiciones, criterios de análisis, hallazgos confirmados. Eso es lo que hace que la siguiente pregunta salga mejor que la anterior.
Y una vez que el análisis ya quedó bien, el agente lo puede entregar en el formato que se necesite:
Temas de otras sesiones
Con los conceptos anteriores ya se puede empezar a preguntar. Estos temas se cubren en las sesiones siguientes, conforme el uso lo vaya pidiendo.