View a markdown version of this page

Automatizaciones de edificios - Amazon Quick

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Automatizaciones de edificios

Amazon Quick Automate proporciona varios métodos para crear automatizaciones que se adapten a diferentes necesidades y niveles de habilidad. En esta sección se describen los métodos y herramientas de creación disponibles.

Requisitos previos

Antes de crear una automatización, debe crear un proyecto dentro de un grupo de automatización específico. El grupo de automatización controlará qué integraciones y credenciales están disponibles para usted al crear esa automatización. Asegúrese de que las integraciones y credenciales necesarias estén configuradas para cualquier sistema externo con el que vaya a interactuar en la automatización.

Una vez que haya creado un proyecto, haga clic en el botón Comenzar a crear para empezar.

nota

Debe tener permisos de propietario para administrar las integraciones y las credenciales de un grupo de automatización.

Métodos de creación

Elija entre tres enfoques para desarrollar su automatización. Si es la primera vez que utilizas Amazon Quick Automate, te recomendamos lo siguiente:

  • Comience por explorar ejemplos de automatizaciones

  • Intente crear una automatización sencilla con lenguaje natural

  • Experimenta con la edición manual una vez que te familiarices con los conceptos básicos

Usa ejemplos de automatizaciones

Comience rápidamente explorando ejemplos prediseñados que muestran los patrones de automatización más comunes. Estos ejemplos proporcionan ejemplos prácticos de diferentes capacidades de automatización y sirven como recursos de aprendizaje para ayudarle a familiarizarse con las capacidades de Amazon Quick Automate. Para usar un ejemplo de automatización:

  • Realice una búsqueda para explorar diferentes muestras por sector.

  • Haga clic en el ejemplo para ver una descripción general de la automatización.

    • Si se requiere alguna integración, aparecerá como requisito previo.

  • Haga clic en Comenzar con un ejemplo para abrir la automatización en el lienzo.

  • Ahora podrá ver la automatización, editarla y probarla.

Crear con lenguaje natural

El Asistente de Automatización proporciona un AI-powered enfoque para crear automatizaciones mediante:

  • Interfaz de chat: describa su proceso de forma conversacional en un lenguaje natural

  • Carga de documentos: importe cualquier documentación que describa los pasos y requisitos del proceso

Cuando introduzcas datos a través de cualquiera de los dos métodos, el Asistente de Automatización generará tu automatización mediante una experiencia guiada en dos pasos:

  • High-level planificar

    • En primer lugar, el Asistente analiza sus requisitos y genera un plan de automatización de alto nivel. El plan consta de pasos del proceso que agrupan de forma lógica las acciones relacionadas como parte de la automatización. Cada paso del proceso contiene inicialmente instrucciones en lenguaje natural.

    • Revise y edite las instrucciones de cada paso del proceso y, a continuación, haga clic en Generar para crear las acciones de bajo nivel de ese paso.

  • Low-level actions

    • A continuación, el Asistente creará las acciones de bajo nivel y la lógica del proceso en función de las instrucciones de los pasos.

    • Revisa y edita las acciones generadas. Haga clic en Ejecutar o Depurar para comenzar las pruebas.

Mejores prácticas para proporcionar entradas en lenguaje natural:

  • Especifica el proceso paso a paso como si estuvieras capacitando a un nuevo empleado

  • Incluye los detalles exactos necesarios para realizar cada paso:

    • Dirección de correo electrónico si va a enviar un mensaje

    • Nombre y ubicación del archivo de uploading/downloading un documento

    • URL si está navegando a un sitio web

Crear desde cero (automatización en blanco)

Cree automatizaciones manualmente mediante la interfaz de diseñador visual:

  • Navegue hasta el resumen de su proyecto

  • Haz clic en Empezar a crear

  • Selecciona Omitir para acceder al lienzo

