Dify에서 APIMart 사용하기

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

준비사항

1. Dify 계정 등록 완료 Dify 공식 웹사이트를 방문하여 계정을 등록하고 클라우드 또는 자체 호스팅 버전을 선택
2. APIMart API 키 획득 완료 APIMart 콘솔에 로그인하여 API 키(sk-로 시작)를 획득

​

1단계: Dify에 로그인하고 설정 접근

​

1.1 Dify 플랫폼 접근

• 클라우드 버전: https://cloud.dify.ai를 방문하여 로그인
• 자체 호스팅 버전: Dify 배포 주소로 접근

​

1.2 모델 설정 페이지로 이동

1. 오른쪽 상단의 아바타 아이콘 클릭
2. 설정 선택
3. 왼쪽 메뉴에서 모델 공급자 선택

​

2단계: APIMart 모델 공급자 추가

​

2.1 설정 방법 선택

​

방법 1: OpenAI 사용자 지정 API 사용(권장)

1. 모델 공급자 페이지에서 OpenAI 공급자 찾기
2. 설정 버튼 클릭
3. 설정 페이지에서:
   • API Key: APIMart API 키 입력(sk-xxxxxxxxxxxx)
   • API Base URL 또는 Base URL: https://api.apimart.ai/v1 입력
4. 저장 클릭

5. 설정 완료 후 OpenAI 공급자 페이지로 돌아가 모델 목록 확인
6. 모델 목록에서 필요한 모델 찾기(예: gpt-4o, gpt-4o-mini, chatgpt-4o-latest 등)
7. 모델 오른쪽의 스위치를 클릭하여 활성화(파란색은 활성화를 나타냄)

​

방법 2: 사용자 지정 모델 공급자 추가

1. 사용자 지정 모델 섹션으로 스크롤
2. + 모델 추가 버튼 클릭

​

2.2 APIMart 공급자 설정

​

2.3 더 많은 모델 추가(선택 사항)

1. 사용자 지정 모델 섹션에서 + 모델 추가 버튼을 다시 클릭
2. 다른 모델의 설정 정보 입력
3. 저장 클릭

​

GPT-4/5 시리즈

​

Claude 시리즈

​

Gemini 시리즈

​

3단계: 애플리케이션에서 APIMart 모델 사용

​

3.1 새 애플리케이션 만들기

1. Dify 홈페이지로 돌아가기
2. 앱 만들기 버튼 클릭
3. 애플리케이션 유형 선택:
   • 챗봇 - 대화형 애플리케이션
   • 텍스트 생성기 - 텍스트 생성 애플리케이션
   • 에이전트 - 지능형 에이전트
   • 워크플로우 - 복잡한 워크플로우 애플리케이션

​

3.2 APIMart 모델 선택

1. 모델 설정 영역 찾기
2. 모델 선택 드롭다운 클릭
3. APIMart 공급자 선택
4. 설정한 모델 선택(예: gpt-4o)

​

3.3 모델 매개변수 설정

​

4단계: 애플리케이션 구축 및 테스트

​

4.1 프롬프트 추가

1. 시스템 프롬프트 영역에 프롬프트 작성
2. 변수를 사용하여 앱을 동적으로 만들기:
   • {{variable_name}} - 사용자 입력 변수
   • {{context}} - 지식 베이스 컨텍스트

당신은 제품에 관한 질문에 답변하는 데 능숙한 전문 고객 서비스 도우미입니다.

제품 정보: {{product_info}}

사용자 질문에 따라 정확하고 친근한 답변을 제공하세요. 확실하지 않은 경우 정직하게 사용자에게 알려주세요.

사용자 질문: {{user_question}}

​

4.2 지식 베이스 추가(선택 사항)

1. 왼쪽 메뉴에서 지식 베이스 클릭
2. 새 지식 베이스를 만들고 문서 업로드
3. 애플리케이션 오케스트레이션 페이지에서 지식 베이스 연결
4. 검색 매개변수 설정

​

4.3 애플리케이션 테스트

