Câu hỏi thường gặp về API Trợ lý (v2)

API của Trợ lý là gì?

CáiAPI Trợ lýcho phép các nhà phát triển dễ dàng xây dựng các trợ lý AI mạnh mẽ trong ứng dụng của họ. API này loại bỏ nhu cầu quản lý lịch sử hội thoại và thêm quyền truy cập vào 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ợ cải tiến việc gọi hàm cho các công cụ của bên thứ ba.

Tôi còn có thể sử dụng giao diện lập trình trợ lý (Assistants API) v1 beta không?

Không. Tính đến18 tháng 12, 2024người dùng không còn quyền truy cập vàov1phiên bản beta của API Trợ lý. Hiện tại chúng tôi chỉ hỗ trợ v2. Vui lòng xem xét điều nàyhướng dẫn di cưđể chuyển đổi các cuộc gọi API của bạn từ v1 sang v2.

Làm thế nào để tôi truy cập nó?

API Trợ lý có sẵn cho bất kỳ ai có tài khoản API OpenAI, nhưng nó đã lỗi thời và sẽ bị loại bỏ vào tháng 8 năm 2026. Đối với các dự án mới, hãy sử dụng API Phản hồi thay thế. Nếu bạn đã sử dụng API Trợ lý, hãy lên kế hoạch chuyển đổi sang API Phản hồi. Bạn vẫn có thể truy cập các trợ lý hiện có trong Trình chơi Trợ lý miễn là API vẫn còn hoạt động.

Trợ lý là gì?

Một trợ lý đại diện cho một AI được xây dựng cho mục đích cụ thể sử dụng OpenAI’smô hìnhvà có thể truy cập các tệp, duy trì các luồng liên tục, và gọi các công cụ.

Thread là gì?

Một chuỗi là một phiên trò chuyện giữa trợ lý và người dùng. Các chuỗi 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 trò chuyện trở nên quá dài so với chiều dài ngữ cảnh của mô hình.

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

Cáitìm kiếm tệpcông cụ triển khai một số thực hành tốt nhất về truy xuất ngay khi sử dụng để giúp bạn trích xuất dữ liệu phù hợp từ các tệp của mình nhằm tăng cường các phản hồi của mô hình. Để biết thêm thông tin, vui lòng đọc của chúng tôitài liệu cho nhà phát triển.

Theo mặc định, công cụ file_search sử dụng các cài đặt sau:

• Kích thước khối: 800 token

• Chồng lấn đoạn: 400 từ

• Mô hình nhúng:text-nhúng vector (Embeddings)-3-lớnở 256 chiều

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

Các hạn chế đối với việc tải lên tệp là gì?

Các hạn chế đối với việc tải lên một Tệp là:

• 512 MB mỗi tệp

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

• 10 nghìn tệp cho mỗi kho vectơ

• 1 kho vector cho mỗi trợ lý

• 1 kho vector cho mỗi luồng

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

Những hạn chế của công cụ Tìm kiếm Tệp là gì?

Chúng tôi có một vài hạn chế đã biết mà chúng tôi đang làm việc để thêm hỗ trợ trong những tháng tới:

1. Hiện tại không có cách nào để thay đổi cài đặt phân đoạn, nhúng hoặc truy xuất.

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

3. Chúng tôi không hỗ trợ truy xuất trên 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ợ.

Giới hạn tốc độ của API Trợ lý là gì?

Giới hạn tốc độ cho API Trợ lý không gắn liền vớicấp độ sử dụng và mô hình. Thay vào đó, có các giới hạn mặc định theo loại yêu cầu, với một vài ngoại lệ:

• LẤY: 1000 Vòng/phút

• ĐĂNG: 300 Vòng/phút

• XÓA: 300 yêu cầu mỗi phút

Giá của Trình thông dịch Mã trong API như thế nào?

Trình thông dịch mã được định giá là $0,03 / phiên. Nếu trợ lý của bạn gọi Trình thông dịch mã đồng thời trong haikhácchủ đề, điều này sẽ tạo ra hai phiên Code Interpreter (2 * $0.03). Mỗi phiên mặc định hoạt động trong một giờ, có nghĩa là bạn chỉ phải trả khoản phí này một lần nếu người dùng của bạn tiếp tục đưa ra chỉ dẫn cho Code Interpreter trong cùng một cuộc trò chuyện trong vòng tối đa một giờ.

Giá tìm kiếm tệp trong API như thế nào?

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

Bất kỳ kho vectơ nào được tạo trước ngày 17 tháng 4 năm 2024 sẽ miễn phí cho đến cuối năm 2024, sau đó chúng sẽ hoặc là:

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

• Xóa nếu chúng chưa từng được sử dụng trong một lần chạy từ ngày 17 tháng 4 năm 2024 đến ngày 31 tháng 12 năm 2024 — điều này nhằm tránh bạn bị tính phí cho các cửa hàng vector 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 trợ lý mà tôi có thể tạo không?

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

Có phát trực tuyến trên API không?

Vâng, phát trực tuyến có sẵn trên API của Trợ lý.

Chế độ JSON có khả dụng trong API Trợ lý không?

Vâng, chế độ JSON có sẵn trên API của Assistants thông quađịnh_dạng_phản_hồitham số trên các đối tượng Assistants hoặc Run.

API Trợ lý có quản lý các yêu cầu gọi chức năng của bên thứ ba không?

Không. Mặc dù việc gọi hàm cho phép mô hình lựa chọn công cụ và định dạng yêu cầu cho chúng, việc thực hiện các cuộc gọi đến các công cụ của bên thứ ba không được quản lý bởi OpenAI.

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

Như với phần còn lại của nền tảng của chúng tôi, dữ liệu và tệp được gửi đến API OpenAI đềukhông bao giờ được sử dụng để đào tạo các mô hình của chúng tôivà bạn có thể xóa dữ liệu của mình bất cứ khi nào bạn cần. Dữ liệu được tải lên API của Trợ lý được lưu trữ vô thời hạn cho đến khi người dùng tự xóa nó.

DALL-E có sẵn thông qua API Trợ lý không?

Vào thời điểm này, DALL-E không khả dụng.

Có giao diện người dùng cho API Trợ lý không?

Bạn có thể xemSân chơicho API Trợ lý. Hãy chắc chắn rằng bạn đang ở trongTrợ lýxem trên thanh bên trái và 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.

Giới hạn ký tự cho hướng dẫn trợ lý trong API Trợ lý là bao nhiêu?

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

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

Nếu bạn nhận được lỗi này, điều đó có thể có nghĩa là lời nhắc của bạn chưa được thiết lập đúng. Nếu bạn tiếp tục thử lại yêu cầu mà nó vẫn thất bại, đây là một số điều bạn có thể thử:

1. hãy chắc chắn điều chỉnh lại lời nhắc của bạn để xử lý bất kỳ lệnh giống hàm nào như các hàm

2. thêm bất kỳ lệnh nào trong lời nhắc của bạn như một hàm đểcông cụ

Tại sao công cụ Tìm kiếm Tệp của tôi không hoạt động tốt?

Khi sử dụng công cụ Tìm kiếm Tệp, chúng tôi khuyến nghị đặt max_prompt_tokens không dưới 20.000. Đối với các cuộc trò chuyện dài hơn hoặc nhiều lần tương tác với Tìm kiếm Tệp, hãy xem xét tăng giới hạn này lên 50.000, hoặc lý tưởng nhất, loại bỏ hoàn toàn giới hạn max_prompt_tokens để có được kết quả chất lượng cao nhất. Đọc thêmở đây.

Làm thế nào tôi có thể cung cấp phản hồi?

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