OpenAI
Trang này được dịch bằng máy học. Xem bài viết gốc bằng tiếng Anh.

Câu hỏi thường gặp về Assistants API (v2)

Tìm hiểu các tính năng, giới hạn, mức giá của Assistants API v2 và cách chuyển sang Responses API.

Đã cập nhật: 14 days ago

Kể từ ngày 11 tháng 3 năm 2025, chúng tôi đã phát hành các khối dựng nền tảng Agents mới của mình. Để biết chi tiết, hãy xem tài liệu API của chúng tôi cho Responses API, các Công cụ bao gồm Web Search, File Search và Computer Use, cũng như Agents SDK với Tracing của chúng tôi. Dựa trên phản hồi của bạn về Assistants API beta, chúng tôi đã tích hợp các cải tiến chính vào Responses API. Sau khi đạt được đầy đủ tính năng tương đương, chúng tôi sẽ công bố kế hoạch ngừng hỗ trợ Assistants API vào cuối năm nay, với ngày ngừng hoạt động mục tiêu trong nửa đầu năm 2026.

Câu hỏi thường gặp

Assistants API là gì?

Assistants API giúp các nhà phát triển dễ dàng xây dựng trợ lý AI mạnh mẽ ngay trong ứng dụng của mình. Với API này, bạn không cần tự quản lý lịch sử hội thoại và có thể truy cập các công cụ do OpenAI lưu trữ như Trình Thông dịch Mã và Tìm kiếm tệp. API cũng hỗ trợ khả năng gọi hàm được cải tiến cho các công cụ của bên thứ ba.

Tôi vẫn có thể sử dụng API Assistants v1 beta không?

Không. Kể từ ngày 18 tháng 12 năm 2024, người dùng không còn quyền truy cập vào phiên bản v1 beta của API Assistants. Hiện tại, chúng tôi chỉ hỗ trợ v2. Vui lòng tham khảo hướng dẫn chuyển đổi này để chuyển các lệnh gọi API từ v1 sang v2.

Làm cách nào để truy cập?

Assistants API có sẵn cho bất kỳ ai có tài khoản OpenAI API, nhưng API này đã bị ngừng hỗ trợ và sẽ bị gỡ bỏ vào tháng 8 năm 2026. Đối với dự án mới, hãy dùng Responses API thay thế. Nếu bạn đã sử dụng Assistants API, hãy lên kế hoạch di chuyển sang Responses API. Bạn vẫn có thể truy cập các assistant hiện có trong Assistants Playground trong khi API vẫn còn khả dụng.

Trợ lý là gì?

Trợ lý là một AI được xây dựng cho mục đích cụ thể, sử dụng các mô hình của OpenAI và có thể truy cập tệp, duy trì các luồng hội thoại lâu dài và gọi công cụ.

Luồng là gì?

Luồng là một phiên hội thoại giữa trợ lý và người dùng. Luồng giúp đơn giản hóa việc phát triển ứng dụng bằng cách lưu trữ lịch sử tin nhắn và cắt bớt khi cuộc hội thoại vượt quá độ dài ngữ cảnh của mô hình.

Công cụ Tìm kiếm tệp là gì?

Công cụ file_search tích hợp sẵn nhiều phương pháp truy xuất tối ưu, giúp bạn trích xuất đúng dữ liệu từ tệp để bổ sung cho câu trả lời của mô hình.

Theo mặc định, công cụ file_search sử dụng các thiết lập sau:

  • Kích thước đoạn: 800 token

  • Phần chồng lặp giữa các đoạn: 400 token

  • Mô hình nhúng: text-embedding-3-large với 256 chiều

  • Số đoạn tối đa được thêm vào ngữ cảnh: 20

Việc tải tệp lên có những giới hạn nào?

Các giới hạn khi tải tệp lên gồm:

  • 512 MB mỗi tệp

  • 5 triệu token mỗi tệp

  • 10.000 tệp mỗi kho lưu trữ vectơ

  • 1 kho lưu trữ vectơ mỗi trợ lý

  • 1 kho lưu trữ vectơ mỗi luồng

Giới hạn tổng dung lượng lưu trữ cho mỗi dự án trong một tổ chức là 100 GB.

Công cụ Tìm kiếm tệp có những hạn chế nào?

Chúng tôi đã xác định một số hạn chế và đang nỗ lực bổ sung khả năng hỗ trợ trong những tháng tới:

  1. Hiện chưa có cách thay đổi các thiết lập chia đoạn, nhúng hoặc truy xuất.

  2. Chúng tôi chưa hỗ trợ phân tích hình ảnh trong tài liệu.

  3. Chúng tôi chưa hỗ trợ truy xuất từ các định dạng tệp có cấu trúc (như tệp .csv hoặc .jsonl). Xem các loại tệp được hỗ trợ.

Assistants API có những giới hạn tốc độ nào?

Giới hạn tốc độ của Assistants API không phụ thuộc vào cấp sử dụng và mô hình. Thay vào đó, giới hạn mặc định được áp dụng theo loại yêu cầu, với một vài ngoại lệ:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 yêu cầu mỗi phút

Trình Thông dịch Mã trong API được tính phí như thế nào?

