Fluxo de trabalho Dify: diga adeus ao incômodo acoplamento de API, gere código e parâmetros de consulta com um clique

Na era digital, as APIs (Interfaces de Programação de Aplicativos) se tornaram a base da interação entre diferentes sistemas de software. No entanto, os métodos tradicionais de interface de API geralmente são ineficientes e frustrantes para os desenvolvedores.

Você também já se deparou com o seguinte dilema:

• Documentação do Skybook: A documentação da interface é obscura e as descrições dos parâmetros são vagas e confusas.
• Labirinto terminológico: Há uma infinidade de terminologia, e os novatos precisam gastar muito tempo consultando informações para entendê-las.
• Buracos negros paramétricos: A complexa documentação da API tem muitos parâmetros e uma variedade estonteante de combinações de configuração.
• Duplicação de trabalho: Toda vez que você faz interface com uma nova API, precisa ler repetidamente a documentação, escrever código, depurar e testar, o que consome muito tempo e trabalho.

Esses problemas não apenas reduzem a eficiência do desenvolvimento, mas também aumentam os custos de P&D das empresas. Para resolver esses pontos problemáticos, a Dify lançou um novo fluxo de trabalho que visa usar a tecnologia de IA para simplificar o processo de acoplamento de API e liberar os desenvolvedores do trabalho tedioso de documentação.

Dify Workflow: o assistente inteligente de API

Dify Os fluxos de trabalho são como assistentes inteligentes que leem e entendem automaticamente a documentação da API e a transformam em código e informações que os desenvolvedores podem usar facilmente. Em sua essência, ele aproveita grandes modelos de IA para analisar semanticamente e processar documentos de API.

O processo completo é o seguinte:

1. Extração de documentos: Os fluxos de trabalho da Dify suportam várias fontes de documentação de API:
   • Documentação local: Suporta o upload de documentos em Word, Markdown, PDF e outros formatos.

     

   • Documentação on-line: Suporta a entrada do URL de um documento de API para capturar automaticamente o conteúdo de uma página da Web.
   • Arquivo de definição de API: Oferece suporte à importação direta de arquivos de definição de API no formato Swagger/OpenAPI.
2. Rastreamento de páginas: Para a documentação on-line da API, a Dify integra a ferramenta Firecrawl de código aberto que converte o conteúdo da Web em formato Markdown.

   Site oficial do Firecrawl: https://www.firecrawl.dev/

   

   Os usuários podem registrar uma conta no site do Firecrawl para obter uma chave de API e instalar o plug-in apropriado no Dify.

   

   A Dify oferece suporte à instalação do plug-in do Firecrawl, enquanto a implantação localizada também é uma opção para aqueles que podem pagar por ela, dada a quantidade limitada de créditos gratuitos do Firecrawl.

3. Processamento de modelos de IA: Envie o conteúdo do documento extraído ou o texto Markdown rastreado para o macromodelo de IA para processamento.

   

   Os fluxos de trabalho da Dify suportam uma ampla seleção de modelos de IA. Os testes descobriram queqwen2.5-coder-32b-instruct Os modelos são uma boa opção pelos seguintes motivos principais:

   1. Janela de contexto de 128k, suficiente para lidar com a maior parte da documentação da API.
   2. Como um modelo de código, ele é mais hábil em lidar com tarefas relacionadas à geração de código.
   3. Todas as principais plataformas de modelagem estão disponíveis para fácil acesso.
   4. Para usuários com GPUs de alto desempenho (por exemplo, 4090, 5090), a implantação local é uma opção para um processamento mais rápido.

   

   É claro que, se estiver com orçamento limitado, você também pode escolher qwen2.5-coder-7b-instruct Modelos. Se estiver buscando os melhores resultados, odeepseek-r1 A modelagem também é uma boa opção.

4. Compatibilidade: Os fluxos de trabalho da Dify suportam os principais sistemas operacionais, como Windows, macOS e Linux, e são compatíveis com Python, Java, JavaScript, Go e outras linguagens de programação.

Por meio das etapas acima, o fluxo de trabalho da Dify pode transformar documentos de API de diferentes fontes e formatos em dados de texto unificados que podem ser compreendidos pela IA, estabelecendo a base para a geração de código subsequente, consulta de parâmetros e outras funções.

Documentação da API para gerar código: o desenvolvimento do número público de microcanais como exemplo

