# Kết nối các nguồn nghiên cứu

Trích dẫn hoặc nhập thư viện Zotero của bạn, cấp cho trợ lý các công cụ bài báo của alphaXiv, và thiết lập các dịch vụ tìm kiếm học thuật.

Mở **Settings → Integrations** để kết nối các dịch vụ nghiên cứu. Mỗi thẻ hiển thị logo riêng của dịch vụ. Các kết nối này thêm nguồn và công cụ vào quy trình của bạn; bản thảo và tài liệu tham khảo của bạn vẫn là tệp của dự án.

## Zotero

Oleafly đọc thư viện Zotero của bạn và không bao giờ thay đổi nó. Trích dẫn từ đó trong khi bạn viết, hoặc nhập toàn bộ thư viện vào tài liệu tham khảo của một dự án. [Trích dẫn từ thư viện Zotero của bạn](/docs/citations/#cite-from-your-zotero-library) nói về phần trích dẫn.

### Zotero trên máy tính này

Khi Zotero 7 trở lên đang mở trên cùng máy tính, Oleafly tự tìm thấy nó. Zotero cần bật trước một thiết lập:

1. Trong Zotero, mở **Settings → Advanced**.
2. Bật **Allow other applications on this computer to communicate with Zotero**.
3. Trong Oleafly, mở **Settings → Integrations → Zotero** và chọn **Test connection**.

Bài kiểm tra báo cáo phiên bản Zotero, phiên bản Better BibTeX nếu nó được cài, và mỗi thư viện chứa bao nhiêu mục. Khi Better BibTeX được cài, khóa trích dẫn đến từ nó. Nếu không, chúng đến từ trường Citation Key của Zotero, hoặc từ một dòng `Citation Key:` trong trường Extra.

Trong phần **Libraries to search**, hãy tắt bất kỳ thư viện nào bạn không muốn có trong kết quả tìm kiếm. **Sync now** đọc lại thư viện, và Oleafly cũng làm mới nó khi cửa sổ ứng dụng quay lại phía trước. Trong lúc Zotero đang đóng, tìm kiếm vẫn dùng bản sao từ lần đồng bộ gần nhất, và thẻ đó ghi rõ điều này. Zotero phiên bản cũ hơn không thể chia sẻ thư viện của nó, và thẻ sẽ nhắc bạn cập nhật lên Zotero 7 trở lên.

### Tài khoản zotero.org

Dùng tài khoản zotero.org của bạn khi Zotero không mở trên máy tính này. Các thư viện nhóm cũng đi kèm, và tài khoản chính là thứ mà **Import Zotero library** sử dụng.

1. Mở **Settings → Integrations → Zotero**.
2. Theo liên kết **API key page** đến [thiết lập tài khoản Zotero](https://www.zotero.org/settings/security#applications) của bạn.
3. Tạo một khóa với **Allow library access** được bật, và sao chép mã người dùng dạng số hiển thị trên cùng trang đó.
4. Nhập mã người dùng và **Zotero API key** vào Oleafly, rồi chọn **Connect**.

Oleafly kiểm tra khóa với Zotero trước khi lưu. Nếu Zotero từ chối khóa, khóa không thể đọc thư viện của bạn, hoặc khóa thuộc về mã người dùng khác, Oleafly sẽ nói rõ trường hợp nào và không lưu gì. Sau khi kết nối, thẻ hiển thị tên tài khoản. **Disconnect** xóa khóa đã lưu.

### Nhập toàn bộ thư viện của bạn

Khi tài khoản zotero.org của bạn đã được kết nối:

1. Mở một dự án và bảng **References** của nó.
2. Chọn **Import reference library**.
3. Trên thẻ **Zotero**, chọn **Import Zotero library**.

Oleafly đưa vào tối đa 5.000 mục dạng BibTeX và thêm chúng vào tài liệu tham khảo của dự án. Giống như khi nhập tệp, một tài liệu tham khảo có DOI đã nằm trong thư mục sẽ được bỏ qua, và thông báo cho biết bao nhiêu mục đã thêm và bao nhiêu mục đã có sẵn. Nếu thư viện của bạn chứa hơn 5.000 mục, Oleafly nhập 5.000 mục đầu tiên và thông báo cho bạn.

Trước khi bạn kết nối, chính thẻ đó cung cấp **Connect Zotero account**, vốn mở thẻ thiết lập này. Để nhập một lần mà không cần khóa API, hãy xuất Zotero RDF, BibTeX, RIS, hoặc EndNote XML từ trình quản lý tài liệu tham khảo của bạn và dùng [Nhập toàn bộ thư viện tài liệu tham khảo](/docs/citations/#import-a-whole-reference-library).

## alphaXiv

alphaXiv kết nối như một máy chủ MCP, nhờ đó trợ lý có thể tìm bài báo, đọc chúng, và dùng thư viện alphaXiv của bạn.

1. Đăng nhập tại [alphaxiv.org](https://www.alphaxiv.org), mở **Settings > API Keys**, và tạo một khóa.
2. Mở **Settings → Integrations → alphaXiv** trong Oleafly.
3. Dán khóa vào **alphaXiv API key** và chọn **Connect**.

Oleafly kết nối đến máy chủ của alphaXiv với khóa này trước khi lưu. Một khóa bị alphaXiv từ chối sẽ không được lưu. Sau khi kết nối, máy chủ còn xuất hiện dưới tên **alphaXiv** trong **AI Assistant → MCP**.

Trợ lý hỏi bạn trước mỗi lần gọi alphaXiv. Hãy thử một yêu cầu về một chủ đề cụ thể:

> Tìm các bài báo về ước lượng độ bất định cho hồi quy. So sánh các phương pháp này đo cái gì và kèm một liên kết nguồn cho mỗi mô tả.

Mở các bài báo được trả về để kiểm tra bằng chứng. Dùng **Disconnect** trong cùng thẻ thiết lập đó khi bạn không còn muốn kết nối.

## Các dịch vụ Citation Search

Thẻ thiết lập **Citation Search** lưu các thông tin xác thực mà từng chỉ mục sử dụng, mỗi chỉ mục hiển thị kèm logo của nó:

- Nên dùng **OpenAlex API key**. OpenAlex yêu cầu khóa cho việc truy cập thường xuyên; nếu không có, các tìm kiếm dùng chung một hạn mức ngày nhỏ. Một **OpenAlex contact email** còn đưa các yêu cầu vào nhóm polite pool của OpenAlex. Thẻ hiển thị **Connected** khi một khóa hoặc một email được lưu.
- **Semantic Scholar API key** là tùy chọn. Các yêu cầu ẩn danh dùng giới hạn công khai của dịch vụ.
- **Google Scholar (Serper)**: một khóa Serper API thêm Google Scholar làm nguồn. Nếu không có khóa, Citation Search bỏ Google Scholar khỏi tìm kiếm thay vì liệt kê nó như một nguồn thất bại.
- **arXiv, Crossref, và PubMed** không cần thông tin xác thực.

Khóa và email liên hệ OpenAlex cũng áp dụng cho tìm kiếm tài liệu của trợ lý. Thông tin xác thực nằm trên thiết bị này và chỉ được gửi đến dịch vụ mà nó thuộc về. Hãy xóa khóa đã lưu từ cùng thẻ thiết lập đó khi bạn không còn muốn Oleafly dùng nó.

Quay lại [Citation Search](/docs/literature-search/), chọn các chỉ mục bạn cần, và chạy một truy vấn theo chủ đề. Bạn có thể dùng các chỉ mục học thuật tích hợp mà không cần thiết lập mọi dịch vụ tùy chọn.

## Tra cứu một nguồn đã biết

Bạn không cần kết nối Zotero hay một nhà cung cấp tìm kiếm khi đã có một định danh đáng tin cậy. [Công cụ tài liệu tham khảo](/docs/tools/#build-references) có thể lấy DOI, arXiv ID, ISBN, hoặc PubMed ID, rồi cho phép bạn sửa các trường trước khi sao chép BibTeX hoặc một trích dẫn đã định dạng. Soạn thảo và định dạng trích dẫn thủ công vẫn dùng được ngoại tuyến; tra cứu danh mục cần kết nối.

## Các tích hợp khác

- [GitHub](/docs/github-sync/) kết nối quản lý mã nguồn của dự án với một kho chứa.
- [Máy chủ MCP ngoài](/docs/mcp/#add-external-tools-to-oleafly) thêm công cụ cho trợ lý của Oleafly.
- [Máy chủ MCP của Oleafly](/docs/mcp/) cho phép một ứng dụng khách ngoài truy cập các công cụ của dự án.
- [Nhà cung cấp mô hình](/docs/ai-setup/) và [CLI agent](/docs/cli-agents/) chọn trợ lý nào thực hiện công việc.