Configurar seu ambiente

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:
  • Criar uma conta dos serviços da Einstein Platform.
  • Gerar um token de acesso JWT para chamar a API.

Obter uma conta dos serviços da Einstein Platform

Antes de poder acessar as APIs de serviço da Einstein Platform, crie primeiro uma conta e faça download da chave. Você pode pular esta etapa se já tem uma conta e uma chave.

Se você já concluiu o projeto Início rápido: Einstein Image Classification ou o projeto Criar um aplicativo de resgate de felinos que reconhece raças de felinos, já deve ter uma conta e uma chave.

Ao se inscrever para uma conta, você deverá fazer login na sua organização Salesforce. Para este módulo, você usa o nome de usuário e a senha da sua organização Trailhead Playground (TP). Se você não sabe o que é uma organização Trailhead Playground ou precisa encontrar seu nome de usuário e a senha, confira o módulo Gerenciamento do Trailhead Playground.

Depois de fazer login, você será solicitado a permitir que a página de inscrição acesse informações na sua organização Salesforce. O acesso permite que a página de inscrição recupere algumas informações básicas, como ID, perfil, email, endereço e telefone. Depois que a sua conta é criada, você pode baixar a chave.

  1. Navegue até a página de inscrição em https://api.einstein.ai/signup.
    Aviso

    Aviso

    Verifique se você está desconectado do Salesforce antes de percorrer as etapas para obter uma conta. Assim, você pode ter certeza de que está dando acesso à organização Salesforce correta na hora de se inscrever.

  2. Clique em Inscrever-se usando o Salesforce.
    A página de inscrição nos serviços da Einstein Platform.
  3. Na página de login do Salesforce, digite o nome de usuário e a senha do seu Trailhead Playground e clique em Efetuar login.
    A página de login do Salesforce.
  4. Clique em Permitir para que a página possa acessar informações básicas, como seu endereço de email, e fazer solicitações.
    A página que solicita acesso à sua organização Salesforce.
  5. Na página de ativação, clique em Fazer download da chave para salvar a chave localmente. O arquivo da chave é chamado de einstein_platform.pem. Se você não consegue fazer o download, corte e cole a chave do navegador em um arquivo de texto e salve como einstein_platform.pem.
    A página onde você faz download da sua chave privada.

Instalar cURL

A cURL é uma ferramenta de linha de comando gratuita usada para obter ou enviar dados usando a sintaxe das URLs. Ela é útil ao se trabalhar com pontos de extremidade REST. Você usará cURL neste módulo para fazer chamadas à API do Einstein Intent.

Se você já tem a cURL instalada, pode pular esta etapa. Os sistemas operacionais Linux e Mac OSX têm cURL instalada por padrão, mas se você usa Windows, terá que instalá-la por conta própria.

Para instalar a cURL, acesse https://curl.haxx.se/download.html. Baixe e instale a versão do seu sistema operacional.

Gerar um token

As APIs de serviços da Einstein Platform usam fluxo de token do portador JWT OAuth 2.0 para autorização. Isso significa que você precisa ter um token válido em cada chamada feita à API.
Ao chamar a API no código, você precisará escrever código para gerar o token de acesso. Neste módulo, use a interface do usuário da página da Web do token para gerar um token.
  1. No seu navegador, acesse a página do token em https://api.einstein.ai/token.
  2. Digite seu endereço de email. Esse é o endereço de email associado ao seu usuário na organização Trailhead Playground conectada quando você se inscreveu para uma conta. Use seu endereço de email, não o nome do usuário do Trailhead Playground.
  3. Clique em Escolher arquivo ou em Procurar e navegue até o arquivo einstein_platform.pem baixado quando você se inscreveu para uma conta.
  4. Defina a Expiração em minutos como 90. O token expirará depois de 90 minutos, tempo suficiente para concluir este módulo. Se quiser que seu token tenha uma validade maior, aumente o número de minutos.
  5. Clique em Obter chave e salve o token em um arquivo de texto ou outro lugar em que possa ser acessado.
    A página de geração de token

Recursos