La interfaz del diseñador incluye varios componentes clave:

  • Canvas: visualiza la automatización. Puede acercar y alejar la imagen, expandir y reducir los pasos del proceso y reordenar las acciones en el lienzo.

  • Panel de acciones: el panel de acciones tiene una lista completa de todas las acciones de automatización disponibles en tu grupo de automatización. Puede buscar y filtrar para encontrar acciones organizadas por categoría (agentes, flujo de procesos, navegador web, etc.). Drag-and-drop acciones en el lienzo para desarrollar su automatización. También puedes hacer clic en el signo más que aparece al pasar el ratón entre las acciones para añadir una nueva acción directamente en su lugar en el lienzo.

  • Panel de propiedades: una vez que añadas una acción o hagas clic en una acción existente en tu proceso, el panel de propiedades te permite configurar los parámetros de entrada y salida que controlan el comportamiento de esa acción.

  • Panel de ajustes: permite crear y editar configuraciones de tiempo de ejecución y explorar las credenciales disponibles para la automatización.

  • Panel de variables: muestra todas las variables utilizadas en la automatización. La creación de una variable es sencilla, ya que se añade una nueva referencia directamente en la automatización.

Configuraciones y variables en tiempo de ejecución

Las configuraciones de tiempo de ejecución le permiten crear ajustes fácilmente editables que se utilizan en la automatización. Algunos ejemplos de configuraciones de tiempo de ejecución son:

  • URL de sitios web

  • Nombres y ubicaciones de los archivos

  • Configuraciones de correo electrónico, como asuntos y listas de remitentes

Las variables se utilizan para almacenar y transferir información entre las acciones de la automatización cuando se ejecuta. Añada una nueva variable a su automatización simplemente proporcionando un nuevo nombre de referencia en una propiedad de salida. Los tipos de variables más comunes incluyen:

  • Cadena: texto sin formato (por ejemplo, nombre, descripción)

  • Número: valor numérico (p. ej., cantidad, puntuación)

  • Booleano: valor True/False

  • Matriz: colección o lista de elementos

  • Objeto: Key-value pares

  • Archivo: documentos y medios (p. ej., archivos PDF, imágenes)

  • Tabla de datos: Spreadsheet-like datos con filas y columnas

Edición de automatizaciones

Una vez que hayas creado tu automatización, puedes modificarla con el Asistente de Automatización o editándola directamente en el lienzo.

Uso de Automation Assistant

El Asistente de Automatización le ayuda a realizar cambios mediante un lenguaje natural. Puede:

  • Solicita actualizaciones de toda la automatización, pasos específicos o acciones específicas

    • Centra el chat en pasos específicos seleccionándolos primero

  • Haga preguntas y obtenga ayuda y sugerencias relacionadas con el producto en función de su automatización actual

  • Pide ayuda para escribir expresiones y códigos según tus necesidades

Para editar con el Asistente:

  • Haga clic en Crear con Assistant en la barra de herramientas

  • Describa los cambios que desee realizar

  • Revise y confirme las modificaciones sugeridas

    • El chat incluye un resumen de los cambios. Haz clic en Rechazar cambios para volver a la versión anterior.

  • Pruebe la automatización actualizada

Edición sobre lienzo

Realice los cambios directamente en el diseñador visual:

  • Seleccione el paso o la acción que desee modificar

  • Utilice el panel de propiedades para ajustar la configuración

  • Reorganiza los pasos arrastrando y soltando

nota

Cada acción tiene un menú de opciones con acciones comunes, como duplicar la acción o eliminarla.

Mejores prácticas de edición:

  • Realice cambios incrementales

  • Realice una prueba después de cada modificación significativa

nota

Los cambios se guardan automáticamente en la versión activa. Si desea implementar esos cambios, confirme e implemente la versión actualizada.

sugerencia

Si tienes problemas al compilar:

  • Usa el Asistente de Automatización para obtener ayuda

  • Consulte la documentación de la acción para conocer los requisitos específicos

Entradas y salidas de automatización

