1. Acesse sua conta do Oracle Cloud.
2. Na Console de Infraestrutura, clique em no canto superior esquerdo para abrir o menu de navegação, selecione Análise e Inteligência Artificial e selecione Digital Assistant (que aparece na categoria Serviços de Inteligência Artificial da página).
3. No painel Compartimentos, selecione um compartimento.

   Se você ainda não tiver criado um compartimento, consulte Noções Básicas sobre Compartimentos e Gerenciando Compartimentos.

4. Clique em Criar Instância do Digital Assistant.
5. Na página Criar Instância do Digital Assistant, preencha os seguintes detalhes:
   • Compartimento.

   • Nome. Informe um nome que reflita o uso da instância. Por exemplo, para um ambiente de desenvolvimento, você pode usar oda-dev1.

   • Forma da instância. Selecione entre as seguintes formas:

     • Desenvolvimento. Esta é uma opção simplificada que é voltada para o trabalho de desenvolvimento.
     • Produção. Esta opção deve ser selecionada para instâncias de produção do Digital Assistant. Em comparação com a forma Desenvolvimento, essa opção tem limites de taxa mais altor e maior capacidade do banco de dados, o que permite que mais dados do Insights sejam coletados.

     Consulte Formas de Instância e Limites de Taxa e Armazenamento para obter informações sobre os limites de taxa.

   • Se você quiser ativar o acesso baseado em atribuição à instância (em vez do acesso baseado em política padrão do IAM), clique em Mostrar Opções Avançadas, selecione Ativar Acesso Baseado em Atribuição e selecione um domínio de identidades.

     Consulte Acesso Baseado em Atribuição e Domínios de Identidade para obter informações sobre como configurar usuários e grupos e designar atribuições.

     Observação
     
     A opção Ativar Acesso Baseado em Atribuição estará desativada se a tenancy atual ainda não tiver suporte para Domínios de Identidades.

   • Namespace de Tag. (Opcional) Para saber como isso funciona, consulte Gerenciando Tags e Namespaces de Tag.

6. Clique em Criar.

   Após alguns minutos, a instância passará do status Criando para Ativo, o que significa que sua instância estará pronta para uso.

Depois de provisionar uma instância, você pode acessá-la da Console de Infraestrutura seguindo estas etapas:

1. Na página da console da instância, clique no botão Console de Serviço.

   Você será redirecionado para outra página de log-in.

2. Clique no link Alterar tenant.

3. No campo Tenant do Cloud, informe o valor do campo Conta do Cloud na seção Detalhes de Acesso do seu e-mail de boas-vindas.

4. Acesse a instância.

   Como administrador do tenant, você sempre pode fazer log-in com suas credenciais de sign-on único (no lado esquerdo da página). Da mesma forma, todos os usuários federados por meio do IDCS podem fazer log-in com essas credenciais.

   Os usuários provisionados com contas de usuário do IAM podem fazer log-in no lado direito.

   Depois de acessar, você deverá ser direcionado para a instância do serviço Oracle Digital Assistant.

   Observação
   
   Se sua nova senha não funcionar, talvez seja porque ainda não entrou em vigor. Se esse for o caso, tente informar a senha temporária recebida no seu e-mail de boas-vindas.

Você pode recuperar o URL da sua instância de serviço na página da console da instância. Em seguida, você precisará compartilhar esse URL com sua equipe, pois seus membros não serão notificados de outra forma, mesmo quando receberem permissões para o Digital Assistant.

1. Na guia Informações da Instância, clique no link Copiar que aparece à direita do campo URL Web Base.

   Isso copiará o URL para a área de transferência do sistema.

2. Cole o URL em um local conveniente.

3. Compartilhe este URL com membros da sua equipe.

Quando você informar o URL da sua instância do Oracle Digital Assistant em seu browser, serão apresentadas duas opções de log-in:

