인용

Claude가 사용자가 제공한 문서를 기반으로 질문에 답변할 때, 사용자는 Claude가 단순히 학습 데이터에서 정보를 가져온다고 생각할 수 있습니다. 하지만 Claude가 실제로 특정 출처를 인용하고 있다면 어떨까요? 인용 기능을 사용하면 Claude가 정보를 찾은 정확한 위치를 사용자에게 보여줄 수 있어, AI 애플리케이션에 신뢰와 투명성을 구축할 수 있습니다.

인용이 중요한 이유

인용이 없으면 사용자는 Claude의 응답이 기억에서 나온 것으로 인식합니다. 사용자는 정보를 검증할 방법이 없으며, 그것이 여러분이 제공한 특정 문서를 기반으로 한다는 것을 이해할 수 없습니다. 인용은 Claude가 응답의 각 부분을 생성하는 데 사용한 정확한 출처 자료를 사용자에게 보여줌으로써 이 문제를 해결합니다.

인용 활성화하기

인용을 활성화하려면 문서 메시지에 두 개의 필드를 추가하세요:

{
  "type": "document",
  "source": {
    "type": "base64",
    "media_type": "application/pdf",
    "data": file_bytes,
  },
  "title": "earth.pdf",
  "citations": { "enabled": True }
}

title 필드는 인용에 표시되는 문서 이름을 지정합니다. enabled: True가 설정된 citations 필드는 Claude가 정보를 찾은 위치를 추적하도록 지시합니다.

인용 구조

인용이 활성화되면 Claude의 응답은 더 복잡해집니다. 단순한 텍스트 대신, 인용 정보가 포함된 구조화된 콘텐츠를 받게 됩니다:

각 인용에는 다음이 포함됩니다:

• cited_text - Claude가 문서에서 참조하고 있는 정확한 텍스트
• document_index - 여러 문서를 제공한 경우, 어떤 문서인지
• document_title - 문서에 지정한 제목
• start_page_number - 인용된 텍스트가 시작되는 위치
• end_page_number - 인용된 텍스트가 끝나는 위치

인용 인터페이스 구축하기

인용의 진정한 힘은 이를 표시하는 사용자 인터페이스를 구축하는 데서 나옵니다. 텍스트 내에 번호가 매겨진 참조를 만들어 상세한 인용 정보로 연결할 수 있습니다:

사용자가 인용 번호에 마우스를 올리거나 클릭하면, Claude가 참조한 정확한 문서와 페이지를 확인할 수 있습니다. 이러한 투명성은 사용자가 정보를 검증하는 데 도움이 되며 Claude의 응답에 대한 신뢰를 구축합니다.

일반 텍스트와 함께하는 인용

인용은 PDF에만 제한되지 않습니다. 일반 텍스트 문서와도 사용할 수 있습니다:

{
  "type": "document", 
  "source": {
    "type": "text",
    "media_type": "text/plain",
    "data": article_text,
  },
  "title": "earth article",
  "citations": { "enabled": True }
}

일반 텍스트의 경우, 페이지 위치 대신 CitationCharLocation 객체를 받게 됩니다. 이는 텍스트 내의 문자 위치를 제공하여, Claude가 참조한 정확한 문장이나 단락을 강조 표시할 수 있게 합니다.

인용을 사용해야 하는 경우

인용은 다음과 같은 경우에 필수적입니다:

• 사용자가 정보의 정확성을 검증해야 할 때
• 민감하거나 중요한 문서를 다룰 때
• 출처에 대한 투명성이 애플리케이션에 신뢰를 구축할 때
• 사용자가 원본 출처 자료를 읽고 싶어할 때

인용을 구현함으로써, Claude를 답변만 제공하는 "블랙박스"에서 작업 과정을 보여주는 투명한 시스템으로 전환시켜, AI 애플리케이션을 더 신뢰할 수 있고 검증 가능하게 만들 수 있습니다.