Resumir com a IA integrada

Thomas Steiner

Publicado em 11 de novembro de 2024

Explicação	Web	Extensões	Status do Chrome	Intenção
GitHub	Teste do Origin	Teste do Origin	Ver	Intenção de fazer um experimento

Imagine que você pudesse oferecer aos seus usuários a capacidade de resumir artigos longos, documentos complexos ou até mesmo conversas de chat animadas em resumos concisos e inteligentes.

A API Summarizer pode ser usada para gerar diferentes tipos de resumos em diversos comprimentos e formatos, como frases, parágrafos, listas com marcadores e muito mais. Acreditamos que essa API é útil nos seguintes cenários:

• Resumir os pontos principais de um artigo ou de uma conversa no chat.
• Sugerir títulos e cabeçalhos para artigos.
• Criar um resumo conciso e informativo de um texto longo.
• Gerar um teaser para um livro com base em uma resenha.

Observação: participe do programa de pré-lançamento para conferir as novas APIs de IA integradas e participar da discussão na nossa lista de e-mails.

Primeiros passos

Participe do teste de origem da API Summarizer, que vai do Chrome 131 ao Chrome 136. Os testes de origem permitem que você ofereça o recurso a usuários reais na sua origem, no Chrome.

Inscrever-se no teste de origem

Para começar a usar a API Summarizer, siga estas etapas:

1. Confirme que você leu e aceitou a Política de uso proibido da IA generativa do Google.
2. Acesse o teste de origem da API Summarizer.
3. Clique em Registrar e preencha o formulário.
   • No campo Origem da Web, informe o ID da origem ou da extensão, chrome-extension://YOUR_EXTENSION_ID.
4. Para enviar, clique em Registrar.
5. Copie o token fornecido e adicione-o a todas as páginas da Web na origem ou no arquivo da extensão em que você quer ativar o teste.
   • Se você estiver criando uma extensão, siga as instruções do teste de origem de extensões.
6. Comece a usar a API Summarizer.

Saiba mais sobre como começar a usar os testes de origem.

Observação: há limites de uso durante o teste de origem. No entanto, ainda é possível integrar esses recursos para testar em tempo real e coletar feedback dos usuários. Seu feedback sobre os resultados dos testes informa as iterações futuras dessa API, à medida que trabalhamos para ampliar a disponibilidade.

Limitações durante o teste de origem

Durante o teste de origem, a API Summarizer só oferece suporte a resumos de textos em inglês, já que a qualidade do modelo foi testada apenas em conteúdo em inglês. Nossa intenção é remover essa limitação depois de testar outros idiomas para garantir a qualidade e a segurança, e a API estiver disponível para todos.

Adicionar suporte ao localhost

Para acessar a API Summarizer em localhost durante o teste de origem, você precisa ter o Chrome Canary. Em seguida, siga estas etapas:

1. Acesse chrome://flags/#summarization-api-for-gemini-nano.
2. Selecione Ativado.
3. Clique em Reiniciar ou reinicie o Chrome.

Usar a API Summarizer

Primeiro, execute a detecção de recursos para saber se o navegador oferece suporte à API Summarizer.

if ('ai' in self && 'summarizer' in self.ai) {
  // The Summarizer API is supported.
}

Download do modelo

A API Summarizer usa um modelo de IA poderoso treinado para gerar resumos de alta qualidade. Embora a API esteja integrada ao Chrome, o modelo é transferido por download separadamente na primeira vez que um site usa a API.

Para determinar se o modelo está pronto para uso, chame a função ai.summarizer.capabilities() assíncrona. Ele retorna um objeto AISummarizerCapabilities com um campo available que pode ter três valores possíveis:

• no: o navegador atual oferece suporte à API Summarizer, mas ela não pode ser usada no momento. Isso pode acontecer por vários motivos, como espaço em disco insuficiente para fazer o download do modelo.
• readily: o navegador atual oferece suporte à API Summarizer e pode ser usado imediatamente.
• after-download: o navegador atual oferece suporte à API Summarizer, mas precisa fazer o download do modelo primeiro.

Para acionar o download do modelo e criar o resumo, chame a função ai.summarizer.create() assíncrona. Se a resposta para capabilities() foi after-download, a prática recomendada é detectar o progresso do download. Dessa forma, é possível informar o usuário caso o download demore.

