Criar uma tarefa de ajuste fino da CLU

Use este artigo para saber como configurar esses requisitos e criar um projeto.

Pré-requisitos

• Uma assinatura do Azure. Se você não tiver um, você pode criar um gratuitamente.
• Um recurso de linguagem de IA do Azure.

Criar um recurso de idioma

Antes de começar a usar o entendimento de linguagem conversacional (CLU), você precisa de um recurso de Linguagem de IA do Azure.

Nota

Você precisa ter uma função de Proprietário atribuída para o grupo de recursos para criar um recurso de idioma.

Criar um novo recurso a partir do portal do Azure

1. Entre no portal do Azure para criar um novo recurso de linguagem de IA do Azure.

2. Selecione Criar um novo recurso.

3. Na janela que aparece, procure por Serviço de idioma.

4. Selecione Criar.

5. Crie um recurso de idioma com as seguintes informações:

   Detalhe da instância	Valor obrigatório
   Região	Uma das regiões suportadas para o seu recurso de idioma.
   Nome	Nome obrigatório para o seu recurso de idioma.
   Escalão de preço	Um dos níveis de preços suportados para o seu recurso de idioma.

Criar um novo recurso de idioma a partir do Language Studio

Se for a primeira vez que inicia sessão, vê uma janela no Language Studio que pode utilizar para escolher um recurso de Idioma existente ou criar um novo. Você também pode criar um recurso selecionando o ícone de configurações no canto superior direito, selecionando Recursos e, em seguida, selecionando Criar um novo recurso.

Crie um recurso de idioma com as seguintes informações:

Detalhe da instância	Valor obrigatório
Subscrição do Azure	A sua subscrição do Azure.
Grupo de recursos do Azure	Seu grupo de recursos do Azure.
Nome do recurso do Azure	O nome do recurso de idioma.
Localização	Regiões suportadas para o seu recurso Idioma.
Escalão de preço	Níveis de preços suportados para o seu recurso de idioma.

Importante

• Certifique-se de habilitar a identidade gerenciada ao criar um recurso de idioma.
• Leia e confirme o aviso sobre a IA responsável.

Iniciar sessão no Language Studio

1. Aceda ao Language Studio e inicie sessão com a sua conta do Azure.

2. Na janela Escolha um recurso de idioma que aparece, localize sua assinatura do Azure e escolha seu recurso de idioma. Se não tiver um recurso, pode criar um novo.

   Detalhe da instância	Valor obrigatório
   Subscrição do Azure	A sua subscrição do Azure.
   Grupo de recursos do Azure	Seu nome de grupo de recursos do Azure.
   Nome do recurso do Azure	Seu nome de recurso do Azure.
   Localização	Uma das regiões suportadas para o seu recurso de idioma. Um exemplo é o West US 2.
   Escalão de preço	Um dos níveis de preços válidos para o seu recurso de idioma. Você pode usar a camada Gratuito (F0) para experimentar o serviço.

   

Criar um projeto de conversação

Depois de criar um recurso de idioma, crie um projeto CLU.

Azure AI Foundry

1. No Language Studio, localize a seção chamada Compreender perguntas e linguagem de conversação e selecione Compreensão de linguagem conversacional.

   

2. Quando a página Projetos de Compreensão de Linguagem de Conversação for aberta, selecione Criar novo projeto.

   

3. Para criar um novo projeto, forneça as seguintes informações:

   valor	Descrição
   Nome	Um nome para o seu projeto. Depois de criá-lo, o nome não pode ser alterado.
   Descrição	Descrição do projeto opcional.
   Enunciados língua principal	A língua principal do seu projeto. Seus dados de treinamento devem estar principalmente neste idioma.
   Ativar vários idiomas	Se você deseja habilitar seu projeto para suportar vários idiomas ao mesmo tempo.

4. Depois de terminar, selecione Criar. Agora deves ver a página inicial Introdução do teu projeto.

APIs REST

Envie uma PATCH solicitação usando a seguinte URL, cabeçalhos e corpo JSON para criar um novo projeto.

URL do Pedido

Use o seguinte URL ao criar sua solicitação de API. Substitua os valores padrão pelos seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto final para autenticar a sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.
Content-Type	application/merge-patch+json

Corpo

