Cognitive Services são uma coleção de APIs desenvolvidas pela Microsoft que permitem adicionar recursos inteligentes às suas aplicações, como visão computacional, reconhecimento de fala, análise de texto, entre outros. Estes serviços são extremamente importantes para desenvolvedores que desejam incorporar inteligência artificial em suas soluções de forma rápida e eficiente. No ambiente Windows, é possível utilizar essas APIs através de scripts em PowerShell, que é uma ferramenta poderosa e versátil para automação e gerenciamento de sistemas.

Exemplos:

1. Configuração Inicial:

   • Primeiro, você precisa de uma chave de API e um endpoint do Cognitive Services. Você pode obter isso através do portal Azure.
   • Instale o módulo Azure no PowerShell, caso ainda não tenha feito:

     Install-Module -Name Az -AllowClobber -Force

2. Exemplo de Uso - Análise de Sentimento:

   • Vamos criar um script PowerShell para analisar o sentimento de um texto usando a API de Text Analytics.

     
     # Defina as variáveis de chave de API e endpoint
     $apiKey = "sua-chave-de-api"
     $endpoint = "seu-endpoint"

   Texto a ser analisado

   $text = "Eu estou muito feliz com o serviço!"

   Monta o corpo da requisição

   $body = @{ documents = @( @{ language = "pt" id = "1" text = $text } ) } | ConvertTo-Json

   Faz a requisição à API de Text Analytics

   $response = Invoke-RestMethod -Method Post -Uri "$endpoint/text/analytics/v3.0/sentiment" -ContentType "application/json" -Headers @{ "Ocp-Apim-Subscription-Key" = $apiKey } -Body $body

   Exibe o resultado

   $response.documents

3. Exemplo de Uso - Reconhecimento de Imagens:

   • Vamos criar um script PowerShell para reconhecer objetos em uma imagem usando a API de Computer Vision.

     
     # Defina as variáveis de chave de API e endpoint
     $apiKey = "sua-chave-de-api"
     $endpoint = "seu-endpoint"

   URL da imagem a ser analisada

   $imageUrl = "https://exemplo.com/sua-imagem.jpg"

   Monta o corpo da requisição

   $body = @{ url = $imageUrl } | ConvertTo-Json

   Faz a requisição à API de Computer Vision

   $response = Invoke-RestMethod -Method Post -Uri "$endpoint/vision/v3.0/analyze?visualFeatures=Description" -ContentType "application/json" -Headers @{ "Ocp-Apim-Subscription-Key" = $apiKey } -Body $body

   Exibe o resultado

   $response.description.captions