Partilhar via


Guia de início rápido: deteção de material protegido para texto

O recurso Material protegido para texto fornece uma solução abrangente para gerenciar riscos associados ao conteúdo gerado por IA (somente conteúdo em inglês). Ao detetar e impedir a exibição de material protegido, as organizações podem garantir a conformidade com as leis de propriedade intelectual, manter a originalidade do conteúdo e proteger suas reputações. Material protegido refere-se a conteúdo que corresponde a texto conhecido de fontes protegidas por direitos autorais, como letras de músicas, artigos, receitas ou outro conteúdo da Web selecionado.

Os principais objetivos do recurso Deteção de material protegido para texto para conteúdo gerado por IA são:

  • Para detetar e impedir a exibição de conteúdo protegido gerado por modelos de IA.
  • Para permitir que as organizações gerenciem os riscos associados ao conteúdo gerado por IA.
  • Para garantir que o conteúdo gerado por IA esteja em conformidade com as diretrizes legais, éticas e de política de conteúdo.

Para obter mais informações sobre a deteção de material protegido, consulte a página Conceito de deteção de material protegido. Para limites de entrada da API, consulte a seção Requisitos de entrada da Visão geral.

Pré-requisitos

  • Uma assinatura do Azure - Crie uma gratuitamente
  • Depois de ter sua assinatura do Azure, crie um recurso de Segurança de Conteúdo no portal do Azure para obter sua chave e ponto de extremidade. Introduza um nome exclusivo para o seu recurso, selecione a sua subscrição e selecione um grupo de recursos, uma região suportada (consulte Disponibilidade da região) e um escalão de preços suportado. Depois, selecione Criar.
    • O recurso leva alguns minutos para ser implantado. Depois que terminar, selecione ir para recurso. No painel esquerdo, em Gerenciamento de Recursos, selecione Chave de Assinatura e Ponto de Extremidade. O ponto de extremidade e qualquer uma das chaves são usados para chamar APIs.
  • cURL instalado

Analise o texto para deteção de material protegido

A seção a seguir percorre uma solicitação de exemplo com cURL. Cole o comando abaixo em um editor de texto e faça as seguintes alterações.

  1. Substitua <endpoint> pela URL do ponto de extremidade associada ao seu recurso.
  2. Substitua <your_subscription_key> por uma das chaves que acompanham o recurso.
  3. Opcionalmente, substitua o "text" campo no corpo pelo seu próprio texto que você gostaria de analisar.

    Gorjeta

    Consulte Requisitos de entrada para limitações de comprimento máximo de texto. A deteção de material protegido destina-se a ser executada em finalizações LLM, não em prompts do usuário.

curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'

Os campos abaixo devem ser incluídos no url:

Nome Necessário? Description Type
Versão da API Necessário Esta é a versão da API a ser verificada. A versão atual é: api-version=2024-09-01. Exemplo: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 String

Os parâmetros no corpo da solicitação são definidos nesta tabela:

Nome Necessário? Description Type
texto Necessário Este é o texto bruto a ser verificado. Outros caracteres não-ascii podem ser incluídos. String

Consulte o seguinte corpo de solicitação de exemplo:

{
  "text": "string"
}

Abra uma janela de prompt de comando e execute o comando cURL.

Interpretar a resposta da API

Você deve ver os resultados da deteção de material protegido exibidos como dados JSON na saída do console. Por exemplo:

{
  "protectedMaterialAnalysis": {
    "detected": true
  }
}

Os campos JSON na saída são definidos aqui:

Nome Descrição Type
protectedMaterialAnalysis Cada classe de saída que a API prevê. String
detetada Se o material protegido foi detetado ou não. Boolean

Clean up resources (Limpar recursos)

Se quiser limpar e remover uma assinatura de serviços do Azure AI, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos associados a ele.