커스텀 AI 액션

AI 액션은 선택한 텍스트를 프롬프트와 함께 AI 모델에 보내고, 답을 선택 영역 옆 카드에 보여 줍니다. Duet Translate에는 세 가지가 들어 있고, 직접 만들 수도 있습니다.

내장 액션

액션	하는 일	단축키
사전	뜻, 발음, 품사, 난이도, 나온 문장과 그 번역	Alt + Shift + D
문장 구조 분석	문장을 쪼개서 문법을 설명	Alt + Shift + G
글쓰기 첨삭	선생님처럼 틀린 곳과 어색한 표현을 표시하고 고침	Alt + Shift + W

선택 툴바에서 액션을 실행하거나, 텍스트를 선택하고 단축키를 누릅니다.

직접 만들기

선택 툴바 → 커스텀 AI 액션을 열고 AI 액션 추가를 클릭합니다. 템플릿이나 Blank에서 시작합니다. 내장 액션은 바로 수정할 수 없지만, 사용자 지정으로 수정 가능한 사본을 만들 수 있습니다.

액션마다 다음 항목이 있습니다.

• 이름과 아이콘: 툴바에 보이는 것. 아이콘은 Iconify에서 가져오며, mdi:book-open-variant 같은 이름을 붙여 넣습니다.
• 제공업체: 액션을 실행할 AI 모델. 구조화된 출력을 지원해야 하는데, 요즘 모델은 대부분 지원합니다. 무료 계정도 여기서는 내장 AI를 쓸 수 있습니다.
• 시스템 프롬프트와 프롬프트: 모델에게 시킬 일.
• 출력 스키마: 답에 들어가야 할 필드. 예를 들어 용어, 뜻, 예문. 모델이 이를 채우므로 결과가 늘 같은 모양입니다.
• 레이아웃: 카드가 필드를 보여 주는 방식.

AI로 설정하기는 ChatGPT, Claude 등 다른 어시스턴트에 붙여 넣을 프롬프트를 복사합니다. 어시스턴트가 원하는 것을 묻고, 설정마다 무엇을 넣을지 알려 줍니다.

프롬프트 변수

변수	바뀌는 내용
{{selection}}	선택한 텍스트
{{paragraphs}}	선택 영역 주변 단락, 2,000자까지
{{targetLanguage}}	대상 언어
{{webTitle}}	페이지 제목
{{webUrl}}	페이지 전체 주소
{{webContent}}	페이지 본문, 2,000자까지

예를 들어 속어를 설명하는 액션의 프롬프트:

이 글에서 "{{selection}}"이 무슨 뜻인지 {{targetLanguage}}(으)로 설명하세요.
속어인지, 격식체인지, 중립적인지 말하고, 예문을 하나 더 드세요.

{{paragraphs}}

레이아웃

레이아웃은 Liquid 태그가 들어간 HTML이며, 답이 스트리밍되는 동안 채워집니다. 비워 두면 필드를 간단한 목록으로 보여 줍니다. 기본값으로 복원으로 내장 카드에서 시작할 수도 있습니다.

• {{ ["Definition"] }}은 필드 값을 보여 줍니다. 필드 버튼이 넣어 줍니다.
• {% if ["Example"] != blank %}…{% endif %}는 필드에 값이 있을 때만 내용을 보여 줍니다(값이 있을 때로 넣기).
• data-speak="{{ ["Term"] }}"가 붙은 요소를 클릭하면 답이 다 나온 뒤 그 값을 읽어 줍니다. data-speak-lang="es"를 더하면 음성 언어를 고릅니다. 읽기 버튼이 완성된 것을 넣어 줍니다.
• <style> 블록은 이 카드에만 스타일을 적용합니다.

오른쪽 미리보기는 샘플 데이터를 넣은 카드를 밝은 테마와 어두운 테마로 보여 줍니다.