Voyage AI: Voyage Code 2
Voyage Code 2 tạo embedding cho mã nguồn và văn bản liên quan để tìm kiếm ngữ nghĩa trong kho mã. Câu hỏi bằng ngôn ngữ tự nhiên, đoạn mã hoặc truy vấn kết hợp có thể truy xuất phần triển khai liên quan; phiên bản này dùng cửa sổ ngữ cảnh 16 000 token và vector 1 536 chiều.
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 2 tạo embedding số cho mã nguồn và văn bản liên quan. Mô hình được thiết kế để truy xuất mã theo ngữ nghĩa: nhà phát triển mô tả hành vi hoặc cung cấp đoạn mã, rồi hệ thống tìm kiếm tìm phần triển khai liên quan. Ví dụ của nhà sản xuất bao gồm câu hỏi bằng ngôn ngữ tự nhiên, đoạn mã và kết hợp cả hai làm đầu vào tìm kiếm.
Dùng mô hình để xây dựng trải nghiệm tìm kiếm kho mã xoay quanh câu hỏi phát triển thực tế. Nhà phát triển có thể tìm thủ tục chỉ xóa ký tự khớp đầu tiên và cuối cùng, hoặc phần dự án áp dụng một cách duyệt cây cụ thể. Chuẩn bị truy vấn diễn đạt chính xác hành vi, gồm điều kiện phân biệt phần triển khai cần tìm với một phần gần giống nhưng không đúng.
Lập chỉ mục mã theo đơn vị hữu ích, thay vì chia mọi tệp tại số ký tự tùy ý. Giữ chữ ký hàm, thân hàm và phần giải thích liên quan cùng nhau. Khi hàm hỗ trợ phụ thuộc vào kiểu hoặc hằng cục bộ, giữ đủ văn bản xung quanh để hiểu mục đích của nó. Lưu đường dẫn tệp, phiên bản kho mã và vị trí nguồn bên ngoài embedding để kết quả mở trực tiếp mã gốc.
Phiên bản này có cửa sổ ngữ cảnh 16 000 token và tạo embedding 1 536 chiều. Xác định kích thước chỉ mục vector theo biểu diễn này và giữ embedding truy vấn, tài liệu gắn với cùng mô hình. Tập đã lập chỉ mục bằng Voyage Code 2 có thể giữ biểu diễn truy xuất nhất quán trong khi các bản ghi nguồn được cập nhật. Chuyển sang phiên bản embedding khác cần được coi là di chuyển chỉ mục, với đối chiếu rõ ràng trên cùng kho mã.
Với truy vấn ngôn ngữ tự nhiên, mô tả thao tác, đầu vào và kết quả liên quan. Với truy vấn mã, đưa vào đoạn có logic cần đối chiếu và giải thích mọi điều kiện quan trọng với tìm kiếm. Chẳng hạn, khi tìm phần xử lý thử lại, có thể chỉ rõ mã thử lại sau khi hết thời gian chờ hay sau một phản hồi lỗi hoàn chỉnh. Cần kiểm tra nguồn truy xuất được theo sự khác biệt này trước khi dùng để sửa mã.
Giữ khả năng truy về nguồn của tài liệu và mã nguồn khi lập chỉ mục cả hai. Đoạn giải thích có thể là ngữ cảnh hữu ích, còn phần triển khai là sản phẩm nhà phát triển cần kiểm tra. Gắn nhãn các kiểu bản ghi này để trang tìm kiếm hiển thị đúng đích đến và trợ lý lập trình phân biệt mô tả với mã nguồn thực thi.
Dùng các đoạn truy xuất được làm ngữ cảnh để điều hướng kho mã, tìm phần triển khai hoặc phục vụ bước tiếp theo của trợ lý lập trình. Giữ trọn đoạn liên quan và vị trí khi chuyển tiếp. Độ tương đồng giúp tìm mã ứng viên; xem xét đầu vào thực tế, tác động phụ và các điều kiện ràng buộc quyết định ứng viên có giải quyết vấn đề hiện tại không.
Đánh giá truy xuất trên tập câu hỏi thực tế có câu trả lời nguồn đã biết. Bao gồm hàm đã đổi tên, chú thích gây nhầm lẫn, tiện ích tương tự nhưng khác trường hợp biên và truy vấn dùng từ không có trong mã. Kiểm tra phần triển khai mong đợi có xuất hiện trong các kết quả hữu ích không, và đoạn hiển thị có đủ ngữ cảnh để đánh giá không. Giữ những câu hỏi này khi kho mã tăng trưởng để đối chiếu thay đổi ở trích xuất, ranh giới đoạn hoặc lập chỉ mục trên cùng nhiệm vụ.
Ailoot Ultra · Biểu diễn nhúng POST /v1/embeddings voyage-code-2
voyage-code-2Bắt đầu
Voyage Code 2 tạo embedding cho mã nguồn và văn bản liên quan để tìm kiếm ngữ nghĩa trong kho mã. Câu hỏi bằng ngôn ngữ tự nhiên, đoạn mã hoặc truy vấn kết hợp có thể truy xuất phần triển khai liên quan; phiên bản này dùng cửa sổ ngữ cảnh 16 000 token và vector 1 536 chiều.
- Đầ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-2 Đ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-2",
"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-2
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 2
- Có những đầu vào và kết quả nào?
POST /v1/embeddings·voyage-code-2:text→embedding- Yêu cầu sử dụng những trường nào?
POST /v1/embeddings·voyage-code-2:model,input