Thực hiện tìm kiếm ngữ nghĩa trên Document
.
Yêu cầu HTTP
POST https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/documents/*}:query
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
name |
Bắt buộc. Tên của |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"query": string,
"resultsCount": integer,
"metadataFilters": [
{
object ( |
Các trường | |
---|---|
query |
Bắt buộc. Chuỗi truy vấn để thực hiện tìm kiếm ngữ nghĩa. |
resultsCount |
Không bắt buộc. Số lượng Nếu không chỉ định, hệ thống sẽ trả về tối đa 10 |
metadataFilters[] |
Không bắt buộc. Lọc siêu dữ liệu Lưu ý: Không hỗ trợ lọc ở cấp độ Cụm từ tìm kiếm ví dụ: (năm >= 2020 HOẶC năm < 2010) AND (thể loại = kịch OR thể loại = hành động) Danh sách đối tượng Truy vấn mẫu cho một dải giá trị dạng số: (năm > 2015 VÀ năm <= 2020) Danh sách đối tượng Lưu ý: "AND" cho cùng một khoá chỉ được hỗ trợ cho giá trị số. Giá trị chuỗi chỉ hỗ trợ "OR" cho cùng một khoá. |
Nội dung phản hồi
Phản hồi từ documents.query
chứa danh sách các đoạn có liên quan.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"relevantChunks": [
{
object ( |
Các trường | |
---|---|
relevantChunks[] |
Các đoạn có liên quan được trả về. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
Để biết thêm thông tin, hãy xem bài viết Tổng quan về xác thực.