Herramienta Instrucción
Herramienta Instrucción
Requisitos del rol de usuario
Rol de usuario* | Acceso a herramientas/características |
|---|---|
Usuario completo | ✓ |
Usuario básico | X |
* Se aplica a los clientes de las ediciones profesional y empresarial de Alteryx One en las versiones 2025.1 o posteriores de Designer.
Utiliza la herramienta Instrucción para enviar instrucciones a un Modelo de lenguaje grande (LLM) y, a continuación, recibe la respuesta del modelo como salida. También puedes configurar los parámetros de LLM para ajustar la salida del modelo.
Componentes de la herramienta
La herramienta Instrucción tiene tres anclas (dos de entrada y una de salida):
Ancla de entrada M: (opcional) utiliza el ancla de entrada M para conectar la configuración de conexión del modelo desde la
Herramienta Anulación de LLM. De forma alternativa, configura una conexión dentro de esta herramienta.Ancla de entrada D: (opcional) utiliza el ancla de entrada D para conectar los datos que quieres agregar a tu Instrucción. La herramienta Instrucción acepta tipos de dato estándar (por ejemplo, Cadena, Numérico y Fecha y hora) además de datos Blob de
Herramienta Entrada de Blob.Ancla de salida: utiliza esta ancla para pasar la respuesta del modelo a herramientas posteriores del flujo de trabajo.
Configurar la herramienta
Conexión con el servicio de modelo de IA en Alteryx One
Si no utilizas la herramienta Anulación de LLM para proporcionar la configuración de conexión del modelo a la herramienta Instrucción, debes configurar una conexión con el servicio de modelo de IA en Alteryx One.
Para configurar por primera vez la herramienta Instrucción, crea un enlace Alteryx a tu espacio de trabajo de Alteryx One. Si iniciaste sesión en Designer través de Alteryx One, deberías ver una conexión ya configurada para ese espacio de trabajo.
Conexión de LLM
Importante
Antes de que puedas seleccionar un LLM, debe crear una conexión LLM en Alteryx One.
Utiliza el menú desplegable Proveedor de LLM para seleccionar el proveedor que deseas utilizar en tu flujo de trabajo. Si conectaste la herramienta Anulación de LLM, esta opción estará deshabilitada.
Utiliza el menú desplegable Seleccionar modelo para seleccionar un modelo disponible de tu proveedor de LLM. Si conectaste la herramienta Anulación de LLM y seleccionaste un modelo específico, esta opción estará deshabilitada.
Configuración de instrucciones
Utiliza la sección Configuraciones de Instrucción para crear la instrucción y configurar las columnas de datos asociadas con la instrucción y la respuesta.
Ingresa tu instrucción en el campo Plantilla de instrucciones. Para obtener una estimación del recuento de tokens de tu indicador, consulta Recuento de tokens en la parte inferior del campo Plantilla de instrucciones. El recuento de tokens no tiene en cuenta los tokens adicionales que podrían provenir de columnas de datos insertadas.
Incluye datos anteriores en tu mensaje para realizar análisis más avanzados. La herramienta Instrucción crea un nuevo mensaje para cada fila de tus datos entrantes. A continuación, la herramienta envía una solicitud LLM para cada una de estas filas.
Para insertar una columna de datos de entrada, tienes estas opciones…
Ingresar un corchete de apertura (
[) en el campo de texto para que aparezca el menú de selección de columnas. También puedes escribir el nombre de la columna entre corchetes ([]).Selecciona una columna en el menú desplegable Insertar campo.
Para adjuntar datos no estructurados, como archivos de imagen o PDF, selecciona la columna que contiene los datos no estructurados en el menú desplegable Adjuntar columnas sin texto. Utiliza una
Herramienta Entrada de Blob para incorporar tus imágenes y archivos PDF al flujo de trabajo.Nota
La compatibilidad con datos no estructurados, como imágenes y archivos PDF, depende de tu proveedor de LLM y del modelo que selecciones. Consulta la documentación de tu proveedor de LLM para obtener más información sobre los tipos de datos multimodales o no estructurados admitidos.
Ingresa el Nombre de la columna de respuesta. Esta columna contiene la respuesta del LLM a tu instrucción.
Ejecuta el flujo de trabajo.
Generador de instrucciones
Utiliza Generador de instrucciones para probar rápidamente diferentes instrucciones y configuraciones de modelos. Luego, puedes comparar los resultados con el historial de instrucciones. Para experimentar con diferentes modelos y configuraciones de modelos, ejecuta el flujo de trabajo con el mensaje inicial y, a continuación, selecciona Refinar y probar en el generador de instrucciones para abrir la ventana Generador de instrucciones.
Importante
El generador de instrucciones requiere datos conectados al ancla de entrada D.
Pestaña Espacio de trabajo de la instrucción
Utiliza la pestaña Espacio de trabajo de la instrucción para ingresar tus instrucciones y actualizar las configuraciones del modelo:
Utiliza el menú desplegable Seleccionar modelo para seleccionar un modelo disponible de tu proveedor de LLM.
Ingresa la cantidad de registros para probar. Si tienes un conjunto de datos grande, utiliza esta configuración para limitar la cantidad de registros probados con tu instrucción.
Configura los parámetros del modelo para Temperatura, Máximo de tokens de salida y TopP. Consulta la sección Configuración de los ajustes de modelo avanzado para obtener descripciones de parámetros.
Ingresa o actualiza tu instrucción en el campo de texto Plantilla de Instrucción.
Sugerencia
Para obtener ayuda para crear un símbolo listo para usar, selecciona Generar una instrucción para mí y, a continuación, describe tu tarea. Para utilizar esta característica, tu cuenta de Alteryx One debe tener acceso a Alteryx Copilot.
Selecciona Probar y ejecutar para ver las respuestas de muestra de cada fila.
Si te gustan las respuestas de la nueva instrucción, selecciona Guardar instrucción en lienzo para actualizar la herramienta Instrucción con la nueva instrucción y la configuración del modelo.
Pestaña Historial
Utiliza la pestaña Historial para ver tus instrucciones anteriores, parámetros del modelo y una respuesta de muestra.
Para cada mensaje anterior, tienes las siguientes opciones:
Agregar al lienzo: actualiza la herramienta Instrucción con la instrucción seleccionada y los parámetros del modelo asociados.
Editar instrucción: vuelve a la pestaña Configuración con la instrucción seleccionada y los parámetros del modelo asociados. Selecciona el menú de tres puntos junto a Agregar al lienzo para encontrar esta opción.
Descargar resultados: guarda un archivo CSV que contiene los parámetros de la instrucción y del modelo para la fila actual en la pestaña Historial.
Aviso
Asegúrate de guardar la instrucción antes de abandonar la ventana Generador de instrucciones. Perderás tu historial de instrucciones cuando selecciones Cerrar.
Manejo de errores
Cuando se produce un error, elige la opción de manejo de errores en el menú desplegable En caso de errores:
Error: detener el procesamiento de registros: produce un error en la ventana de Resultados y detiene el procesamiento de registros.
Advertencia: seguir procesando registros: genera una advertencia en la ventana de Resultados, pero continúa procesando registros.
Ignorar: seguir procesando registros: ignora las columnas que difieren y continúa procesando registros.
Configuración de los ajustes de modelo avanzado
Utiliza la sección Configuración de modelo avanzado para configurar los parámetros del modelo.
Temperatura: controla la aleatoriedad de la salida del modelo como un número entre 0 y 2. El valor predeterminado es 1.
Los valores más bajos proporcionan respuestas más confiables y coherentes.
Los valores más altos ofrecen respuestas más creativas y aleatorias, pero también pueden ser ilógicas.
Máximo de tokens de salida: la cantidad máxima de tokens que el LLM puede incluir en una respuesta. Cada token es aproximadamente 3/4 de una palabra. Los tokens son unidades básicas de entrada y salida en un LLM. Son trozos de texto que pueden ser palabras, conjuntos de caracteres o combinaciones de palabras y puntuación. Consulta con tu proveedor de LLM y el modelo específico para obtener el máximo de tokens de salida disponibles.
TopP: controla de qué tokens de salida toma las muestras el modelo y oscila entre 0 y 1. El modelo selecciona de los tokens más probables a los menos probables hasta que la suma de sus probabilidades sea igual al valor TopP. Por ejemplo, si el valor de TopP es 0,8 y tienes tres tokens con probabilidades de 0,5, 0,3 y 0,2, el modelo solo selecciona entre los tokens con probabilidad de 0,5 y 0,3 (suma de 0,8). Los valores más bajos dan como resultado respuestas más coherentes, mientras que los valores más altos dan como resultado respuestas más aleatorias.
Salida
La herramienta genera dos columnas de datos de cadena.
Columna Instrucción LLM: contiene tu instrucción.
Columna Respuesta LLM: contiene la respuesta de tu modelo y proveedor de LLM.