1. 오른쪽 미리보기 패널에 테스트 질문 입력
2. AI 응답 효과 검토
3. 필요에 따라 프롬프트와 매개변수 조정
4. 만족할 때까지 테스트 반복

​

4.4 애플리케이션 게시

1. 오른쪽 상단의 게시 버튼 클릭
2. 게시 방법 선택:
   • API 호출 - API를 통한 통합
   • 웹사이트에 임베드 - 임베드 코드 생성
   • 공개 링크 - 공유 링크 생성

​

5단계: 모니터링 및 최적화

​

5.1 애플리케이션 로그 보기

1. 로그 탭 클릭
2. 모든 대화 기록 보기
3. 사용자 질문 및 AI 응답 분석
4. 개선 기회 발견

​

5.2 API 사용 모니터링

• 📊 API 호출 통계 - 총 호출 수, 성공률
• 💰 비용 세부정보 - 일일/월간 비용
• 📈 사용 추세 - 사용량 변화 추세
• 🔍 요청 로그 - 상세한 요청 기록

​

5.3 애플리케이션 성능 최적화

1. 모델 선택 조정
   • 간단한 작업에는 gpt-4o-mini를 사용하여 비용 절감
   • 복잡한 작업에는 gpt-4o 또는 claude-sonnet-4-5를 사용하여 품질 향상
2. 프롬프트 최적화
   • 프롬프트를 더 명확하고 구체적으로 만들기
   • 예제를 추가하여 효과 향상
   • 사고의 연쇄를 사용하여 추론 능력 향상
3. 캐싱 설정
   • 유사한 질문에 대해 캐싱 활성화
   • API 호출 비용 절감

​

고급 기능

​

워크플로우 오케스트레이션 사용

1. 조건 분기 - 조건에 따라 다른 로직 실행
2. 다중 모델 협업 - 여러 모델의 장점을 결합
3. 외부 도구 호출 - API, 데이터베이스 등 외부 리소스 호출
4. 변수 전달 - 서로 다른 노드 간 데이터 전달

​

Agent 기능 설정

1. 도구 호출 - AI가 외부 도구를 호출하도록 설정
2. 메모리 관리 - 장기 대화 기억 유지
3. 자율 의사결정 - AI가 실행 단계를 자율적으로 계획

​

멀티모달 애플리케이션

1. 이미지 이해 - gpt-4o 또는 claude-3를 사용하여 이미지 처리
2. 이미지 생성 - APIMart의 이미지 생성 API 통합
3. 음성 처리 - TTS 및 STT 서비스 통합

​

자주 묻는 질문

​

Q1: APIMart 서비스에 연결할 수 없습니까?

1. Base URL 확인:
   • https://api.apimart.ai/v1(/v1 포함)인지 확인
   • 추가 경로를 추가하거나 /v1을 생략하지 마세요
2. API 키 확인:
   • API 키가 sk-로 시작하는지 확인
   • APIMart 콘솔에서 키가 유효한지 확인
3. 네트워크 연결 확인:
   • 서버가 https://api.apimart.ai에 액세스할 수 있는지 확인
   • 자체 호스팅 버전의 경우 서버 네트워크 연결 확인

​

Q2: 모델 응답이 느립니까?

1. 더 빠른 모델로 전환:
   • gpt-4o 대신 gpt-4o-mini 사용
   • 더 빠른 응답을 위해 gemini-2.0-flash-exp 사용
2. 프롬프트 길이 최적화:
   • 불필요한 컨텍스트 줄이기
   • 프롬프트 설명 단순화
3. 지식 베이스 검색 조정:
   • 검색 문서 수 줄이기
   • 유사도 임계값 높이기

​

Q3: API 호출이 실패하거나 오류를 반환합니까?

​

Q4: API 사용 비용을 낮추려면 어떻게 해야 합니까?

1. 모델 선택:
   • 간단한 작업에는 gpt-4o-mini 사용(gpt-4o 비용의 약 1/10)
   • 배치 작업에는 더 경제적인 모델 사용 고려