Use o exemplo JSON a seguir como seu corpo.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Chave	Marcador de Posição	valor	Exemplo
projectName	{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	EmailApp
language	{LANGUAGE-CODE}	Uma cadeia de caracteres que especifica o código de idioma para os enunciados usados em seu projeto. Se o seu projeto for multilingue, escolha o código de idioma da maioria das declarações.	en-us
multilingual	true	Um valor booleano que permite que você tenha documentos em vários idiomas em seu conjunto de dados. Quando o modelo é implantado, você pode consultá-lo em qualquer idioma suportado (não necessariamente incluído nos documentos de treinamento). Para saber mais sobre o suporte multilíngue, consulte Suporte a idiomas.	true

Importar um projeto

Azure AI Foundry

Você pode exportar um projeto CLU como um arquivo JSON a qualquer momento. Na página projetos de conversação, selecione um projeto e, no menu superior, selecione Exportar.

Você pode reimportar esse projeto como um novo projeto. Se você importar um projeto com exatamente o mesmo nome, ele substituirá os dados do projeto pelos dados do projeto recém-importado.

Se você tiver um aplicativo LUIS (Language Understanding) existente, poderá importar o JSON do aplicativo LUIS para a CLU diretamente. Ele cria um projeto de conversação com todas as peças que estão disponíveis no momento: intenções, entidades de aprendizado de máquina e enunciados. Para obter mais informações, consulte Migrar do Language Understanding (LUIS) para o Conversational Language Understanding (CLU).

Para importar um projeto, selecione o botão de seta ao lado de Criar um novo projeto e selecione Importar. Em seguida, selecione o ficheiro JSON LUIS ou CLU.

APIs REST

Você pode importar um JSON CLU para o serviço.

Envie uma POST solicitação usando a seguinte URL, cabeçalhos e corpo JSON para importar seu projeto.

URL do Pedido

Use o seguinte URL ao criar sua solicitação de API. Substitua os valores padrão pelos seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto final para autenticar a sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas e deve corresponder ao nome do projeto no arquivo JSON que você está importando.	EmailAppDemo
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo

O corpo JSON enviado é semelhante ao exemplo a seguir. Para obter mais informações sobre o objeto JSON, consulte a documentação de referência.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Chave	Marcador de Posição	valor	Exemplo
{API-VERSION}	A versão da API que você está chamando.	2023-04-01
projectName	{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	EmailAppDemo
language	{LANGUAGE-CODE}	Uma cadeia de caracteres que especifica o código de idioma para os enunciados usados em seu projeto. Se o seu projeto for multilingue, escolha o código de idioma da maioria das declarações.	en-us
multilingual	true	Um valor booleano que permite que você tenha documentos em vários idiomas em seu conjunto de dados. Quando o modelo é implantado, você pode consultá-lo em qualquer idioma suportado, incluindo idiomas que não estão incluídos em seus documentos de treinamento.	true
dataset	{DATASET}	Para obter informações sobre como dividir os seus dados entre um conjunto de teste e treinamento, consulte Rotule os seus enunciados no AI Foundry. Os valores possíveis para este campo são Train e Test.	Train

Após uma solicitação bem-sucedida, a resposta da API contém um operation-location cabeçalho com uma URL que você pode usar para verificar o status do trabalho de importação. O cabeçalho é formatado como este exemplo:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

Exportar um projeto

Azure AI Foundry

Você pode exportar um projeto CLU como um arquivo JSON a qualquer momento. Na página Projetos de conversação, selecione um projeto e, em seguida, selecione Exportar.

APIs REST

Você pode exportar um projeto CLU como um arquivo JSON a qualquer momento.

Crie uma POST solicitação usando a seguinte URL, cabeçalhos e corpo JSON para exportar seu projeto.

URL do Pedido

Use o seguinte URL ao criar sua solicitação de API. Substitua os valores padrão pelos seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto final para autenticar a sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	EmailApp
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Depois de enviar sua solicitação de API, você receberá uma 202 resposta que indica sucesso. Nos cabeçalhos de resposta, extraia o valor operation-location. O valor é formatado como este exemplo:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID é usado para identificar sua solicitação porque essa operação é assíncrona. Use essa URL para obter o JSON do projeto exportado usando o mesmo método de autenticação.

Obter detalhes do projeto CLU

Azure AI Foundry

1. Vá para a página Configurações do projeto no Language Studio.

2. Reveja os detalhes do seu projeto.

3. Nesta página, você pode atualizar a descrição do projeto e habilitar ou desabilitar o conjunto de dados multilíngue nas configurações do projeto.

4. Você também pode recuperar sua chave primária de recurso nesta página.

   

APIs REST

Para obter os detalhes do seu projeto, envie uma GET solicitação usando o seguinte URL e cabeçalhos. Substitua os valores padrão pelos seus próprios valores.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto final para autenticar a sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo da resposta

Depois de enviar o pedido, obtém a seguinte resposta:

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

Depois de enviar sua solicitação de API, você recebe uma 200 resposta que indica sucesso e inclui um corpo de resposta JSON com os detalhes do projeto.

Eliminar um projeto

Azure AI Foundry

Quando você não precisar mais do seu projeto, poderá usar o Language Studio para excluir seu projeto. No painel esquerdo, selecione Projetos, selecione o projeto que deseja excluir e selecione Excluir no menu superior.

APIs REST

Quando você não precisa mais do seu projeto, você pode usar as APIs para excluir seu projeto.

Crie uma DELETE solicitação usando a seguinte URL, cabeçalhos e corpo JSON para excluir um projeto de compreensão de linguagem conversacional.

URL do Pedido

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto final para autenticar a sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Depois de enviar sua solicitação de API, você recebe uma 202 resposta que indica sucesso, o que significa que seu projeto foi excluído.

Conteúdo relacionado

• Criar o esquema