앱 툴킷
앱 툴킷 (App Toolkit)
Dify 앱을 더 유용하게 만들어 주는 선택적 기능들을 다룹니다. 빌더의 Features 패널을 열면 앱 유형에 따라 사용 가능한 기능이 무엇인지 확인할 수 있어요. 대화 시작 인사말, 후속 질문, 음성 기능, 파일 업로드, 인용, 콘텐츠 모더레이션 같은 기능이 여기에 속합니다.
Conversation Opener (대화 시작 인사말)
각 대화의 시작에서 사용자를 맞이하는 인사 메시지를 설정합니다. 앱이 잘하는 일로 안내하는 선택적 추천 질문(suggested questions)을 함께 넣을 수 있어요.
인사말과 추천 질문에 변수를 넣어 경험을 개인화할 수 있습니다.
- 인사말에서는
{또는/을 입력해 피커에서 변수를 삽입. - 추천 질문에서는
{{variable_name}}형식으로 변수 이름을 직접 입력.
Follow-up (후속 질문)
활성화하면 각 응답 뒤에 사용자가 대화를 이어갈 수 있도록 후속 질문이 생성됩니다. Settings를 클릭해 질문을 생성할 모델을 고르거나, 커스텀 프롬프트(최대 1,000자)를 작성해 질문의 개수·표현·길이를 조정할 수 있어요.
Text to Speech (텍스트 음성 변환)
AI 응답을 오디오로 변환합니다. 앱의 대상에 맞게 언어와 목소리를 구성하고, Auto Play를 활성화하면 AI가 응답하는 동안 오디오를 자동으로 스트리밍합니다.
Text to Speech는 워크스페이스의 text-to-speech 모델(Integrations > Model Provider > Default Models에서 설정)을 사용합니다. 이 기능은 기본 TTS 모델이 구성된 경우에만 Features 패널에 나타납니다.
Speech to Text (음성 텍스트 변환)
채팅 인터페이스에서 음성 입력을 활성화합니다. 켜면 최종 사용자는 타이핑 대신 마이크 버튼을 클릭해 메시지를 받아쓰기(dictate)할 수 있어요.
Speech to Text는 워크스페이스의 speech-to-text 모델(Integrations > Model Provider > Default Models에서 설정)을 사용합니다. 이 기능은 기본 STT 모델이 구성된 경우에만 Features 패널에 나타납니다.
File Upload (파일 업로드)
최종 사용자가 대화 중 언제든 파일을 보낼 수 있게 합니다. 허용할 파일 유형, 업로드 방식, 메시지당 최대 파일 수를 구성할 수 있어요.
파일별 크기 제한:
- 이미지: 10 MB
- 문서: 15 MB
- 오디오: 50 MB
- 비디오: 100 MB
인용 및 출처 (Citations and Attributions)
AI 응답 뒤의 출처 문서를 보여 줍니다. 활성화하면 연결된 지식 기반에서 끌어온 응답에 번호가 매겨진 인용이 표시되어 원본 문서와 청크로 연결됩니다.
콘텐츠 모더레이션 (Content Moderation)
사용자 입력, AI 출력, 또는 둘 다에서 부적절한 콘텐츠를 필터링합니다. 필요에 따라 모더레이션 공급자를 선택하세요:
- OpenAI Moderation: OpenAI의 전용 모더레이션 모델로 여러 범주의 유해 콘텐츠를 탐지.
- Keywords: 차단할 용어 목록 정의. 일치하는 항목이 있으면 미리 설정된 응답을 트리거.
- Custom Endpoint: 자체 필터링 로직을 위한 커스텀 모더레이션 엔드포인트 연결.
콘텐츠가 플래그되면 앱은 정의한 미리 설정된 응답으로 대체합니다.
Annotation Reply (어노테이션 답변)
LLM 응답보다 우선하는 큐레이션된 Q&A 쌍을 정의합니다. 사용자의 쿼리가 점수 임계값(쿼리가 얼마나 가까워야 하는지) 위의 어노테이션과 시맨틱하게 일치하면, LLM을 호출하지 않고 큐레이션된 답변이 바로 반환됩니다.
점수 임계값과 시맨틱 매칭에 쓰일 임베딩 모델을 구성할 수 있어요.
어노테이션을 만들고 관리하려면:
- Debug & Preview 또는 Logs에서 임의의 LLM 응답에 Add annotation 아이콘을 클릭해 기존 대화를 어노테이션으로 변환. 메시지가 어노테이션되면 아이콘이 Edit로 바뀌어 그 자리에서 수정할 수 있음.
- Annotations에서 새 Q&A 쌍을 수동으로 추가하고, 기존 어노테이션을 관리하며 히트 기록을 봅니다.
...을 클릭해 대량 가져오기/내보내기.
More Like This (비슷한 결과 더)
같은 입력에 대한 대체 출력을 생성합니다. 활성화하면 각 생성 결과에 변형을 만들 버튼이 포함되어, 쿼리를 다시 입력하지 않고도 다양한 응답을 탐색할 수 있어요.
결과당 최대 2개의 변형을 생성할 수 있으며, 각 변형은 추가 토큰을 사용합니다.