워크플로 간소화: 번거로운 API 도킹과 작별하고, 클릭 한 번으로 코드를 생성하고 매개변수를 쿼리하세요.

디지털 시대에 API(애플리케이션 프로그래밍 인터페이스)는 서로 다른 소프트웨어 시스템 간의 상호 작용의 초석이 되었습니다. 하지만 기존의 API 인터페이스 방식은 비효율적이고 개발자에게 불편을 주는 경우가 많습니다.

다음과 같은 딜레마에 직면한 적도 있으신가요?

• 문서 스카이북: 인터페이스 문서가 모호하고 매개변수 설명이 모호하고 혼란스럽습니다.
• 용어 미로: 용어가 무궁무진하고 초보자는 이를 이해하기 위해 많은 시간을 들여 정보를 참조해야 합니다.
• 파라메트릭 블랙홀: 복잡한 API 문서에는 많은 매개변수와 어지러울 정도로 많은 구성 조합이 있습니다.
• 노동력 중복: 새로운 API와 인터페이스할 때마다 문서를 읽고, 코드를 작성하고, 디버깅하고, 테스트하는 작업을 반복해야 하므로 시간과 노동력이 많이 소요됩니다.

이러한 문제는 개발 효율성을 떨어뜨릴 뿐만 아니라 기업의 R&D 비용도 증가시킵니다. 이러한 문제점을 해결하기 위해 Dify는 AI 기술을 사용하여 API 도킹 프로세스를 간소화하고 개발자가 지루한 문서화 작업에서 벗어나도록 하는 새로운 워크플로우를 출시했습니다.

Dify 워크플로: 지능형 API 도우미

Dify 워크플로는 API 문서를 자동으로 읽고 이해하여 개발자가 쉽게 사용할 수 있는 코드와 정보로 변환하는 지능형 비서와 같습니다. 워크플로의 핵심은 대규모 AI 모델을 활용하여 API 문서를 의미론적으로 구문 분석하고 처리하는 것입니다.

전체 프로세스는 다음과 같습니다:

1. 문서 추출: Dify 워크플로는 여러 소스의 API 문서를 지원합니다:
   • 로컬 문서: Word, 마크다운, PDF 및 기타 형식의 문서 업로드를 지원합니다.

     

   • 온라인 문서: 웹 페이지의 콘텐츠를 자동으로 캡처하기 위해 API 문서의 URL 입력을 지원합니다.
   • API 정의 파일입니다: Swagger/OpenAPI 형식의 API 정의 파일 직접 가져오기를 지원합니다.
2. 페이지 크롤링: 온라인 API 문서의 경우, Dify는 웹 콘텐츠를 마크다운 형식으로 변환하는 오픈 소스 파이어크롤 도구를 통합합니다.

   파이어크롤 공식 사이트: https://www.firecrawl.dev/

   

   사용자는 파이어크롤 웹사이트에서 계정을 등록하여 API 키를 받은 후 Dify에 적절한 플러그인을 설치할 수 있습니다.

   

   Dify는 파이어크롤 플러그인 설치를 지원하며, 무료 파이어크롤 크레딧이 제한되어 있으므로 여유가 있는 경우 현지화된 배포도 옵션으로 선택할 수 있습니다.

3. AI 모델 처리: 추출된 문서 콘텐츠 또는 크롤링된 마크다운 텍스트를 AI 매크로 모델에 제출하여 처리합니다.

   Dify 워크플로는 다양한 AI 모델을 지원합니다. 테스트 결과qwen2.5-coder-32b-instruct 모델은 다음과 같은 주요 이유로 좋은 선택입니다:

   1. 128k 컨텍스트 창으로 대부분의 API 문서를 처리하기에 충분합니다.
   2. 코드 모델로서 코드 생성과 관련된 작업을 더 능숙하게 처리합니다.
   3. 모든 주요 모델링 플랫폼에 쉽게 액세스할 수 있습니다.
   4. 고성능 GPU(예: 4090, 5090)를 사용하는 사용자의 경우 더 빠른 처리를 위해 로컬 배포를 옵션으로 선택할 수 있습니다.
   

   물론 예산이 부족하다면 다음을 선택할 수도 있습니다. qwen2.5-coder-7b-instruct 모델. 최상의 결과를 얻으려면deepseek-r1 모델링도 좋은 옵션입니다.

4. 호환성: Dify 워크플로는 Windows, macOS, Linux와 같은 주요 운영 체제를 지원하며 Python, Java, JavaScript, Go 및 기타 프로그래밍 언어와 호환됩니다.

위의 단계를 통해 Dify 워크플로는 다양한 소스 및 형식의 API 문서를 AI가 이해할 수 있는 통합 텍스트 데이터로 변환하여 후속 코드 생성, 매개변수 쿼리 및 기타 기능을 위한 기반을 마련할 수 있습니다.

코드 생성을 위한 API 문서: 마이크로 채널의 공개 번호 개발을 예로 들어 설명합니다.