• Oracle Cloud Infrastructure Direct Sign-In (IAM): O IAM é o serviço de identidade nativo do Oracle Cloud Infrastructure. Se todos os seus serviços do Oracle Cloud fizerem parte do Oracle Cloud Infrastructure (Gen 2), você deverá configurar suas contas de usuário no IAM e usar esta como sua opção de acesso principal.
• Sign-on Único (SSO): Com essa opção, você poderá fazer log-in se tiver uma conta de usuário com um provedor de identidades federado com o IAM. Por exemplo, o Oracle Identity Cloud Service (IDCS) é um serviço usado por muitos serviços Oracle Cloud, incluindo aqueles que não fazem parte da arquitetura Oracle Cloud Infrastructure (Gen 2). Uma vez que essa conta de usuário é federada e designada a grupos com permissões apropriadas, ela pode ser usada como uma opção de sign-on único para todos os serviços Oracle Cloud desse usuário.
  Observação
  
  Se você for o administrador da conta do Cloud, poderá fazer log-in no Digital Assistant com sua conta do IDCS, mesmo que você não tenha adicionado explicitamente essa conta a um grupo com permissões para acessar o Digital Assistant.

Para saber mais sobre essas opções, como elas se relacionam entre si e como é quando você acessa cada uma, consulte Noções Básicas das Opções de Acesso.

O Oracle Digital Assistant tem limites para o número de instâncias e serviços de componentes personalizados incorporados que você pode criar. Sempre que você cria uma nova instância ou um serviço de componente personalizado incorporado, o sistema garante que sua solicitação esteja dentro dos limites do seu limite.

Por exemplo, o limite depende da forma como você solicitou o Digital Assistant:

Você pode usar cotas para determinar como outros usuários alocam recursos em compartimentos no Oracle Cloud Infrastructure. Sempre que você cria ou amplia uma instância do Oracle Digital Assistant, o sistema garante que sua solicitação esteja dentro dos limites da cota para esse compartimento.

Para obter mais informações sobre como as cotas funcionam, consulte Cotas de Compartimento.

Esta tabela mostra a cota relacionada ao Assistente Digital que você pode aplicar aos compartimentos

O número de solicitações por minuto que podem ser feitas à sua instância depende da forma da instância:

• Forma de desenvolvimento: 50 solicitações por minuto
• Forma de produção: 500 solicitações por minuto

Esses limites abrangem solicitações de canais do usuário (como Slack, Microsoft Teams, Web, Twilio, Webhook etc.).

Para solicitações que ocorrem quando o limite de taxa foi atingido, uma resposta HTTP 429 (Muitas Solicitações) é retornada.

Além disso, o volume de armazenamento alocado para dados do Insights depende da forma da instância:

• Forma de desenvolvimento: 40 GB
• Forma de produção: 100GB

Ao configurar sua instância para seus usuários, você deve planejar cuidadosamente como organizar sua tenancy e criar seus grupos de usuários e políticas. No entanto, se quiser configurar uma instância com rapidez antes de se familiarizar totalmente com esses conceitos, você poderá seguir a "receita" abaixo.

Nesta receita, além de provisionar a instância, você configura permissões para desenvolvedores e administradores usando o serviço IAM (Identity and Access Management) do Oracle Cloud Infrastructure. Posteriormente, você pode adaptar a receita às suas próprias necessidades.

1. Crie um compartimento no qual você colocará sua instância.

   Compartimentos fornecem agrupamentos lógicos de instâncias de serviço e outros recursos de nuvem. Criando um compartimento para sua instância, você pode conceder permissões aos usuários para a instância sem conceder essas permissões para toda a sua tenancy.

   1. Na Console de Infraestrutura, clique em na parte superior esquerda para abrir o menu de navegação, selecione Identidade e Segurança e Compartimentos.

   2. Clique em Criar Compartimento.
   3. No campo Nome, informe da_development.

      Você pode escolher outro nome, se desejar. Se fizer isso, lembre-se de ajustar as definições de política abaixo de acordo.

   4. Preencha o restante dos valores obrigatórios e clique em Criar Compartimento.

