Language: tarefa de anotação de texto

A tarefa Language - Annotate Text permite executar várias operações de linguagem natural, como, análise de sentimento, análise de entidade e análise sintática em um texto específico usando o Cloud Natural Language.

Antes de começar

Execute as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Language - Annotate Text:

  1. Ative a API Cloud Natural Language (language.googleapis.com).

    Ativar a API Cloud Natural Language

  2. Criar um perfil de autenticação. A integração da Apigee usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Language - Annotate Text.

    Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

Configurar a tarefa "Language - Annotate Text"

  1. Na IU da Apigee, selecione sua organização da Apigee.
  2. Clique em Desenvolver > Integrações.
  3. Selecione uma integração existente ou clique em Criar integração.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
    2. Selecione uma Região para a integração na lista de regiões compatíveis.
    3. Clique em Criar.

    Isso abre a integração na página do designer de integração.

  4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para ver a lista de tarefas disponíveis.
  5. Clique e coloque o elemento Language - Annotate Text no designer de integração.
  6. Clique no elemento Language - Annotate Text no designer para ver o painel de configurações de idioma Language - Annotate Text.
  7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

    Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

  8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

    As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Language - Annotate Text:

Propriedade Tipo de dados Descrição
Região String Região em que você quer executar a operação de anotação. Por exemplo, us-central1.
ProjectsId String É o ID do seu projeto no Google Cloud.
Solicitação JSON Consulte Estrutura de solicitação JSON. Consulte Operações do Natural Language compatíveis para mais informações.

Saída da tarefa

A tarefa Language - Annotate Text retorna a saída da resposta, dependendo das operações realizadas. Veja a seguir um exemplo de saída quando for realizada a análise sintática: 

{
    "sentences": [
        ... Array of sentences with sentence information
    ],
    "tokens": [
        ... Array of tokens with token information
    ]
}

Operações do Natural Language compatíveis

A tarefa Language - Annotate Text permite realizar as seguintes operações do Natural Language:

Análise de sentimento
Use a análise de sentimento para identificar e determinar a atitude emocional (positiva, negativa ou neutra) de um determinado texto. Para realizar essa operação, defina o campo extractDocumentSentiment do JSON de solicitação como true.
Análise de entidades
Use a análise de entidade para inspecionar e recuperar entidades, como substantivos próprios e substantivos comuns de um determinado texto. Para realizar essa operação, defina o campo extractEntities do JSON de solicitação como true.
Análise sintática
Use a análise sintática para extrair informações linguísticas de um determinado texto. Para realizar essa operação, defina o campo extractSyntax do JSON de solicitação como true.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

A seguir

  1. Adicione bordas e condições de borda.
  2. Teste e publique sua integração.
  3. Configure um gatilho.
  4. Adicione uma tarefa de mapeamento de dados.
  5. Confira todas as tarefas para os serviços do Google Cloud.