2. 캐시 활성화:
   • 동일한 질문에는 캐시된 결과 반환
   • Dify에서 유사도 매칭 설정
3. 출력 길이 최적화:
   • 적절한 Max Tokens 설정
   • 지나치게 긴 응답 생성을 피하기
4. 스트리밍 출력 사용:
   • 비용을 늘리지 않으면서 사용자 경험 개선

​

Q5: 민감한 데이터는 어떻게 처리해야 합니까?

1. 환경 변수 사용:
   • 코드에 API Key를 하드코딩하지 않기
   • Dify의 환경 변수 기능 사용
2. 접근 제어 설정:
   • 애플리케이션 접근 권한 설정
   • API 호출 시 인증 활성화
3. 감사 로그:
   • 애플리케이션 로그를 정기적으로 확인
   • 비정상적인 접근 패턴 모니터링

​

모범 사례

​

1. 프롬프트 엔지니어링

# 역할 정의
당신은 전문적인 [역할 설명]입니다

# 작업 목표
사용자의 [작업 설명]을 도와야 합니다

# 출력 요구사항
- 요구사항1
- 요구사항2
- 요구사항3

# 입력 정보
{{user_input}}

​

2. 지식 베이스 관리

• 청크 전략: 문서 청크 크기를 적절히 설정(권장 500-1000자)
• 메타데이터 태깅: 검색이 쉽도록 문서에 메타데이터 추가
• 정기 업데이트: 지식 베이스 콘텐츠를 최신 상태로 유지

​

3. 오류 처리

• 친절한 안내: 사용자에게 명확한 오류 메시지 제공
• 대체 전략: 기본 모델 실패 시 예비 모델로 전환
• 재시도 메커니즘: 일시적인 오류를 자동으로 재시도

​

4. 성능 모니터링

• 알림 설정: 잔액 부족 또는 오류율 증가 시 알림
• 정기 분석: 주간/월간 사용 데이터 분석
• 지속적인 최적화: 데이터에 따라 설정 조정

​

사용 사례 예시

​

1. 지능형 고객 지원

• 모델: gpt-4o-mini(높은 비용 효율)
• 지식 베이스: 제품 문서, FAQ
• 기능: 자주 묻는 질문 자동 답변, 복잡한 질문은 상담원에게 전환

​

2. 콘텐츠 제작 도우미

• 모델: gpt-4o 또는 claude-sonnet-4-5(고품질)
• 기능: 글 생성, 재작성, 교정
• 매개변수: Temperature=0.8(창의성 향상)

​

3. 코드 도우미

• 모델: claude-sonnet-4-5(코드에 강함)
• 기능: 코드 생성, 설명, 디버깅
• 지식 베이스: 프로젝트 문서, API 문서

​

4. 데이터 분석 도우미

• 모델: gpt-4o(강력한 추론 능력)
• 도구: Python 코드 실행, 데이터 시각화
• 기능: 데이터 분석, 보고서 생성

​

기능 특성

• 🤖 AI 애플리케이션 빠르게 구축 - 코딩 없이 강력한 AI 애플리케이션 생성
• 📚 지식 베이스 강화 - RAG 기술로 AI가 자체 데이터에 기반해 답변
• 🔧 유연한 워크플로우 - 복잡한 AI 로직을 시각적으로 오케스트레이션
• 🎯 정밀한 프롬프트 관리 - 버전 관리 및 A/B 테스트
• 📊 완전한 모니터링 분석 - 애플리케이션 사용 현황과 성능 파악
• 🔌 다양한 통합 방식 - API, 임베드, WebApp 등 다양한 방식
• 👥 팀 협업 - 여러 사람이 함께 애플리케이션 개발 가능
• 🌐 다중 모델 지원 - 서로 다른 AI 모델을 유연하게 전환

​

지원 및 도움말

• 📚 APIMart 문서
• 📚 Dify 공식 문서
• 💬 Discord 커뮤니티
• 🐦 Twitter @APIMart_
• 📧 기술 지원: zhihong@apimart.ai