다음으로, WeChat 공개 번호 개발을 예로 들어 Dify 워크플로우가 API 도킹 프로세스를 간소화하는 방법을 보여드리겠습니다.

WeChat 개발의 첫 번째 단계는 일반적으로 액세스 토큰을 얻는 것입니다.

WeChat의 공식 문서입니다: https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

전통적인 개발 프로세스는 일반적으로 다음과 같습니다:

1. 설명서를 읽고 인터페이스 URL과 요청 방법을 찾아보세요.
2. 인터페이스에 필요한 매개변수를 결정합니다.
3. 설명서에서 AppID 및 AppSecret과 같은 주요 매개 변수를 찾아보세요.
4. 테스트 코드를 작성합니다.
5. 코드를 실행하고 디버그합니다.
6. 오류가 발생하면 문서로 돌아가 오류 코드에 따라 원인을 찾아보세요.

Dify 워크플로우를 사용하면 위의 프로세스를 크게 간소화할 수 있습니다. Dify 워크플로우 인터페이스에 API 문서의 URL을 입력하고 프로그래밍 언어(예: Python)를 선택한 다음 실행을 클릭하기만 하면 됩니다.

Dify는 전체 문서를 자동으로 구문 분석하고, 매개변수와 오류 코드의 정확한 의미를 해석하며, 실행 가능한 코드 예제를 생성합니다.

또한, Dify는 생성된 코드 주석이나 인터페이스에 직접 팁을 제공하여 사용자에게 AppID 및 AppSecret과 같은 주요 매개변수를 가져오는 방법을 알려줍니다. 예를 들어, 위챗 퍼블릭 개발에서 Dify는 사용자에게 "위챗 퍼블릭 플랫폼의 '설정 및 개발 - 기본 구성'으로 이동하여 가져옵니다."라는 메시지를 표시합니다.

사용자는 획득한 앱ID와 앱시크릿으로 Dify 워크플로우의 '추가 메모'를 채우고 특별한 형식 지정 없이 실행을 클릭하여 사용 가능한 코드를 생성하기만 하면 됩니다.

생성된 코드를 PyCharm과 같은 IDE에 복사하고 실행하여 API를 직접 호출하면 많은 양의 코드를 수동으로 작성하고 지루한 디버깅을 수행할 필요가 없습니다.

테스트 코드 생성 외에도 Dify는 특정 개발 프레임워크 또는 라이브러리 사용도 지원합니다. 예를 들어 Java 개발에서는 weixin-java-mp 일반적으로 사용되는 WeChat 개발 라이브러리입니다. 사용자는 라이브러리의 전체 이름을 기억하지 못하더라도 Dify에서 요청하기만 하면 해당 코드를 생성할 수 있습니다.

또한 Dify는 코드 완성 기능도 지원합니다. 사용자가 기존 코드 스니펫을 Dify에 복사하면 Dify가 컨텍스트에 따라 코드를 자동으로 완성하여 개발 효율성을 높입니다.

API 문서 매개변수 쿼리

코드 생성 외에도 Dify 워크플로는 강력한 매개변수 쿼리 기능도 제공합니다. 사용자는 매개변수의 의미를 묻는 등 문서에서 직접 질문할 수 있으며, 특히 병음 이니셜을 매개변수 이름으로 사용하는 문서의 경우 이 기능이 매우 유용합니다.

Dify는 사용자가 API 사용법을 빠르게 이해할 수 있도록 문서 내용을 바탕으로 정확한 설명을 제공합니다.

가격 및 액세스

Dify는 무료 버전과 유료 버전을 모두 제공합니다. 무료 버전에는 기본 기능이 포함되어 있어 개인 개발자에게 적합합니다. 유료 버전은 고급 기능과 기술 지원을 제공하며 기업 사용자에게 적합합니다. 사용자는 Dify 웹사이트에서 무료 평가판을 신청할 수 있습니다.

Dify의 새로운 워크플로우를 경험하려면 Dify 홈페이지의 스튜디오에서 DSL 파일을 찾아서 가져올 수 있습니다.

요약 및 전망

Dify의 새로운 워크플로는 AI 기술을 사용하여 API 문서를 자동으로 구문 분석하고 코드를 생성하며 매개변수를 쿼리하여 API 도킹 프로세스를 크게 간소화하고 개발 효율성을 개선합니다. 초보자와 숙련된 개발자 모두 Dify 워크플로우의 이점을 누릴 수 있습니다.

앞으로 Dify는 API 문서 구문 분석의 정확성과 속도를 개선하기 위해 AI 모델을 지속적으로 최적화할 것입니다. 동시에 Dify는 API 자동 테스트, API 성능 모니터링 등과 같은 더 많은 애플리케이션 시나리오를 탐색하고 개발자에게 보다 포괄적이고 지능적인 API 도구 체인을 제공하기 위해 노력하고 있습니다. Dify는 여러분과 협력하여 보다 지능적이고 효율적인 개발 방법을 모색할 수 있기를 기대합니다.