Flujo de trabajo de Dify: diga adiós al engorroso acoplamiento de API, genere código y parámetros de consulta con un solo clic.

En la era digital, las API (interfaces de programación de aplicaciones) se han convertido en la piedra angular de la interacción entre distintos sistemas de software. Sin embargo, los métodos tradicionales de interfaz API suelen ser ineficaces y frustrantes para los desarrolladores.

¿Se ha enfrentado usted también al siguiente dilema?

• Documentación Skybook: La documentación de la interfaz es oscura y las descripciones de los parámetros son vagas y confusas.
• Laberinto terminológico: Hay un sinfín de terminología, y los novatos tienen que dedicar mucho tiempo a consultar información para entenderla.
• Agujeros negros paramétricos: La compleja documentación de la API tiene muchos parámetros y una vertiginosa variedad de combinaciones de configuración.
• Duplicación del trabajo: Cada vez que se interactúa con una nueva API, hay que leer repetidamente la documentación, escribir código, depurar y probar, lo que requiere mucho tiempo y trabajo.

Estos problemas no sólo reducen la eficiencia del desarrollo, sino que también aumentan los costes de I+D de las empresas. Para hacer frente a estos puntos débiles, Dify ha lanzado un nuevo flujo de trabajo que pretende utilizar la tecnología de IA para simplificar el proceso de acoplamiento de API y liberar a los desarrolladores del tedioso trabajo de documentación.

Dify Workflow: El Asistente Inteligente API

Dify Los flujos de trabajo son como asistentes inteligentes que leen y comprenden automáticamente la documentación de la API y la convierten en código e información que los desarrolladores pueden utilizar fácilmente. En esencia, aprovecha grandes modelos de IA para analizar semánticamente y procesar documentos de API.

El proceso completo es el siguiente:

1. Extracción de documentos: Los flujos de trabajo de Dify soportan múltiples fuentes de documentación API:
   • Documentación local: Admite la carga de documentos en Word, Markdown, PDF y otros formatos.

     

   • Documentación en línea: Permite introducir la URL de un documento API para capturar automáticamente el contenido de una página web.
   • Archivo de definición de la API: Admite la importación directa de archivos de definición de API en formato Swagger/OpenAPI.
2. Rastreo de páginas: Para la documentación en línea de la API, Dify integra la herramienta de código abierto Firecrawl, que convierte el contenido web en formato Markdown.

   Sitio oficial de Firecrawl: https://www.firecrawl.dev/

   

   Los usuarios pueden registrar una cuenta en el sitio web de Firecrawl para obtener una clave API e instalar el plugin apropiado en Dify.

   

   Dify soporta la instalación del plugin Firecrawl y, dada la cantidad limitada de créditos Firecrawl gratuitos, también hay disponibles despliegues localizados para aquellos que puedan permitírselo.

3. Procesamiento de modelos de IA: Envíe el contenido del documento extraído o el texto Markdown rastreado al macromodelo de IA para su procesamiento.

   Los flujos de trabajo de Dify admiten una amplia selección de modelos de IA. Las pruebas han demostrado queqwen2.5-coder-32b-instruct Los modelos son una buena opción por las siguientes razones principales:

   1. Ventana contextual de 128k, suficiente para manejar la mayor parte de la documentación de la API.
   2. Como modelo de código, es más adepto a las tareas relacionadas con la generación de código.
   3. Todas las principales plataformas de modelado están disponibles para facilitar el acceso.
   4. Para los usuarios con GPU de alto rendimiento (por ejemplo, 4090, 5090), la implantación local es una opción para un procesamiento más rápido.
   

   Por supuesto, si tiene un presupuesto limitado, también puede elegir qwen2.5-coder-7b-instruct Modelos. Si se buscan los mejores resultados, eldeepseek-r1 El modelado también es una buena opción.

4. Compatibilidad: Los flujos de trabajo de Dify admiten los principales sistemas operativos, como Windows, macOS y Linux, y son compatibles con Python, Java, JavaScript, Go y otros lenguajes de programación.

A través de los pasos anteriores, el flujo de trabajo de Dify puede transformar documentos API de diferentes fuentes y formatos en datos de texto unificados que pueden ser entendidos por la IA, sentando las bases para la posterior generación de código, consulta de parámetros y otras funciones.

Documentación de la API para generar código: el desarrollo del número público de microcanales como ejemplo

