# Thiết lập AI

Kết nối một nhà cung cấp API, một mô hình cục bộ, hoặc một tác nhân CLI đã cài.

Chọn cách bạn muốn làm việc. Oleafly có thể chạy trình trợ lý tích hợp sẵn với một API mô hình, kết nối tới một mô hình cục bộ, hoặc dùng một tác nhân CLI đã cài.

| Bạn đã có… | Chọn… |
| --- | --- |
| Một khóa API mô hình | **Providers and keys** |
| Một máy chủ mô hình cục bộ | **Ollama** hoặc một nhà cung cấp tùy chỉnh tương thích OpenAI |
| Một tác nhân lập trình đã cài | [**CLI agents**](/docs/cli-agents/) |
| Một ứng dụng khách MCP ngoài | [**MCP**](/docs/mcp/) |

Mở **Settings → AI Assistant** để cấu hình đường dẫn bạn muốn. Bạn có thể giữ đồng thời nhiều nhà cung cấp đã kết nối và đổi mô hình ngay trong lúc trò chuyện.

Chưa có khóa API? Một tác nhân CLI mà bạn đã đăng nhập có thể thay thế. Hãy chọn nó làm mô hình cho Tools, và Tools cùng các tính năng AI khác của Oleafly sẽ dùng nó. Xem [Dùng một agent thay cho khóa API](/docs/cli-agents/#use-an-agent-instead-of-an-api-key).

![Settings → AI Assistant → Providers and keys. Mở rộng nhà cung cấp của bạn để cấu hình. Ollama nằm gần cuối danh sách.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

![Khóa nhà cung cấp, CLI agent và kỹ năng trong phần cài đặt trợ lý.](https://cdn.oleafly.com/images/gifs/desktop/settings-ai-agents.gif?v=2)

## Kết nối một nhà cung cấp

1. Mở **Providers and keys** và mở rộng một nhà cung cấp.
2. Nhập khóa API của nhà cung cấp và lưu lại.
3. Oleafly kiểm tra kết nối và làm mới danh sách mô hình.
4. Chọn một mô hình trong trình trợ lý, hoặc đặt mặc định trong **Instructions**.

OpenAI

Anthropic

Google Gemini

Perplexity

Z.AI

Groq

OpenRouter

DeepSeek

Mistral

xAI

Ollama

Mỗi thẻ nhà cung cấp trong Settings dẫn đến phần thiết lập khóa của nó. Ollama kết nối tới một máy chủ mô hình cục bộ.

## Chọn một mô hình

Các hàng mô hình hiển thị thông tin năng lực khi có: kích thước ngữ cảnh, thị giác, công cụ, và suy luận. Hãy dùng mô hình hỗ trợ công cụ cho công việc dự án và hỗ trợ thị giác để kiểm tra hình ảnh.

**Verified** nghĩa là một lần kiểm tra gọi công cụ đã thành công. **Untested** nghĩa là trình trợ lý chưa xác minh mô hình đó; **Blocked** kèm lý do khiến nó không thể được chọn. Các huy hiệu này mô tả khả năng tương thích công cụ. Chúng không đánh giá chất lượng nghiên cứu hay văn phong của một mô hình.

Một mô hình không gọi được công cụ vẫn dùng được cho trò chuyện thường. Khi mô hình đó đang được chọn, ô soạn thảo hiển thị **Chat only, this model cannot use tools**.

Chọn **Refresh** trên thẻ nhà cung cấp khi danh sách mô hình khả dụng thay đổi. Mỗi nhà cung cấp có thể được làm mới một lần mỗi 30 giây; di chuột lên nút để xem còn bao lâu. Bạn cũng có thể thêm một mô hình theo định danh của nó.

**Enable all** và **Disable all** bật hoặc tắt mọi mô hình trong danh sách của một nhà cung cấp. Hãy tắt cả một danh sách dài chỉ bằng một cú nhấp, rồi bật lại vài mô hình bạn dùng.

## Kết nối một mô hình cục bộ

Cài đặt và khởi động [Ollama](https://ollama.com/), rồi tải xuống một mô hình trong Ollama. Trong Oleafly, mở thẻ Ollama và chọn **Check for Ollama**. Chọn một mô hình đã cài khi máy chủ được tìm thấy.

Một mô hình cục bộ giữ các yêu cầu mô hình trên chính máy của bạn. Các công cụ nghiên cứu trực tuyến vẫn liên hệ dịch vụ nguồn của chúng khi được dùng.

## Thêm một điểm cuối tùy chỉnh

Chọn **Add custom provider** cho một dịch vụ tương thích OpenAI, máy chủ cục bộ, hoặc cổng chuyển tiếp. Nhập tên, URL cơ sở, và khóa cần thiết nếu có. Lưu lại rồi chọn một mô hình.

OpenCode Zen và OpenCode Go hoạt động như nhà cung cấp tùy chỉnh. Chúng từ chối các yêu cầu không có ID phiên, nên Oleafly gửi cho chúng ID của từng cuộc trò chuyện, và không gửi cho nhà cung cấp nào khác. Một máy chủ Lemonade cục bộ cũng dùng được ở đây. Với các mô hình của nó có suy nghĩ trước khi trả lời, xem [Bỏ qua bước suy nghĩ](/docs/ollama/#skip-the-thinking-step).

Chỉnh sửa một nhà cung cấp đã lưu cho phép bạn đổi địa chỉ của nó. Khóa đã lưu sẽ được gửi đến địa chỉ mới khi nhà cung cấp đó được dùng, nên hãy kiểm tra đích đến trước khi lưu.

## Đặt tùy chọn viết

**Instructions** chứa các tùy chọn thường trực và mô hình trò chuyện mặc định. Hãy dùng các hướng dẫn cụ thể:

> Dùng chính tả Anh-Anh. Giữ nguyên các khóa trích dẫn. Giải thích các thay đổi đối với phương trình trước khi áp dụng.

**Personas** lưu các bộ hướng dẫn đặt tên sẵn. **Skills** cung cấp quy trình cho công việc nghiên cứu lặp lại. [Khám phá skills →](/docs/skills/)

## Khóa và chi phí

Khóa nhà cung cấp được mã hóa trong bộ nhớ cục bộ của ứng dụng và không nằm trong các tệp nguồn dự án. Các yêu cầu qua máy chủ đi đến nhà cung cấp đã chọn cùng ngữ cảnh được cung cấp. Phí API mô hình và thuê bao CLI do nhà cung cấp tương ứng tính.

[Xem mức dùng và ngân sách →](/docs/ai-usage/)