Defina esquemas de entrada y salida para crear automatizaciones parametrizadas y reutilizables en Amazon Quick Automate. Al definir los esquemas de entrada y salida mediante los nodos de inicio y fin, puede transformar las automatizaciones estáticas en flujos de trabajo reutilizables que aceptan datos diferentes cada vez que se ejecutan. En lugar de codificar valores de forma rígida, defina parámetros de entrada mecanografiados que se proporcionan en tiempo de ejecución y valores de salida estructurados que se capturan cuando se completa la automatización. Las entradas y salidas funcionan en todos los métodos de invocación: ejecuciones manuales, llamadas a la API y activadores programados.

Principales ventajas del uso de entradas y salidas:

  • Reutilización: ejecute la misma automatización con datos diferentes sin modificar la automatización en sí.

  • Seguridad de tipos: Amazon Quick Automate valida los datos de entrada con respecto al esquema antes de que comience la ejecución, lo que evita que se ejecuten datos no válidos.

  • Integración de API: los Auto-generated esquemas permiten el descubrimiento programático y la integración con sistemas externos.

  • Observabilidad: los resultados estructurados se capturan como artefactos de ejecución para su auditoría y revisión.

Tipos de datos compatibles

Se admiten los siguientes tipos de datos para los campos de entrada y salida:

  • Texto: valores de texto sin formato (p. ej., texto1, texto2)

  • Número: valores numéricos que incluyen decimales (p. ej., 3,14, 100)

  • Booleano: valores verdaderos o falsos

  • Archivo: archiva objetos con un tamaño máximo de 5 MB

Nodos inicial y final

Cada automatización incluye un nodo de inicio y un nodo final, que están en blanco de forma predeterminada. Puede editar estos nodos para crear un esquema, usar las entradas de la automatización y actualizar los datos de salida para volver de la automatización. El nodo de inicio recibe los datos de entrada en tiempo de ejecución, mientras que los nodos finales (incluidos los nodos de final de proceso) recopilan los datos de salida durante la ejecución y los devuelven como artefactos estructurados cuando se completa la automatización.

Inicio

El nodo de inicio es el punto de entrada que acepta los parámetros de entrada cuando se activa la automatización. Está en blanco de forma predeterminada.

Propiedades:

  • Formato de entrada: define el esquema de los parámetros de entrada que acepta la automatización. Edite con el editor de esquemas de entrada que se describe en Definir esquemas de entrada y salida.

  • Variable de entrada: variable que almacena los valores de entrada para la automatización tal como se definen en el formato de entrada y los proporciona el usuario.

Final

El nodo final es el punto de terminación que recopila y devuelve los valores de salida cuando la automatización se completa correctamente. Puede establecer los valores de salida de las variables de la automatización mediante las propiedades del nodo final. La automatización puede tener varios nodos finales (proceso final) en función de la estructura de la automatización.

Propiedades:

  • Formato de salida: define el esquema de los parámetros de salida que devuelve la automatización. Elija Editar y añada o modifique el esquema mediante el editor de esquemas de salida que se describe en Definir esquemas de entrada y salida.

  • Datos de salida: asigna los valores de las variables de la automatización a los campos de salida que haya definido. Para cada variable de salida que cree en el nodo final (esquema de salida), especifique qué variable de automatización contiene los datos que desea devolver. Utilice el editor de edición de datos de salida para configurar estas asignaciones en el campo Valor de salida.

Definir esquemas de entrada y salida

Los esquemas definen la estructura de los datos que la automatización acepta como entrada y produce como salida. El estudio de creación proporciona un generador de formularios visuales para definir los esquemas de entrada y salida directamente en el lienzo de automatización.