2. Crie contas de usuário do IAM para qualquer outro membro da equipe que você queira que tenha acesso à instância.

   1. Na seção Identidade da página Identidade e Segurança, clique em Usuários.

   2. Clique em Criar Usuário.

   3. Na caixa de diálogo Criar Usuário, preencha os detalhes necessários com atenção especial para o seguinte:

      • O valor de Nome pode ser um endereço de e-mail ou um nome exclusivo. Este será o nome que o usuário usará para fazer log-in na instância.
      • O valor E-mail, que é usado para recuperação da senha.

   4. Clique em Criar.

   5. Depois que o usuário for criado, selecione o usuário e clique em Criar/Redefinir Senha.

   6. Clique em Copiar.

   7. Cole a senha em um local seguro e forneça-a ao usuário.

      O usuário precisará fazer log-in com essa senha e, depois, alterá-la imediatamente.

3. Crie um grupo do IAM para seus desenvolvedores e outro para seus administradores.

   1. Na seção Identidade da página Identidade e Segurança, clique em Grupos.

   2. Clique em Criar Grupo.

   3. Preencha os campos na caixa de diálogo da seguinte forma:

      • Name: ServiceDevelopers
      • Descrição: Developer access to the instance of Digital Assistant in the da_development compartment.

   4. Clique em Criar Grupo para concluir a criação do grupo.

   5. Novamente, clique no botão Criar Grupo da página.

   6. Informe o seguinte:

      • Nome: ServiceAdministrators
      • Descrição: Complete access to the instance of Digital Assistant in the da_development compartment, including the ability to set feature flags and purge data.

   7. Clique em Criar Grupo.

   Observação
   
   Assim como acontece com o nome do compartimento, você pode dar aos grupos o nome que desejar. Se você usar nomes distintos, lembre-se de ajustar as definições de política abaixo de acordo.

4. Crie políticas para cada grupo que definam o nível de acesso que cada membro tem à instância do Digital Assistant.

   Nestas etapas, você criará políticas para definir o acesso que cada grupo terá. Para o grupo de desenvolvedores, você dará permissões que permitem o desenvolvimento de habilidades e assistentes digitais, a criação de canais e outras funções úteis para desenvolvedores. Para o grupo de administradores, você fornecerá permissões totais para a instância, incluindo a capacidade de ativar recursos e gerenciar dados analíticos.

   1. Na seção Identidade da página Identidade e Segurança, clique em Políticas.

   2. Na lista de compartimentos à esquerda, selecione da_development.

   3. Clique em Criar Política.

   4. Para Nome e Descrição, informe o seguinte:

      • Nome: Policy-for-DA-ServiceDevelopers
      • Descrição: Policy for developer access to instances of Digital Assistant in the da_development compartment.

   5. Para Versões da Política, selecione Manter Política Atual.

   6. Para Instrução, informe as duas instruções a seguir:

      • Allow group ServiceDevelopers to use oda-design in compartment da_development
      • Allow group ServiceDevelopers to use oda-insights in compartment da_development

   7. Clique em Criar.

   8. Novamente, clique em Criar Política.

   9. Informe o seguinte:

      • Nome: Policy-for-DA-ServiceAdministrators
      • Descrição: Policy for complete access to instances of Digital Assistant in the da_development compartment.
      • Versões da Política: Manter Política Atual.
      • Instrução: Allow group ServiceAdministrators to manage oda-family in compartment da_development

   10. Clique em Criar.

5. Adicione usuários aos grupos apropriados do IAM. (Você não precisa adicionar a si mesmo, porque já tem acesso à instância como administrador da conta do Cloud.)

   1. No menu Identidade, selecione Grupos.

   2. Localize o grupo na lista.

   3. Clique no grupo.

   4. Clique em Adicionar Usuário ao Grupo.

   5. Selecione o usuário na lista drop-down e clique em Adicionar Usuário.

