> For the complete documentation index, see [llms.txt](https://docs.avis.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avis.net/vi/tich-hop/overview.md). # Tổng quan Những điểm chính Bạn có thể kết nối AVIS với các công cụ AI đang dùng, như agent lập trình, trợ lý AI, trình soạn thảo và giao diện chat. AVIS cung cấp API tương thích với OpenAI, Anthropic và Gemini. Vì vậy, hầu hết công cụ chỉ cần đổi **base URL** và **API key** để truy cập hơn 300 mô hình trong danh mục AVIS mà không cần sửa mã nguồn. *** ## Cách hoạt động Mỗi công cụ sử dụng một giao thức API nhất định. Hãy chọn giao diện AVIS tương thích với giao thức đó: | Giao diện AVIS | Base URL | Dùng cho các công cụ | | --------------------- | ------------------------------------ | -------------------------------------------------------- | | Tương thích OpenAI | `https://api.avis.net/api/openai/v1` | Codex CLI, Copilot CLI, OpenCode, Hermes Agent, OpenClaw | | Tương thích Anthropic | `https://api.avis.net/api/anthropic` | Claude Code, OpenClaw, Copilot CLI (tùy chọn) | | Tương thích Gemini | `https://api.avis.net/api/gemini` | Gemini CLI | Mọi giao diện đều hỗ trợ các mô hình trong danh mục AVIS. Bạn có thể dùng cùng một API key cho cả ba giao diện. Xem thêm [Giới thiệu](/vi/tai-lieu-api/introduction.md) và [Xác thực](/vi/tai-lieu-api/introduction/authentication.md). *** ## Các tích hợp có sẵn ### Agent lập trình Các agent này chạy trên terminal, đọc và sửa tệp cũng như thực thi lệnh trong dự án của bạn. | Công cụ | Giao diện AVIS | Nơi cấu hình | Hướng dẫn | | --------------- | --------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------- | | **Claude Code** | Anthropic | Biến môi trường `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN` hoặc `.claude/settings.local.json` | [Claude Code](/vi/tich-hop/coding/claude-code.md) | | **Codex CLI** | OpenAI (`/responses`) | `~/.codex/config.toml` | [Codex CLI](/vi/tich-hop/coding/codex.md) | | **Copilot CLI** | OpenAI hoặc Anthropic | Biến môi trường `COPILOT_PROVIDER_*` (BYOK) | [Copilot CLI](/vi/tich-hop/coding/copilot.md) | | **Gemini CLI** | Gemini | Biến môi trường `GEMINI_API_KEY`, `GOOGLE_GEMINI_BASE_URL` | [Gemini CLI](/vi/tich-hop/coding/gemini-cli.md) | | **OpenCode** | OpenAI | `opencode.json` | [OpenCode](/vi/tich-hop/coding/opencode.md) | ### Trợ lý Các trợ lý AI này chạy trên máy của bạn và tự thực hiện tác vụ. | Công cụ | Giao diện AVIS | Nơi cấu hình | Hướng dẫn | | -------------------------------- | --------------------- | --------------------------------------------------- | ------------------------------------------------------ | | **OpenClaw** | Anthropic hoặc OpenAI | `openclaw onboard` hoặc `~/.openclaw/openclaw.json` | [OpenClaw](/vi/tich-hop/assistant/openclaw.md) | | **Hermes Agent** (CLI & Desktop) | OpenAI | `hermes model` hoặc `~/.hermes/config.yaml` | [Hermes Agent](/vi/tich-hop/assistant/hermes-agent.md) | ### IDE & Trình soạn thảo | Công cụ | Cách dùng | Hướng dẫn | | ----------- | --------------------------------------------------------------- | ----------------------------------------------------------------- | | **VS Code** | Chọn mô hình AVIS trong bộ chọn mô hình của GitHub Copilot Chat | [VS Code Studio](/vi/tich-hop/ides-and-editors/vs-code-studio.md) | ### Chat & RAG | Công cụ | Cách dùng | Hướng dẫn | | -------- | ---------------------------------------------------------------------- | ----------------------------------------- | | **Onyx** | Giao diện chat tự host; chọn `avis` làm nhà cung cấp LLM khi thiết lập | [Onyx](/vi/tich-hop/chat-and-rag/onyx.md) | *** ## Các bước chung cho mọi tích hợp 1. **Tạo API key** tại [avis.net](https://avis.net) → **Settings → API Keys**. Bạn nên đặt giới hạn chi tiêu cho key. Xem [Cách lấy API Key](/vi/huong-dan/get-started/avis-api-key.md). 2. **Nạp credit** để key có số dư sử dụng. Xem [Cách nạp tiền vào số dư](/vi/huong-dan/get-started/avis-topup.md). 3. **Kết nối công cụ với AVIS** bằng base URL của giao diện phù hợp (xem bảng ở trên) và API key của bạn. 4. **Chọn mô hình** bằng cách truy vấn danh mục của giao diện bạn đang dùng, ví dụ `GET /api/openai/v1/models`. Định dạng model ID có thể khác nhau giữa các giao diện, nên hãy lấy ID từ đúng danh mục. 5. **Gửi một tin nhắn thử** để xác nhận công cụ đang gọi AVIS. > **Mẹo:** Dùng một API key riêng cho mỗi công cụ. Nếu một key bị lộ, bạn chỉ cần thu hồi key đó mà không ảnh hưởng tới các tích hợp khác. *** ## Khắc phục sự cố thường gặp | Triệu chứng | Nguyên nhân thường gặp | Cách xử lý | | ------------------------------------------------------ | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | `401 Unauthorized` | Key chưa được đặt trong shell chạy công cụ, không hợp lệ hoặc đã bị thu hồi | Kiểm tra bằng `curl -H "x-api-key: $AVIS_API_KEY" https://api.avis.net/api/openai/v1/models` | | `403 Forbidden` | Số dư credit đã hết | Nạp thêm credit | | `404` / không tìm thấy mô hình | Model ID không khớp với danh mục của giao diện đang dùng | Truy vấn lại `/models` của đúng giao diện | | Request vẫn được gửi đến nhà cung cấp gốc thay vì AVIS | Phiên đăng nhập cũ còn hiệu lực hoặc biến môi trường/cấu hình chưa được nạp | Đăng xuất khỏi phiên cũ rồi khởi động lại công cụ sau khi sửa cấu hình | Mỗi trang hướng dẫn có phần khắc phục sự cố chi tiết riêng cho công cụ đó. Xem thêm [Lỗi](/vi/tai-lieu-api/introduction/errors.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.avis.net/vi/tich-hop/overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.