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
La herramienta se conecta automáticamente al espacio de trabajo de Alteryx One que usaste para iniciar sesión en la aplicación Alteryx One. Si deseas usar una conexión de LLM desde un espacio de trabajo diferente, puedes realizar este cambio a través de la aplicación Alteryx One o Designer Desktop.
Seleccionar un espacio de trabajo en la aplicación Alteryx One
Ve a la aplicación Alteryx One.
Selecciona el Menú de perfil para ver una lista de los espacios de trabajo disponibles.
Selecciona el espacio de trabajo de la lista que incluye la conexión de LLM que deseas usar.
Vuelve a Designer Desktop.
Seleccionar un enlace de Alteryx en Designer Desktop
Nota
El cambio del enlace activo a través de DCM solo permanece activo durante la sesión actual de Designer Desktop. El enlace activo vuelve al espacio de trabajo seleccionado en la aplicación Alteryx One cuando vuelves a abrir Designer Desktop.
Si ya creaste un enlace de Alteryx…
Ve a Archivo > Administrar conexiones para abrir el Administrador de conexiones de datos (DCM).
Ve a la página de Enlaces de Alteryx.
Establece tu enlace como el enlace activo. Selecciona Establecer como activo en el menú de tres puntos. Si se te solicita, selecciona Sí, cambiar para volver a vincular otras herramientas a este nuevo enlace activo.
Sal de DCM para volver a tu flujo de trabajo.
Crear un enlace de Alteryx en Designer Desktop
Si necesitas crear un enlace de Alteryx…
Ve a Archivo > Administrar conexiones para abrir el Administrador de conexiones de datos (DCM).
Ve a la página Enlaces de Alteryx y, a continuación, selecciona Conectar a la nube.
Selecciona tu instancia de nube (por ejemplo, selecciona Estados Unidos si tu URL comienza con
us1).Inicia sesión en Alteryx One y, luego, selecciona el espacio de trabajo que deseas utilizar.
Sigue las instrucciones en la pantalla para completar la configuración del enlace.
Establece tu nuevo enlace como tu enlace activo. Selecciona Establecer como activo en el menú de tres puntos. Si se te solicita, selecciona Sí, cambiar para volver a vincular otras herramientas a este nuevo enlace activo.
Sal de DCM para volver a tu flujo de trabajo.
Conexión de LLM
Importante
Antes de que puedas seleccionar un LLM, Administrador de espacio de trabajo 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 Ask Alteryx.
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.
Agregar a favoritos: guarda el mensaje seleccionado en una lista de tus indicaciones favoritas. Selecciona el menú de tres puntos junto a Agregar al lienzo para encontrar esta opción. Para ver tus indicaciones favoritas, selecciona la casilla de verificación Mostrar solo favoritos.
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.
Eliminar indicación: elimina la indicación seleccionada de la pestaña Historial. 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.
Salida estructurada
Usa la salida estructurada a fin de definir un esquema JSON para la respuesta LLM y aplicar un formato coherente y legible por máquina sin necesidad de describir la estructura en tu instrucción. Cuando está habilitada, la herramienta Instrucción envía tanto la instrucción como el esquema al modelo, el cual devuelve una respuesta que se ajusta a la estructura definida. La herramienta valida cada respuesta según el esquema para garantizar que los campos obligatorios estén presentes, que los tipos de datos coincidan y que solo se incluyan los campos permitidos.
Columna de esquema JSON: selecciona la columna que contiene tu esquema JSON. El esquema define la estructura de respuesta esperada, incluidos los nombres de campo, los tipos de datos, los campos obligatorios y las restricciones. Para crear fácilmente un esquema JSON, utiliza el
JSON Schema Tool. Si seleccionas la opción predeterminada Ninguno (sin salida estructurada), la salida estructurada se desactiva y el modelo devuelve texto sin formato.En caso de falla de validación de esquema: selecciona cómo la herramienta maneja las respuestas que no se ajustan al esquema:
Establecer la salida LLM en nulo: reemplaza la respuesta no válida por un valor nulo.
Escribir JSON no válido: muestra la respuesta aunque no se ajuste al esquema.
Detener la herramienta en el primer registro: detiene la ejecución de la herramienta cuando se produce la primera falla de validación.
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.