6. Crie a instância de serviço do Oracle Digital Assistant.

   1. Clique em na parte superior esquerda para abrir o menu de navegação, selecione Análise e Inteligência Artificial e Digital Assistant.

   2. No painel Compartimentos, selecione da_development.
   3. Clique em Criar Instância.
   4. Na página Criar Instância, preencha os seguintes detalhes:
      • Compartimento: da_development

      • Nome: da-dev1 (ou outro nome que reflita o uso da instância)

      • Forma da instância:

        • Desenvolvimento. Esta é uma opção simplificada que é voltada para o trabalho de desenvolvimento.
        • Produção. Essa opção deve ser selecionada para instâncias de produção do Oracle Digital Assistant. Em comparação com a forma de Desenvolvimento, a forma de Produção pode aceitar mais solicitações por minuto e tem maior capacidade do banco de dados, o que permite que mais dados do Insights sejam coletados e armazenados.
   5. Marque a caixa de seleção VIEW DIGITAL ASSISTANT INSTANCE DETAILS UPON CREATING.
   6. Clique em Criar.

      Após alguns minutos, a instância passará do status Criando para Ativo, o que significa que sua instância estará pronta para uso.

7. Obtenha o URL de seus usuários.

   1. Na guia Informações da Instância da página da sua instância na Console de Infraestrutura, clique no link Copiar que aparece à direita do campo URL Web Base.

      Isso copiará o URL para a área de transferência do sistema.

   2. Cole o URL em um local conveniente.

   3. Compartilhe este URL com membros da sua equipe.

      Como você configurou contas do IAM para ele, diga a eles para acessarem no lado direito da página de log-in (em Oracle Cloud Infrastructure).

      No entanto, você precisará fazer log-in no lado esquerdo da página com sua conta SSO (a menos que tenha adicionado sua conta de usuário do IAM ao grupo ServiceDevelopers ou ServiceAdministrator).

      Observação
      
      Como administrador da conta do Cloud, você tem contas SSO (via Oracle Identity Cloud Service) e do IAM. E, como administrador da conta do Cloud, você pode acessar o Digital Assistant com sua conta SSO sem primeiro ter que se adicionar a um grupo com permissões para o Digital Assistant.

8. (Opcional) Acesse a instância da Console de Infraestrutura.

   Você também pode acessar a instância de serviço da Console de Infraestrutura:

   1. Na página da console da instância, clique no botão Console de Serviço.

      Você será redirecionado para outra página de log-in.

   2. Na página de log-in, onde diz Acessando o Tenant do Cloud, verifique se o nome do tenant corresponde ao nome no campo Conta do Cloud na seção Detalhes de Acesso do e-mail de boas-vindas. Caso contrário, clique no link Alterar tenant e informe o nome da sua conta do Cloud antes de continuar.

   3. No lado esquerdo da página, em Sign-on Único (SSO), clique em Continuar.

      Você deve ser direcionado para sua instância de serviço do Oracle Digital Assistant.

Instâncias do Digital Assistant que são pareadas com inscrições de um serviço Oracle Fusion Applications Cloud são projetadas para você usar e estender habilidades existentes prontas para uso que são fornecidas por esse serviço Fusion Applications. Por padrão, essas instâncias pareadas não permitem que você use a faixa completa de recursos do Digital Assistant, como criar e clonar habilidades e assistentes digitais.

Se você quiser aproveitar a faixa completa de recursos do Digital Assistant na instância pareada, poderá vincular essa instância pareada a uma assinatura do Digital Assistant como serviço individual. Se sua instância pareada não estiver vinculada dessa forma, você receberá mensagens de advertência quando criar habilidades ou assistentes digitais ou quando executar qualquer outra tarefa que não seja coberta pelos termos da instância pareada.

Há duas maneiras de vincular sua instância pareada do Digital Assistant:

• Usando a mesma conta do Oracle Cloud na qual você tem sua assinatura do Fusion Applications, compre uma assinatura do Oracle Digital Assistant Platform for SaaS. Depois que você tiver ativado o direito a essa assinatura, o link deverá ser estabelecido automaticamente.

  Você saberá que o link foi estabelecido com sucesso se puder executar ações na instância pareada, como criar novas habilidades, sem ver uma advertência de que não tem o direito necessário para isso.

  Observação
  
  Ao estabelecer um link com esse tipo de assinatura, você de fato não precisa provisionar uma nova instância para que o link funcione. Na verdade, é melhor continuar fazendo seu trabalho de desenvolvimento na instância pareada e não provisionar uma instância para a assinatura do Oracle Digital Assistant Platform for SaaS.

