¿Buscas nuestro logo?
Aquí te dejamos una copia, pero si necesitas más opciones o quieres conocer más, visita nuestra área de marca.
¿Buscas nuestro logo?
Aquí te dejamos una copia, pero si necesitas más opciones o quieres conocer más, visita nuestra área de marca.
techbiz
Noelia Martín 27/05/2024 Cargando comentarios…
En un post anterior comentamos las tendencias en el ámbito API de este 2024, y uno de los puntos candentes es la especificación de API Workflows.
En el blog ya hemos hablado largo y tendido de APIs pero, a medida que avanza el año, hemos comprobado cómo el reciente auge de la IA Generativa ha potenciado el interés en el mundo de la APIficación, derivado de su relevante papel en este contexto.
Es indudable que la unión entre ambos mundos, IA Generativa y APIs, conforman un núcleo de innovación tecnológica con muchísimo potencial.
Independientemente de la empresa o el sector, incluso del tipo de arquitectura, se necesitan mecanismos solventes para los consumidores de las APIs, ya sean sistemas, humanos o IA, y huelga decir que esa solvencia en muchas ocasiones brilla por su ausencia.
Es en este sentido, el de facilitar el consumo de las APIs, donde surge la figura de la especificación de API Workflows, cuyo objetivo fundamental es describir y documentar procesos de negocio de una forma estandarizada. Es decir, se convierten en un componente clave por dos motivos:
API Workflows Specification es un framework pionero que busca definir y documentar flujos de llamadas APIs, es decir, estandariza la secuencia de llamadas a varias APIs, incorporando condiciones de éxito para cada paso e instrucciones para transferir la respuesta al siguiente eslabón de la cadena.
Esta trabajo forma parte de la iniciativa OpenAPI y permite a los consumidores hacer que los endpoints no sólo sean más fáciles de entender, sino también de consumir e integrar, lo que facilita su adopción y uso tanto para los consumidores tradicionales como para la nueva ola de consumidores de IA Generativa.
La iniciativa OpenAPI ha trabajado en esta primera versión de API Workflows en la definición y resolución de una serie problemas habituales que marcan los objetivos iniciales de la línea de trabajo, que son:
“Solo el 32% de los encuestados dijo que consideraba sus APIs bien documentadas.”
La especificación de API Workflows se encuentra en la versión 1.0.0 pre-release. Es decir, todavía se está trabajando por parte de la iniciativa en liberar su primera versión oficial.
En esta especificación se define la estructura del documento o documentos que describen los flujos de llamadas en formato tanto JSON como Yaml, y en la siguiente imagen puede verse el detalle de sus componentes de forma muy resumida:
Un ejemplo paso a paso de la especificación para entender mejor la estructura sería: presentación de Frank Kilcommins de la que hemos extraído la imagen anterior o ejemplos de la iniciativa OpenAPI, donde están estandarizando flujos típicos que se encuentran en escenarios reales para usarlos como base.
Su funcionamiento es muy sencillo: dentro de cada workflow se definen los parámetros o entradas posibles para dicho flujo y la lista de acciones o pasos que se conforman en base a ciertas condiciones, tal y como se muestra en la siguiente imagen:
En el ámbito del testing, la utilización de API Workflows permite resolver uno de los retos más comunes que nos encontramos: la validación de flujos de información. Con las herramientas actuales, dicha validación conlleva mucho esfuerzo por parte de los equipos, sea cual sea su toolkit de pruebas.
El enfoque actual está basado en pruebas individuales de endpoint a nivel de aceptación y /o integración en lugar de enfocarlo en procesos de negocio, ya que elaborar esos escenarios completos requiere mucho esfuerzo y es un tipo de prueba que no se realiza. En el mejor de los casos, se ejecuta para flujos de negocio críticos, pero no es lo habitual.
La utilización de API Workflows nos permite definir escenarios de prueba legibles por sistemas que contemplan toda la información necesaria: operaciones, orden, expectativas… sin tener que dedicar tiempo y esfuerzo en implementar ese proceso.
Esto permite crear planes de pruebas basados en escenarios del mundo real, no en pruebas aisladas, siendo estos escenarios más eficaces y garantes del comportamiento que se espera desde el punto de vista del usuario final.
A lo largo del artículo hemos hablado de la IA generativa, y no es una casualidad. La sinergia que existe entre la especificación de API Workflows y la IA Generativa es indudable, ya que los workflows sirven como enlace entre las funcionalidades que se ofrecen a través de las APIs y las capacidades de procesamiento de las IA que los consumen.
Es decir, los workflows no solo facilitan el consumo a los desarrolladores o sistemas tradicionales, si no que proporcionan una interfaz estandarizada para que las IA Generativas interactúen de una forma más eficaz, presentando las siguientes ventajas:
Desde el punto de vista de la IA como consumidora de los servicios, resulta clave disponer de un flujo compresible y definido de las interacciones y llamadas para las APIs, permitiendo ejecutar las operaciones complejas dentro de un marco coherente y uniforme de los servicios, para lo cual la estandarización es imprescindible.
El hecho de simplificar la interacción permite que los desarrolladores puedan crear aplicaciones aprovechando las capacidades que ofrece la IA generativa, no solo acelerando el tiempo de desarrollo, sino incluyendo nuevas funcionalidades basadas en la innovación.
Los API Workflows permiten garantizar que las operaciones realizadas desde las IA Generativas a través de las APIs expuestas sean seguras y cumplan la normativa definida, siguiendo protocolos de seguridad y requisitos de cumplimiento validados, minimizando así riesgos y potenciales fugas de información.
A modo resumen, podemos decir que el trabajo realizado hasta ahora por la iniciativa OpenAPI con la especificación de API Workflows, y que todavía continúa, permite:
Creemos que es una iniciativa de la que estar pendiente ya que dará mucho que hablar y, por supuesto, una vez se libere una versión estable de la misma, incorporar a nuestro stack.
Los comentarios serán moderados. Serán visibles si aportan un argumento constructivo. Si no estás de acuerdo con algún punto, por favor, muestra tus opiniones de manera educada.
Estamos comprometidos.
Tecnología, personas e impacto positivo.
Cuéntanos qué te parece.