Summarizer

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

Summarizer 介面是 Summarizer API 的一部分,包含了該 API 的所有功能,包括檢查 AI 模型可用性、建立新的 Summarizer 例項、使用它生成新的摘要等。

例項屬性

expectedContextLanguages 只讀 實驗性

上下文字串應使用的語言。

expectedInputLanguages 只讀 實驗性

Summarizer 應支援的語言。

format 只讀 實驗性

摘要將返回的文字格式。

inputQuota 只讀 實驗性

瀏覽器用於生成摘要的可用輸入配額。

length 只讀 實驗性

生成的摘要的相對長度。

outputLanguage 只讀 實驗性

應生成摘要的語言。

sharedContext 只讀 實驗性

描述待摘要文字所處上下文的文字字串,這有助於 Summarizer 生成更合適的摘要。

type 只讀 實驗性

Summarizer 將生成的摘要型別。

靜態方法

availability() 實驗性

返回一個列舉值,指示瀏覽器 AI 模型是否支援給定的 Summarizer 配置。

create() 實驗性

建立新的 Summarizer 例項以用於生成摘要。

例項方法

destroy() 實驗性

銷燬被呼叫的 Summarizer 例項。

measureInputUsage() 實驗性

報告給定文字輸入進行摘要操作將使用多少輸入配額。

summarize() 實驗性

生成新的摘要字串。

summarizeStreaming() 實驗性

將新摘要生成為 ReadableStream

示例

有關完整示例,請參閱 使用 Summarizer API

建立 Summarizer 例項

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",
});

生成摘要

js
const summary = await summarizer.summarize(myTextString);
console.log(summary);

生成摘要流

js
const stream = summarizer.summarizeStreaming(myTextString);
let summary = "";

for await (const chunk of stream) {
  summary += chunk;
}

console.log("Stream complete");
summaryOutput.textContent = summary;

規範

規範
寫作輔助 API
# summarizer

瀏覽器相容性

另見