Em seguida, tome como exemplo o desenvolvimento do número público do WeChat para mostrar como o fluxo de trabalho da Dify pode simplificar o processo de encaixe da API.

A primeira etapa do desenvolvimento do WeChat geralmente é a obtenção de um token de acesso.

A documentação oficial do WeChat: https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

O processo de desenvolvimento tradicional geralmente é assim:

1. Leia a documentação para encontrar o URL da interface e o método de solicitação.
2. Determine os parâmetros necessários para a interface.
3. Procure parâmetros importantes, como AppID e AppSecret, na documentação.
4. Escreva o código de teste.
5. Execute o código e depure-o.
6. Se for encontrado um erro, retorne à documentação para encontrar a causa com base no código de erro.

Com os fluxos de trabalho da Dify, o processo acima pode ser bastante simplificado. Basta inserir o URL do documento da API na interface do fluxo de trabalho da Dify, selecionar uma linguagem de programação (por exemplo, Python) e clicar em Executar.

A Dify analisa automaticamente todo o documento, interpreta o significado exato dos parâmetros e códigos de erro e gera exemplos de códigos executáveis.

Além disso, a Dify fornecerá dicas diretamente nos comentários do código gerado ou na interface, informando aos usuários como obter parâmetros importantes, como AppID e AppSecret. Por exemplo, no desenvolvimento público do WeChat, a Dify solicitará que o usuário vá para "Configurações e desenvolvimento - Configuração básica" da plataforma pública do WeChat para obtê-lo.

Os usuários simplesmente preenchem as "Notas Extras" do fluxo de trabalho da Dify com o AppID e o AppSecret que obtiveram e, sem nenhuma formatação especial, clicam em Executar para gerar um código utilizável.

Copie o código gerado em um IDE, como o PyCharm, e execute-o para chamar as APIs diretamente, eliminando a necessidade de escrever manualmente grandes quantidades de código e realizar a tediosa depuração.

Além de gerar código de teste, a Dify também suporta o uso de estruturas ou bibliotecas de desenvolvimento específicas. Por exemplo, no desenvolvimento Java, você pode usar a biblioteca weixin-java-mp Essa biblioteca de desenvolvimento do WeChat é comumente usada. Os usuários só precisam fazer uma solicitação na Dify, mesmo que não se lembrem do nome completo da biblioteca, a Dify pode gerar o código correspondente.

Além disso, a Dify também oferece suporte à conclusão de código. Os usuários podem copiar trechos de código existentes para o Dify e o Dify completará automaticamente o código de acordo com o contexto para melhorar a eficiência do desenvolvimento.

Consulta de parâmetros da documentação da API

Além da geração de código, o fluxo de trabalho da Dify também oferece uma poderosa função de consulta de parâmetros. Os usuários podem fazer perguntas diretamente no documento, como perguntar o significado de um parâmetro, especialmente para os documentos que usam iniciais pinyin como nomes de parâmetros, esse recurso é muito útil.

A Dify fornecerá explicações precisas com base no conteúdo da documentação para ajudar os usuários a entender rapidamente como usar a API.

Preços e acesso

A Dify oferece versões gratuitas e pagas. A versão gratuita inclui funcionalidades básicas e é suficiente para desenvolvedores individuais. A versão paga oferece recursos mais avançados e suporte técnico, e é adequada para usuários corporativos. Os usuários podem se inscrever para uma avaliação gratuita no site da Dify.

Para experimentar os novos fluxos de trabalho da Dify, você pode localizar e importar arquivos DSL no Studio na página inicial da Dify.

Resumo e perspectivas

O novo fluxo de trabalho da Dify usa a tecnologia de IA para analisar automaticamente documentos de API, gerar código e parâmetros de consulta, simplificando muito o processo de acoplamento de API e melhorando a eficiência do desenvolvimento. Tanto os desenvolvedores iniciantes quanto os experientes podem se beneficiar do fluxo de trabalho da Dify.

No futuro, a Dify continuará a otimizar os modelos de IA para melhorar a precisão e a velocidade da análise de documentos de API. Ao mesmo tempo, a Dify também explorará mais cenários de aplicativos, como teste automático de API, monitoramento de desempenho de API etc., e está comprometida em fornecer aos desenvolvedores uma cadeia de ferramentas de API mais abrangente e inteligente. A Dify espera trabalhar com você para explorar uma maneira mais inteligente e eficiente de desenvolvimento.