Integration 세부 정보
| Retriever | Source | Package |
|---|---|---|
| ZoteroRetriever | Zotero API | langchain-community |
Setup
개별 쿼리에서 자동화된 추적을 원하시면, 아래 주석을 해제하여 LangSmith API key를 설정할 수 있습니다:Installation
이 retriever는langchain-zotero-retriever package에 있습니다. pyzotero 의존성도 필요합니다:
Instantiation
ZoteroRetriever parameter는 다음을 포함합니다:
k: 포함할 결과 수 (기본값: 50)type: 수행할 검색 유형. “Top”은 최상위 레벨 Zotero library item을 검색하고, “items”는 모든 Zotero library item을 반환합니다. (기본값: top)get_fulltext: library의 item에 첨부된 전체 텍스트를 검색합니다. False이거나 첨부된 텍스트가 없으면 page_content로 빈 문자열을 반환합니다. (기본값: True)library_id: 검색할 Zotero library의 ID. library에 연결하는 데 필수입니다.library_type: 검색할 library 유형. 개인 library는 “user”, 공유 그룹 library는 “group”. (기본값: user)api_key: 환경 변수로 설정되지 않은 경우 Zotero API key. 선택 사항이며, 비공개 그룹 library 또는 개인 library에 액세스하는 데 필요합니다. ZOTERO_API_KEY 환경 변수로 제공되면 자동으로 가져옵니다.
Usage
query 외에도 retriever는 다음과 같은 추가 검색 parameter를 제공합니다:
itemType: 검색할 item 유형 (예: “book” 또는 “journalArticle”)tag: library item에 첨부된 tag를 검색 (여러 tag를 결합하는 검색 구문은 문서 참조)qmode: 사용할 검색 모드. query가 검색하는 대상을 변경합니다. “everything”은 전체 텍스트 내용을 포함합니다. “titleCreatorYear”는 제목, 저자 및 연도를 검색합니다.since: 지정된 library 버전 이후에 수정된 객체만 반환합니다. 기본값은 모든 것을 반환합니다.
chain 내에서 사용
Zotero API 검색이 작동하는 방식으로 인해, 사용자 질문을 ZoteroRetriever에 직접 전달하면 만족스러운 결과를 반환하지 못하는 경우가 많습니다. chain이나 agentic framework에서 사용하려면 ZoteroRetriever를 tool로 변환하는 것이 좋습니다. 이렇게 하면 LLM이 사용자 쿼리를 API에 대한 더 간결한 검색 쿼리로 변환할 수 있습니다. 또한 LLM이 tag나 item type과 같은 추가 검색 parameter를 채울 수 있습니다.API reference
모든 ZoteroRetriever 기능과 설정에 대한 자세한 문서는 Github 페이지를 참조하세요. Zotero API에 대한 자세한 문서는 Zotero API reference를 참조하세요.Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.