Summarizer: phương thức tĩnh create()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức tĩnh create() của giao diện Summarizer tạo một thực thể Summarizer mới để tạo bản tóm tắt.
Note:
Phương thức create() yêu cầu kích hoạt nhất thời, tức là nó phải được gọi để phản hồi một hành động của người dùng như nhấp chuột hoặc nhấn nút.
Cú pháp
Summarizer.create()
Summarizer.create(options)
Tham số
optionsOptional-
Một đối tượng xác định các tùy chọn cấu hình cho
Summarizer. Các giá trị có thể bao gồm:expectedInputLanguages-
Một mảng các chuỗi chỉ định các ngôn ngữ dự kiến của văn bản đầu vào, phải là thẻ ngôn ngữ BCP 47 hợp lệ. Mặc định là
["en"]. expectedContextLanguages-
Một mảng các chuỗi chỉ định các ngôn ngữ dự kiến của bất kỳ chuỗi ngữ cảnh nào được cung cấp (hoặc
sharedContextđược truyền choSummarizer, hoặccontextđược chỉ định trong lần gọisummarize()hoặcsummarizeStreaming()), phải là thẻ ngôn ngữ BCP 47 hợp lệ. Mặc định là["en"]. format-
Một giá trị liệt kê chỉ định
định dạngvăn bản bạn muốn các bản tóm tắt được trả về. Mặc định làmarkdown. length-
Một giá trị liệt kê chỉ định
độ dàitương đối cho các bản tóm tắt được tạo. Mặc định làshort. monitor-
Một hàm callback với tham số
CreateMonitorcho phép theo dõi tiến trình tải xuống của mô hình AI. outputLanguage-
Một chuỗi chỉ định ngôn ngữ dự kiến của các bản tóm tắt được tạo bởi
Summarizer, phải là thẻ ngôn ngữ BCP 47 hợp lệ. Mặc định làen. -
Một chuỗi
sharedContextmô tả ngữ cảnh mà các đoạn văn bản cần tóm tắt đang được sử dụng trong đó, giúpSummarizertạo ra các bản tóm tắt phù hợp hơn. signal-
Một thực thể đối tượng
AbortSignal, cho phép hủy bỏ thao táccreate()thông quaAbortControllerđược liên kết. Hiệu ứng chính xác phụ thuộc vào thời điểmAbortController.abort()được gọi:- Nếu
abort()được gọi trước khi promisecreate()được giải quyết, thao táccreate()sẽ bị hủy bỏ. - Nếu
abort()được gọi sau khi promisecreate()hoàn thành, nó có tác dụng tương tự như việc gọiSummarizer.destroy(): Các tài nguyên được gán cho thực thểSummarizerkết quả sẽ được giải phóng, và mọi lần gọi phương thứcSummarizerđang diễn ra và tiếp theo sẽ bị từ chối với mộtAbortError.
- Nếu
type-
Một giá trị liệt kê chỉ định
loạibản tóm tắt bạn muốnSummarizernày tạo. Mặc định làkey-points.
Giá trị trả về
Một Promise được giải quyết với một thực thể đối tượng Summarizer.
Ngoại lệ
NotAllowedErrorDOMException-
Được ném ra nếu việc sử dụng Summarizer API bị chặn bởi
summarizerPermissions-Policy. NotSupportedErrorDOMException-
Được ném ra nếu bất kỳ thẻ ngôn ngữ nào được chỉ định trong
expectedContextLanguages,expectedInputLanguages, hoặcoutputLanguagekhông hợp lệ hoặc không được hỗ trợ. OperationErrorDOMException-
Ngoại lệ đa năng được ném ra nếu việc tạo
Summarizerthất bại vì bất kỳ lý do nào khác.
Ví dụ
>Tạo Summarizer cơ bản
const summarizer = await Summarizer.create({
sharedContext:
"A general summary to help a user decide if the text is worth reading",
type: "tldr",
length: "short",
format: "markdown",
expectedInputLanguages: ["en-US"],
outputLanguage: "en-US",
});
Thông số kỹ thuật
| Specification |
|---|
| Writing Assistance APIs> # dom-summarizer-create> |
Tương thích trình duyệt
Xem thêm
- Sử dụng Summarizer API
- Web AI demos trên chrome.dev