• Usando a mesma conta do Oracle Cloud na qual você tem sua assinatura dos Aplicativos Oracle, assine o Digital Assistant Cloud Service por meio do programa de Créditos Universais, provisione uma instância e depois vincule manualmente essa instância à sua instância pareada. Consulte Vincular Instâncias do Digital Assistant Manualmente.

Cada instância do Digital Assistant migrada da infraestrutura da Geração 1 para a infraestrutura da Geração 2 tem um aplicativo IDCS para lidar com autorização de usuário e acesso a APIs. O nome do aplicativo IDCS deve começar com idcs-oda.

Nesse aplicativo IDCS, há um grupo chamado OCI_Administrators. O administrador da conta do Cloud foi designado a esse grupo. Os membros desse grupo podem acessar posteriormente a console de infraestrutura da Geração 2 para provisionar novas instâncias e gerenciar usuários no IAM.

Aqui estão algumas diferenças que você precisa observar (e possivelmente tomar medidas) depois que uma instância tiver sido migrada da Geração 1 para a Geração 2:

• Há duas novas atribuições de aplicativos disponíveis no aplicativo IDCS (ServiceAdmin e ServiceBusinessUser) da instância, além de ServiceDeveloper, que era a única atribuição disponível nas instâncias da Geração 1.

• Os pacotes de componentes personalizados que você faz upload para um serviço de componente personalizado incorporado devem conter todas as dependências do módulo de nó, conforme descrito em Preparar o Pacote para um Serviço de Contêiner Incorporado. Se o pacote não contiver todas as suas dependências, você receberá um erro de caminho de componente inválido.

• Na infraestrutura da Geração 2, há limites de serviço para serviços de componentes personalizados incorporados.

  Se você precisar aumentar o limite, poderá solicitar um aumento. Para obter mais informações, consulte Exibir Limites de Serviço na Console de Infraestrutura e Solicitando um Aumento do Limite de Serviço.

• Se qualquer uma de suas habilidades usar o componente OAuth2Client para acessar as APIs REST do Oracle Digital Assistant, o serviço de autenticação do qual elas dependem deverá ser atualizado para usar o novo aplicativo confidencial IDCS que foi provisionado para a instância da Geração 2. Você precisará atualizar o ID do cliente, o segredo do cliente e o escopo. Para saber como obter os novos valores, consulte o tópico Enviar Solicitações na API REST para Oracle Digital Assistant no Oracle Cloud Infrastructure. Para saber mais sobre como atualizar o serviço de autenticação, consulte Serviços de Autenticação.

• O ponto final da API de Sessões foi alterado e agora inclui o ID do usuário e o ID do canal, além do ID da sessão. Para quaisquer componentes personalizados que chamem essa API para obter o log de conversa, você precisa modificar essa chamada de API. Além disso, o ID do cliente, o segredo do cliente e o escopo que você usa para obter o token de acesso para autorizar a chamada REST devem ser atualizados. Para componentes personalizados que acessam a API de Sessões, você precisa fazer estas alterações:

  • Seu código deve chamar conversation.channelId() para obter o ID do canal para o caminho da solicitação.
  • Altere o caminho da solicitação para /api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log. Observe que, no momento, o ID do usuário tem o mesmo valor do ID da sessão.
  • Se o componente personalizado recuperar o token de acesso, o ID do cliente, o segredo do cliente e o escopo deverão ser atualizados na chamada REST para o ponto final do token de acesso. Para saber como obter os novos valores, consulte o tópico Enviar Solicitações na API REST para Oracle Digital Assistant no Oracle Cloud Infrastructure.

  Depois de fazer as alterações, compacte novamente os componentes. Em seguida, para todas as habilidades que tiverem um serviço de componente para o pacote de componentes, recarregue o pacote.

  Para obter mais detalhes sobre a API, consulte API REST para Oracle Digital Assistant no Oracle Cloud Infrastructure.

• Para Transferência para Agente (Integrações de Agente), a estrutura de objeto customInfo será diferente para novos canais se o OSvC de destino for 19A ou posterior.