const summarizer = await ai.summarizer.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded} of ${e.total} bytes.`);
    });
  }
});

Funções da API

A função create() permite configurar um novo objeto de resumo de acordo com suas necessidades. Ele usa um objeto options opcional com os seguintes parâmetros:

• sharedContext: contexto compartilhado adicional que pode ajudar o resumidor.
• type: o tipo de resumo, com os valores permitidos key-points (padrão), tl;dr, teaser e headline.
• format: o formato da síntese, com os valores permitidos markdown (padrão) e plain-text.
• length: o comprimento da síntese, com os valores permitidos short, medium (padrão) e long. O significado desses comprimentos varia de acordo com o type solicitado. Por exemplo, na implementação do Chrome, um resumo curto de pontos-chave consiste em três tópicos e um resumo curto é uma frase. Um resumo longo de pontos-chave tem sete tópicos e um resumo longo é um parágrafo.

Observação: depois de definidos, os parâmetros não podem ser alterados. Crie um novo objeto resumidor se precisar fazer modificações nos parâmetros.

O exemplo a seguir demonstra como inicializar o resumidor.

const options = {
  sharedContext: 'This is a scientific article',
  type: 'key-points',
  format: 'markdown',
  length: 'medium',
};

const available = (await self.ai.summarizer.capabilities()).available;
let summarizer;
if (available === 'no') {
  // The Summarizer API isn't usable.
  return;
}
if (available === 'readily') {
  // The Summarizer API can be used immediately .
  summarizer = await self.ai.summarizer.create(options);
} else {
  // The Summarizer API can be used after the model is downloaded.
  summarizer = await self.ai.summarizer.create(options);
  summarizer.addEventListener('downloadprogress', (e) => {
    console.log(e.loaded, e.total);
  });
  await summarizer.ready;
}

Executar o resumo

Há duas maneiras de executar o resumo: streaming e não streaming.

Resumo sem streaming

Com a síntese sem streaming, o modelo processa a entrada como um todo e produz a saída.

Para receber um resumo sem streaming, chame a função summarize() assíncrona do resumidor. O primeiro argumento da função é o texto que você quer resumir. O segundo argumento opcional é um objeto com um campo context. Esse campo permite adicionar detalhes de contexto que podem melhorar a síntese.

const longText = document.querySelector('article').innerHTML;
const summary = await summarizer.summarize(longText, {
  context: 'This article is intended for a tech-savvy audience.',
});

Dica: ao resumir o conteúdo, é melhor remover dados desnecessários, como marcação HTML. Para o conteúdo presente na página, use a propriedade innerText de um elemento HTML com o texto de destino, já que ela representa apenas o conteúdo de texto renderizado de um elemento e seus descendentes.

Resumo de streaming

A síntese de streaming oferece resultados em tempo real. A saída é atualizada continuamente à medida que a entrada é adicionada e ajustada.

Para receber um resumo de streaming, chame a função summarizeStreaming() do resumidor. Em seguida, itere sobre os segmentos de texto disponíveis no stream.

let result = '';
let previousChunk = '';
for await (const chunk of stream) {
  const newChunk = chunk.startsWith(previousChunk)
      ? chunk.slice(previousChunk.length) : chunk;
  console.log(newChunk);
  result += newChunk;
  previousChunk = chunk;
}
console.log(result);

summarizeStreaming() retorna um ReadableStream, em que os segmentos de resposta são criados sucessivamente. Isso significa que cada resposta contém o resumo completo gerado até aquele ponto, não apenas o próximo segmento, que não é o comportamento pretendido.

Pretendemos nos alinhar a outras APIs de streaming na plataforma, em que os segmentos são partes sucessivas de um único stream longo. Por enquanto, para alcançar o comportamento desejado, implemente o seguinte:

let result = '';
let previousLength = 0;
for await (const segment of stream) {
  const newContent = segment.slice(previousLength);
  console.log(newContent);
  previousLength = segment.length;  
  result += newContent;
}
console.log(result);

Demonstração

Teste a API Summarizer no Summarizer API Playground.

Esforço de padronização

Estamos trabalhando para padronizar a API Summarizer e garantir a compatibilidade entre navegadores.

Nossa proposta de API recebeu apoio da comunidade e foi transferida para o Grupo da comunidade do Incubator da Web do W3C para mais discussões. A equipe do Chrome solicitou feedback do W3C Technical Architecture Group e pediu à Mozilla e ao WebKit as posições dos padrões.

Participar e compartilhar feedback

Comece a testar a API Summarizer agora mesmo participando do teste de origem e compartilhe seu feedback. Sua contribuição pode afetar diretamente a forma como criamos e implementamos versões futuras dessa API e de todas as APIs de IA integradas.

• Para enviar feedback sobre a implementação do Chrome, envie um relatório de bug ou uma solicitação de recurso.
• Discuta o design da API Summarizer no GitHub comentando em um problema existente ou abrindo um novo.
• Participe do esforço de padronização entrando no grupo da comunidade do Web Incubator.