Trình Thông dịch Mã có giá 0,03 USD/phiên. Nếu trợ lý của bạn gọi Trình Thông dịch Mã đồng thời trong hai luồng khác nhau, hai phiên Trình Thông dịch Mã sẽ được tạo (2 * 0,03 USD). Theo mặc định, mỗi phiên hoạt động trong một giờ. Điều này có nghĩa là bạn chỉ trả khoản phí này một lần nếu người dùng tiếp tục gửi chỉ dẫn cho Trình Thông dịch Mã trong cùng một luồng trong tối đa một giờ.

Tìm kiếm tệp trong API được tính phí như thế nào?

Tìm kiếm tệp có giá 0,10 USD/GB dung lượng kho lưu trữ vectơ mỗi ngày (miễn phí GB lưu trữ đầu tiên). Dung lượng kho lưu trữ vectơ được tính dựa trên kích thước thực tế sau khi tệp của bạn được phân tích, chia đoạn và nhúng.

Mọi kho lưu trữ vectơ được tạo trước ngày 17/4/2024 sẽ được miễn phí đến hết năm 2024. Sau đó, các kho này sẽ:

  • Được tính phí theo mức giá hiện hành (hiện là 0,10 USD/GB/ngày) nếu đã được sử dụng ít nhất một lần trong một lượt chạy (Run) được tạo sau ngày 17/4/2024.

  • Bị xóa nếu chưa được sử dụng trong bất kỳ lượt chạy nào từ ngày 17/4/2024 đến ngày 31/12/2024 — nhằm tránh tính phí cho những kho lưu trữ vectơ mà bạn có thể đã tạo trước khi thay đổi giá này được công bố nhưng chưa từng sử dụng.

Có giới hạn về số lượng assistant mà tôi có thể tạo không?

Không có giới hạn về số lượng assistant mà một tổ chức có thể tạo.

API có hỗ trợ truyền phát trực tuyến không?

Có, Assistants API hỗ trợ truyền phát trực tuyến.

Assistants API có hỗ trợ chế độ JSON không?

Có, Assistants API hỗ trợ chế độ JSON thông qua tham số response_format trên các đối tượng Assistants hoặc Run.

Assistants API có quản lý cả các yêu cầu gọi hàm của bên thứ ba không?

Không. Mặc dù tính năng gọi hàm cho phép mô hình chọn công cụ và định dạng yêu cầu gửi đến các công cụ đó, OpenAI không quản lý việc thực thi lệnh gọi đến công cụ của bên thứ ba.

Dữ liệu tôi gửi cho OpenAI được xử lý như thế nào?

Cũng như các phần khác của nền tảng, dữ liệu và tệp gửi đến API của OpenAI không bao giờ được dùng để huấn luyện các mô hình của chúng tôi và bạn có thể xóa dữ liệu bất cứ khi nào cần. Dữ liệu tải lên Assistants API được lưu trữ vô thời hạn cho đến khi người dùng xóa thủ công.

Có thể dùng DALL-E qua Assistants API không?

Hiện tại, DALL-E chưa được hỗ trợ.

Có giao diện người dùng cho Assistants API không?

Bạn có thể xem Khu thử nghiệm dành cho Assistants API. Hãy đảm bảo bạn đang ở chế độ xem Assistants trên thanh bên trái và đang sử dụng một mô hình tương thích với các Công cụ mà bạn muốn bật.

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

Phần hướng dẫn cho trợ lý trong Assistants API có giới hạn bao nhiêu ký tự?

Trường hướng dẫn cho trợ lý có độ dài tối đa là 256.000 ký tự.

Tôi nhận được thông báo lỗi như “Máy chủ gặp lỗi khi xử lý yêu cầu của bạn. Chúng tôi xin lỗi về sự cố này! Bạn có thể gửi lại yêu cầu hoặc liên hệ với chúng tôi qua trung tâm trợ giúp tại help.openai.com nếu lỗi vẫn tiếp diễn. ” Tôi nên làm gì?

Nếu bạn gặp lỗi này, có thể câu lệnh của bạn chưa được thiết lập đúng. Nếu bạn liên tục gửi lại yêu cầu nhưng vẫn thất bại, hãy thử các cách sau:

  1. cấu trúc lại câu lệnh để mọi lệnh có tính chất như hàm đều được xử lý như hàm

  2. thêm mọi lệnh trong câu lệnh của bạn vào tools dưới dạng hàm

Tại sao công cụ Tìm kiếm tệp của tôi hoạt động chưa hiệu quả?

Khi sử dụng công cụ Tìm kiếm tệp, chúng tôi khuyên bạn nên đặt max_prompt_tokens ở mức tối thiểu là 20.000. Với các cuộc hội thoại dài hơn hoặc có nhiều lần tương tác với Tìm kiếm tệp, hãy cân nhắc tăng giới hạn này lên 50.000 hoặc tốt nhất là bỏ hoàn toàn giới hạn max_prompt_tokens để có kết quả chất lượng cao nhất.

Tôi có thể gửi phản hồi bằng cách nào?

Chúng tôi rất mong nhận được phản hồi của bạn trên Diễn đàn Nhà phát triển, qua Trung tâm Trợ giúp tại help.openai.com hoặc trên Twitter @OpenAIDevs.

Bài viết này có hữu ích không?