• Os tipos de canal Web, Android e iOS SDK nas instâncias da Geração 1 são substituídos pelas versões nativas Oracle desses tipos de canal na Geração 2 (com novos SDKs para cada tipo de canal). Se você tiver alguma habilidade ou assistente digital que use os tipos de canal antigos, migre-os para usar os novos tipos de canal nativos Oracle.

  Consulte Oracle Digital Assistant Web SDK customization and programming examples no blog do TechExchange para obter exemplos concretos de como adaptar o código do aplicativo Web ao novo Web SDK.

• Agora você pode usar Intenções de Resposta para adicionar a funcionalidade de Perguntas Mais Frequentes a uma habilidade. Ao contrário da funcionalidade de perguntas e respostas, as intenções de resposta são resolvidas com NLP. Além disso, você não precisa atualizar o fluxo de caixas de diálogo para tratar as intenções de resposta da forma como faz em um módulo de perguntas e respostas.

• Há uma variedade de outros recursos e aprimoramentos disponíveis nas instâncias da Geração 2 do Assistente Digital que não estão disponíveis nas instâncias da Geração 1. Para obter um resumo desses recursos, consulte Novidades do Oracle Digital Assistant.

Para instâncias do Digital Assistant que foram migradas da infraestrutura de nuvem da Geração 1 para a Geração 2, use um aplicativo IDCS (Oracle Identity Cloud Service) para gerenciar o acesso ao Digital Assistant.

Em instâncias da Geração 2, as atribuições de aplicativo a seguir estão disponíveis:

• ServiceAdministrator, que oferece permissões totais para a instância. Em instâncias da Geração 1, a atribuição ServiceDeveloper fornece esse nível de acesso.
• O ServiceDeveloper, que fornece permissões relevantes para usuários que desenvolvem habilidades e assistentes digitais. Faltam algumas permissões de administração (como a capacidade de expurgar dados).
• O ServiceBusinessUser, que fornece um subconjunto das permissões do ServiceDeveloper e se concentra principalmente na capacidade de trabalhar com relatórios do Insights.

Por padrão, todos os usuários de uma instância migrada recebem a atribuição ServiceAdministrator. Para os usuários que não devem ter as permissões totais de ServiceAdministrator, você pode alterar suas respectivas atribuições que se alinham melhor com o uso da instância.

Para designar uma destas atribuições a um usuário:

1. Como Administrador da Conta do Cloud, faça log-in no IDCS.

2. Clique no mosaico Oracle Cloud Services.

3. Navegue no aplicativo IDCS até a sua instância migrada do Digital Assistant.

   Este aplicativo deve ter um nome que corresponda à primeira parte do nome de domínio totalmente qualificado (FQDN) da sua instância. Por exemplo, se o FQDN da instância for idcs-oda-abcd1234-p0.digitalassistant.example.com, o aplicativo IDCS deverá ter idcs-oda-abcd1234-p0 no início de seu nome.

4. No aplicativo IDCS, clique na guia Atribuições de Aplicativos.

5. No mosaico da atribuição à qual você deseja adicionar usuários, clique em ) e selecione Designar Usuários ou Designar Grupo.

6. Selecione os usuários ou grupos aos quais deseja designar a atribuição e clique em Designar.

   Observação
   
   Se você quiser acessar a interface do usuário do Digital Assistant, designe a si mesmo essa atribuição.

Para remover uma designação de atribuição de um usuário, clique em ) no mosaico da atribuição e selecione Revogar Usuários.

Como o Oracle Cloud Infrastructure (Geração 2) é uma arquitetura multitenant, as instâncias do Digital Assistant migradas para a Geração 2 não terão suas próprias faixas de endereços IP. Em vez disso, você tem uma faixa de endereços IP públicos que são determinados pela região em que sua instância reside. Se você já tiver tido uma lista de permissões com uma faixa de endereços IP para sua instância quando ela estava na infraestrutura da Geração 1, será necessário atualizar essa lista com endereços IP públicos fornecidos na infraestrutura da Geração 2.

Para determinar a faixa de endereços IP para sua região, consulte Endereços IP Públicos para VCNs e o Oracle Services Network.