Para definir un esquema de entrada:

  • Abre tu automatización en Amazon Quick Automate.

  • Elija el nodo de inicio en el lienzo para abrir el editor de esquemas. También puede abrir el editor de esquemas desde el panel de propiedades. Para ello, elija el nodo Inicio y, a continuación, elija Editar en formato de entrada en el panel de propiedades.

  • Seleccione +Añadir campo para añadir un campo de entrada.

  • Para cada campo de entrada, configure las siguientes propiedades:

    • Nombre: un identificador único para el campo.

    • Tipo: el tipo de datos que acepta el campo. Para obtener más información, consulte Tipos de datos admitidos.

    • Obligatorio: si el campo debe proporcionarse al ejecutar la automatización.

    • Valor predeterminado (opcional): esta opción solo está activa si el campo obligatorio está borrado. Los valores predeterminados aparecen rellenados automáticamente en el formulario de entrada cuando se ejecuta una prueba o se activa la automatización.

    • Descripción: descripción de lo que representa el campo.

  • Seleccione Guardar para almacenar el esquema con la automatización.

Para definir un esquema de salida:

  • Elija un nodo final en el lienzo para abrir el editor de esquemas de salida. También puede abrir el editor de esquemas desde el panel de propiedades. Para ello, elija el nodo final y, a continuación, elija Editar en formato de salida en el panel de propiedades.

  • Seleccione +Añadir campo para añadir un campo de salida.

  • Para cada campo de salida, configure las siguientes propiedades:

    • Nombre: un identificador único para el campo.

    • Tipo: el tipo de datos de la salida.

    • Descripción: descripción de lo que representa la salida.

  • Seleccione Save.

nota

Puede definir las entradas desde el nodo inicial y las salidas desde cualquier nodo final. Si su automatización tiene varios nodos finales, añadir o modificar el esquema de un nodo final modificará todos los esquemas de los nodos finales.

Uso de valores de entrada del nodo de inicio

Cuando su automatización tiene un esquema de entrada definido en el nodo de inicio, puede acceder a esos valores de entrada en todo el flujo de trabajo mediante el inputs diccionario. El tiempo de ejecución valida y completa automáticamente este diccionario con los valores proporcionados cuando se ejecuta la automatización.

# Access required input fields value = inputs["field_name"] # Example usage customer_id = inputs["customer_id"] # Retrieves a required string input

Establecer los valores de salida en el nodo final

El nodo final define qué valores de la automatización se devuelven como salidas. Esto se configura mediante la propiedad Datos de salida, que proporciona dos modos de interacción para configurar los valores de salida en el editor. Para alternar entre los modos, seleccione el icono de código (</>) situado junto al campo de valor de salida.

Dos modos para configurar las salidas:

  • Modo de selección de variables (desplegable): la interfaz predeterminada muestra una lista desplegable de todas las variables disponibles en la automatización. Seleccione la variable que desee asignar a cada campo de salida.

  • Modo de expresión (código): elija el icono de código (</>) junto a cualquier campo de valor de salida para cambiar al modo de expresión. Este modo le permite introducir expresiones personalizadas, realizar cálculos, acceder a datos anidados o establecer valores literales.

Definir esquemas con el asistente Build with

Build with Assistant puede crear o modificar los esquemas de entrada y salida directamente. Describa sus requisitos de entrada y salida en lenguaje natural y el asistente generará la definición del esquema por usted. Todos los cambios que realice el asistente se sincronizarán automáticamente con el generador visual de formularios de Studio.

Consideraciones

Tenga en cuenta lo siguiente cuando utilice entradas y salidas de automatización:

  • Los esquemas de entrada y salida son opcionales. Las automatizaciones existentes sin esquemas siguen funcionando sin cambios.

  • Las entradas de los archivos tienen un tamaño máximo de 5 MB. En el caso de archivos más grandes, pase la ubicación del archivo (por ejemplo, una ruta de Amazon S3) como entrada de texto.

  • Los valores de entrada y salida se almacenan con cada ejecución ejecutada para fines de observabilidad y auditoría.

  • Al actualizar un esquema, debe volver a implementar la automatización para que los cambios se apliquen en las ejecuciones implementadas. Las ejecuciones de prueba siempre utilizan el último borrador del esquema.

