Voyage AI: Voyage Code 3
Voyage Code 3 tạo embedding cho truy xuất từ văn bản sang mã, từ mã sang mã và từ docstring sang mã. Cửa sổ 32 000 token, số chiều vector có thể chọn và đầu ra lượng tử hóa hỗ trợ tìm kiếm kho mã và chọn ngữ cảnh mã cho trợ lý lập trình.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Voyage Code 3 là mô hình embedding chuyên truy xuất mã nguồn. Nhà sản xuất mô tả các nhiệm vụ từ ngôn ngữ tự nhiên sang mã, từ mã sang mã và từ docstring sang mã: câu hỏi có thể tìm phần triển khai, đoạn mã có thể tìm logic liên quan và mô tả hàm có thể xác định mã phù hợp. Mô hình tạo vector phục vụ truy xuất, thay vì tệp đã sửa hoặc chương trình hoàn chỉnh.
Chuẩn bị tài liệu kho mã theo những đơn vị mã có ý nghĩa. Giữ hàm cùng tên, chữ ký và chú thích giải thích mục đích của nó. Với thành phần lớn hơn, thêm các định nghĩa lân cận cần để hiểu thao tác. Lưu kho mã, phiên bản, đường dẫn tệp và vị trí dòng riêng để kết quả tìm kiếm mở đúng nguồn đã được tạo embedding.
Tìm kiếm bằng ngôn ngữ tự nhiên có thể mô tả hành vi, chẳng hạn tìm phần dự án kiểm tra tệp tải lên trước khi lưu. Truy vấn dựa trên mã có thể cung cấp hàm cần tìm logic tương ứng ở nơi khác. Chọn các lượt tìm kiếm đại diện từ nhiệm vụ phát triển thực tế, gồm cách đặt tên chưa quen, các phần triển khai tương tự và tiện ích có ý nghĩa phụ thuộc vào mã xung quanh.
Cửa sổ ngữ cảnh 32 000 token chứa được các đoạn mã đáng kể. Sử dụng dung lượng này có chủ đích: hàm hoàn chỉnh và các phần phụ thuộc liên quan có thể cung cấp nhiều thông tin hơn một khối tùy ý bị cắt giữa luồng điều khiển. Giữ định dạng nguồn dễ đọc và bảo toàn cú pháp ngôn ngữ khi trích xuất. Nếu tệp nguồn lớn hơn cửa sổ đầu vào, chia tại các ranh giới cấu trúc hữu ích và giữ quan hệ giữa các đoạn với tệp cha.
Voyage Code 3 hỗ trợ embedding có 2 048, 1 024, 512 hoặc 256 chiều, cùng các biểu diễn dấu phẩy động, tám bit có dấu hoặc không dấu và nhị phân. Các thiết lập này phục vụ những kích thước chỉ mục kho mã và cấu hình tìm kiếm khác nhau. Đánh giá biểu diễn gọn trên cùng các lượt tìm kiếm thực tế dùng cho mốc so sánh lớn hơn, kiểm tra hàm hoặc tệp đúng có còn trong các kết quả hữu ích không.
Với trợ lý lập trình, trước tiên truy xuất các đoạn nguồn liên quan, rồi cung cấp chúng cùng tham chiếu tệp cho thành phần phụ trách trả lời hoặc chỉnh sửa. Sự tương đồng giúp chọn ngữ cảnh; nó không xác lập hai phần triển khai có thể thay thế cho nhau. Kiểm tra đầu vào, tác động phụ và các điều kiện ràng buộc xung quanh trong mã được truy xuất trước khi dùng để định hướng chỉnh sửa.
Tách các phiên bản kho mã không liên quan bằng siêu dữ liệu và giữ khả năng truy về nguồn của những phiên bản được lập chỉ mục. Nếu hàm chuyển vị trí hoặc đổi hành vi, cập nhật cả vector và vị trí nguồn. Cùng thiết lập embedding cần được dùng cho nguồn được lập chỉ mục và các truy vấn của nó. Khi di chuyển chỉ mục, đối chiếu kết quả với tập câu hỏi có sẵn để mô hình hoặc biểu diễn vector thay đổi không âm thầm đổi mã mà nhà phát triển nhìn thấy.
Các phép kiểm tra hữu ích gồm truy vấn có tìm phần triển khai thật thay vì chỉ tên kiểm thử không, docstring có tìm đúng hàm tương ứng không, và mã liên quan về ngữ nghĩa có được phân biệt với đoạn chỉ giống bề ngoài không. Giữ văn bản nguồn và vị trí được trả về trong kết quả để nhà phát triển kiểm tra bằng chứng. Điều này biến embedding chuyên về mã của mô hình thành công cụ điều hướng và chọn ngữ cảnh thực tế.
Ailoot Ultra · Biểu diễn nhúng POST /v1/embeddings voyage-code-3
voyage-code-3Bắt đầu
Voyage Code 3 tạo embedding cho truy xuất từ văn bản sang mã, từ mã sang mã và từ docstring sang mã. Cửa sổ 32 000 token, số chiều vector có thể chọn và đầu ra lượng tử hóa hỗ trợ tìm kiếm kho mã và chọn ngữ cảnh mã cho trợ lý lập trình.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- embedding
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Biểu diễn nhúng POST /v1/embeddings
- Đầu vào
text- Đầu ra
embedding
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn voyage-code-3 Điều kiện: Dùng bộ chọn mô hình Ailoot chính xác. | Mặc định— |
Trườnginput | Loạistring or array<string> | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Một văn bản hoặc danh sách văn bản; giữ lại một vectơ cùng chỉ số tương ứng cho mỗi mục dữ liệu được trả về. | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, input |
Tham sốoptional | Hợp đồng |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngGửi văn bản với mô hình đã chọn; giữ lại mọi vectơ được trả về và chỉ số tương ứng. |
Vòng đời: synchronous
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí Ailoot
Giá theo cấu hình
| Cấu hình | Biểu mức phí | Phí |
|---|---|---|
| Cấu hìnhĐơn giá token cơ bản | Biểu mức phíMức phí cơ bản | Phí Đầu vào · Token đầu vào $0.0004 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Biểu diễn nhúng
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "voyage-code-3",
"input": "The quick brown fox jumps over the lazy dog"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o embeddings.json
# Keep every data item and its index, the full usage object and response headers.
Nhận và lưu kết quả
Bí danh
Bí danh mô hình
Ailoot Ultra voyage-code-3
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Voyage AI: Voyage Code 3
- Có những đầu vào và kết quả nào?
POST /v1/embeddings·voyage-code-3:text→embedding- Yêu cầu sử dụng những trường nào?
POST /v1/embeddings·voyage-code-3:model,input