인용 · Claude API로 구축하기

Claude가 사용자가 제공한 문서를 기반으로 질문에 답변할 때, 사용자는 Claude가 단순히 학습 데이터에서 가져온 것이라고 생각할 수 있습니다. 하지만 Claude가 특정 정보를 어디에서 찾았는지 정확히 보여줄 수 있다면 어떨까요? 바로 여기서 인용(citations)이 등장합니다 - 이는 Claude가 소스 문서의 특정 부분을 참조하고 각 정보가 어디에서 나왔는지 사용자에게 정확히 보여줄 수 있게 해주는 강력한 기능입니다.

인용이 중요한 이유

지구 대기가 어떻게 형성되었는지에 대해 Claude에게 질문하고 상세한 답변을 받는 상황을 상상해 보세요. 인용이 없다면 사용자는 정보를 검증할 방법이 없고, Claude가 실제로 사용자가 제공한 특정 문서를 참조하고 있다는 것을 이해할 방법도 없습니다. 인용은 Claude의 응답에서 소스 자료로 돌아가는 명확한 경로를 만들어 이러한 투명성 문제를 해결합니다.

인용 활성화하기

인용을 활성화하려면 문서 메시지 구조를 수정해야 합니다. 문서 블록에 두 개의 새로운 필드를 추가하세요:

python

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

title 필드는 문서에 읽기 쉬운 이름을 부여하며, citations: {"enabled": True}는 Claude에게 정보를 찾은 위치를 추적하도록 지시합니다.

인용 구조 이해하기

인용이 활성화되면 Claude의 응답은 더 복잡해집니다. 단순한 텍스트 대신, 각 주장에 대한 인용 정보를 포함하는 구조화된 데이터를 받게 됩니다.

각 인용에는 다음과 같은 몇 가지 주요 정보가 포함됩니다:

cited_text - Claude의 진술을 뒷받침하는 문서의 정확한 텍스트
document_index - Claude가 참조하고 있는 문서 (여러 문서를 제공할 때 유용함)
document_title - 문서에 지정한 제목
start_page_number - 인용된 텍스트가 시작되는 위치
end_page_number - 인용된 텍스트가 끝나는 위치

인용을 활용한 사용자 인터페이스 구축

인용의 진정한 힘은 이 정보를 접근 가능하게 만드는 사용자 인터페이스를 구축하는 데서 나옵니다. 사용자가 인용 마커 위에 마우스를 올려 정보가 정확히 어디에서 나왔는지 확인할 수 있는 인터랙티브 요소를 만들 수 있습니다.

이를 통해 사용자가 다음을 할 수 있는 투명한 경험이 만들어집니다:

Claude의 답변이 실제 소스 자료에 근거하고 있음을 확인
원본 문서를 확인하여 정보를 검증
각 인용된 정보 조각 주변의 맥락을 이해

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

인용은 PDF 문서에만 제한되지 않습니다. 일반 텍스트 소스와도 사용할 수 있습니다. 텍스트로 작업할 때는 다음과 같이 문서 구조를 수정하세요:

python

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

일반 텍스트 소스를 사용하면 페이지 번호 대신, Claude가 각 정보를 찾은 텍스트 내 정확한 위치를 나타내는 문자 위치를 얻게 됩니다.

인용을 사용해야 하는 경우

인용은 다음과 같은 경우에 특히 유용합니다:

사용자가 정확성을 위해 정보를 검증해야 할 때
사용자가 참조할 수 있어야 하는 권위 있는 문서로 작업할 때
애플리케이션에서 정보 소스에 대한 투명성이 중요할 때
사용자가 특정 사실 주변의 더 넓은 맥락을 탐색하고 싶어할 때

인용을 구현함으로써 Claude를 답변만 제공하는 "블랙박스"에서 작업 과정을 보여주는 투명한 연구 어시스턴트로 전환시킬 수 있습니다. 이는 사용자 신뢰를 구축하고 필요할 때 소스 자료를 더 깊이 탐구할 수 있게 해줍니다.