A continuación, tomemos como ejemplo el desarrollo del número público de WeChat para mostrar cómo el flujo de trabajo de Dify puede simplificar el proceso de acoplamiento de la API.

El primer paso en el desarrollo de WeChat suele ser conseguir un token de acceso.

La documentación oficial de WeChat: https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

El proceso de desarrollo tradicional suele ser el siguiente:

1. Lea la documentación para encontrar la URL de la interfaz y el método de solicitud.
2. Determine los parámetros necesarios para la interfaz.
3. Busque parámetros clave como AppID y AppSecret en la documentación.
4. Escribir código de prueba.
5. Ejecuta el código y depúralo.
6. Si se encuentra un error, vuelva a la documentación para encontrar la causa basándose en el código de error.

Con los flujos de trabajo de Dify, el proceso anterior puede simplificarse enormemente. Basta con introducir la URL del documento API en la interfaz de flujo de trabajo de Dify, seleccionar un lenguaje de programación (por ejemplo, Python) y hacer clic en Ejecutar.

Dify analiza automáticamente todo el documento, interpreta el significado exacto de los parámetros y códigos de error y genera ejemplos de código ejecutables.

Es más, Dify dará consejos directamente en los comentarios de código generados o en la interfaz, indicando a los usuarios cómo obtener parámetros clave como AppID y AppSecret. Por ejemplo, en WeChat desarrollo público, Dify le pedirá al usuario que vaya a "WeChat plataforma pública 'Configuración y Desarrollo - Configuración Básica'" para conseguirlo.

Los usuarios simplemente rellenan las "Notas Extra" del flujo de trabajo de Dify con el AppID y el AppSecret que han obtenido, y sin ningún formato especial, hacen clic en Ejecutar para generar el código utilizable.

Copia el código generado en un IDE como PyCharm y ejecútalo para llamar directamente a las APIs, eliminando la necesidad de escribir manualmente grandes cantidades de código y realizar tediosas depuraciones.

Además de generar código de prueba, Dify también soporta el uso de marcos de desarrollo o librerías específicas. Por ejemplo, en el desarrollo de Java, puede utilizar la librería weixin-java-mp Esta biblioteca de desarrollo WeChat de uso común. Los usuarios sólo tienen que hacer una solicitud en Dify, incluso si no recuerdan el nombre completo de la biblioteca, Dify puede generar el código correspondiente.

Además, Dify también soporta la finalización de código. Los usuarios pueden copiar fragmentos de código existentes en Dify, Dify completará automáticamente el código de acuerdo con el contexto para mejorar la eficiencia del desarrollo.

Consulta de parámetros de la documentación de la API

Además de la generación de código, el flujo de trabajo de Dify también proporciona una potente función de consulta de parámetros. Los usuarios pueden hacer preguntas directamente en el documento, como preguntar el significado de un parámetro, especialmente para aquellos documentos que utilizan iniciales pinyin como nombres de parámetros, esta función es muy útil.

Dify dará explicaciones precisas basadas en el contenido de la documentación para ayudar a los usuarios a entender rápidamente cómo utilizar la API.

Precios y acceso

Dify ofrece versiones gratuitas y de pago. La versión gratuita incluye funciones básicas y es suficiente para desarrolladores individuales. La versión de pago ofrece funciones más avanzadas y soporte técnico, y es adecuada para usuarios empresariales. Los usuarios pueden inscribirse para una prueba gratuita en el sitio web de Dify.

Para experimentar los nuevos flujos de trabajo de Dify, puede encontrar e importar archivos DSL en el Estudio de la página principal de Dify.

Resumen y perspectivas

El nuevo flujo de trabajo de Dify utiliza tecnología de IA para analizar automáticamente los documentos de la API, generar código y parámetros de consulta, lo que simplifica enormemente el proceso de acoplamiento de la API y mejora la eficiencia del desarrollo. Tanto los principiantes como los desarrolladores experimentados pueden beneficiarse del flujo de trabajo de Dify.

En el futuro, Dify seguirá optimizando los modelos de IA para mejorar la precisión y la velocidad del análisis sintáctico de documentos de API. Al mismo tiempo, Dify también explorará más escenarios de aplicación, como las pruebas automáticas de la API, la supervisión del rendimiento de la API, etc., se compromete a proporcionar a los desarrolladores una cadena de herramientas de API más completa e inteligente. Dify está deseando trabajar con usted para explorar una forma más inteligente y eficiente de desarrollo.