Puede utilizar los valores de entrada y salida de las siguientes maneras:

  • Probar y ejecutar la automatización desde el lienzo. Para obtener más información, consulte Probar automatizaciones.

  • Activación manual de las automatizaciones implementadas. Para obtener más información, consulte Implementación de automatizaciones.

  • Activadores programados para las automatizaciones desplegadas. Para obtener más información, consulte Implementación de automatizaciones.

Administrar las versiones de automatización

Amazon Quick Automate ofrece funciones de control de versiones para ayudarle a realizar un seguimiento y mantener el historial de actualizaciones de sus automatizaciones y a restaurar fácilmente las versiones anteriores.

Conceptos clave

  • Versión en vivo: la copia funcional actual de su automatización que puede editar en el lienzo. Los cambios se guardan automáticamente en la versión activa a medida que los editas.

  • Versiones confirmadas: Read-only instantáneas de su automatización que se pueden implementar. Crea una nueva versión de tu automatización para realizar un seguimiento de las actualizaciones importantes y poder revertirla si es necesario.

  • Versiones implementadas: las versiones confirmadas se pueden implementar y activar para que se ejecuten según un cronograma.

nota

Cada versión mantiene sus propios valores de configuración de tiempo de ejecución. Los cambios en la configuración de tiempo de ejecución de la versión Live no afectan a las versiones previamente confirmadas o implementadas.

Confirmación de versiones

Para confirmar una versión:

  • Haga clic en Confirmar en la barra de herramientas del lienzo

  • Añada una nota descriptiva que explique los cambios

  • Elija cómo aumentar el número de versión:

    • Versión secundaria (p. ej., 1.05 → 1.06) para actualizaciones más pequeñas (predeterminada)

    • Versión principal (p. ej., 1.0 → 2.0) para cambios significativos

  • Haga clic en Confirmar

importante

No puedes confirmar una versión si la automatización tiene algún error de validación. Resuelve todos los errores antes de intentar confirmarlos.

Cuando confirmas una versión:

  • La versión confirmada se convierte en una instantánea de solo lectura

  • La configuración de tiempo de ejecución actual se guarda con la versión confirmada

  • Se crea una nueva versión en vivo basada en esa instantánea para continuar con la edición

importante

Solo se pueden implementar las versiones confirmadas. La versión en vivo debe confirmarse primero antes de poder implementarla.

Visualización de versiones

Vea las versiones en dos lugares:

  • Lista desplegable de versiones en Canvas: por defecto es la versión en vivo. Elige cualquier versión anterior del menú desplegable para verla en modo de solo lectura en el lienzo.

  • Pestaña de versiones: se encuentra en los detalles del proyecto. Muestra un historial completo de versiones, que incluye el número de versión, cuándo se confirmó la versión, el usuario que la confirmó y cualquier nota de la versión. Haga clic en el menú de acciones para ver los detalles de la versión o implementarla.

Restaurar versiones anteriores

Para restaurar una versión anterior y seguir editándola como versión en vivo:

  • Selecciona la versión en el menú desplegable de versiones situado sobre el lienzo

  • Selecciona Restaurar la versión en vivo

  • La versión seleccionada sustituye a la versión en vivo actual

  • Continúe editando la versión en vivo para realizar los ajustes necesarios

  • Comprométete, como si fuera una nueva versión, a realizar una instantánea o implementar las actualizaciones

nota

Al restaurar una versión, se crea una nueva copia de trabajo, pero no se elimina ningún historial de versiones.

Prácticas recomendadas

  • Agrega notas de versión claras para hacer un seguimiento del propósito de los cambios

  • Confirme las versiones después de realizar actualizaciones importantes

  • Pruebe los cambios antes de confirmarlos

  • Revise la configuración del tiempo de ejecución antes de realizar la