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

js
Summarizer.create()
Summarizer.create(options)

Tham số

options Optional

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 cho Summarizer, hoặc context được chỉ định trong lần gọi summarize() hoặc summarizeStreaming()), 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ạng vă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ài tươ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ố CreateMonitor cho 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.

sharedContext

Một chuỗi sharedContext mô 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úp Summarizer tạ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ác create() thông qua AbortController được liên kết. Hiệu ứng chính xác phụ thuộc vào thời điểm AbortController.abort() được gọi:

  • Nếu abort() được gọi trước khi promise create() được giải quyết, thao tác create() sẽ bị hủy bỏ.
  • Nếu abort() được gọi sau khi promise create() hoàn thành, nó có tác dụng tương tự như việc gọi Summarizer.destroy(): Các tài nguyên được gán cho thực thể Summarizer kết quả sẽ được giải phóng, và mọi lần gọi phương thức Summarizer đang diễn ra và tiếp theo sẽ bị từ chối với một AbortError.
type

Một giá trị liệt kê chỉ định loại bản tóm tắt bạn muốn Summarizer nà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ệ

NotAllowedError DOMException

Được ném ra nếu việc sử dụng Summarizer API bị chặn bởi summarizer Permissions-Policy.

NotSupportedError DOMException

Được ném ra nếu bất kỳ thẻ ngôn ngữ nào được chỉ định trong expectedContextLanguages, expectedInputLanguages, hoặc outputLanguage không hợp lệ hoặc không được hỗ trợ.

OperationError DOMException

Ngoại lệ đa năng được ném ra nếu việc tạo Summarizer thất bại vì bất kỳ lý do nào khác.

Ví dụ

Tạo Summarizer cơ bản

js
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