Administração de Serviço
Os tópicos abaixo abrangem várias tarefas de administração do Oracle Digital Assistant na console da OCI, incluindo gerenciamento e monitoramento de eventos, métricas, notificações, faturamento e as próprias instâncias do Digital Assistant.
Gerenciar Recursos
Em cada release do Oracle Digital Assistant, há conjuntos de recursos opcionais que você pode ativar ou desativar. Para isso, selecione um perfil que contenha os recursos que deseja ativar.
Para alterar os recursos opcionais que estão habilitados:
- No Oracle Digital Assistant, clique em
para abrir o menu lateral e selecione Definições > Gerenciamento de Recursos.
- Na lista drop-down Perfil atual, selecione o perfil que corresponde aos recursos que você deseja ativar e desativar.
Trilha Auditoria
Caso precise ver um histórico de atividades do usuário em uma instância do Oracle Digital Assistant e você tenha privilégios de administrador para a instância, poderá exibir os logs de atividade da instância.
Esses logs capturam detalhes granulares de sessões de usuário, como listar, criar, editar e excluir habilidades.
Para procurar os logs:
- Na instância, clique em
para abrir o menu lateral e selecione Definições > Trilha de Auditoria.
- Se você quiser ver resultados para mais do que o dia atual, vá para a lista drop-down Hoje e selecione outro intervalo de datas.
- Clique em + Critérios uma ou mais vezes para criar critérios de pesquisa para identificar o tipo de atividade que você deseja exibir.
- Clique em Pesquisar.
- Para ver detalhes de uma entrada de log, clique na entrada.
Exemplo: Pesquisando Operações de Exclusão
Veja um exemplo de como você pode usar o recurso de pesquisa para ver todas as operações de exclusão:
- Clique em + Critério.
- No campo Filtro, selecione Operação.
- No campo Operador, selecione Começa com.
- No campo de valor, digite
Delete
. - Clique em Pesquisar.
Nos resultados da pesquisa, você verá entradas para quaisquer operações com nomes que comecem com Delete
, como DeleteSkill
ou DeleteSkillIntent
.
Eventos de Instâncias do Digital Assistant
Você pode criar automação com base nas alterações de estado de suas instâncias do serviço Oracle Digital Assistant usando tipos de eventos, regras e ações.
Para obter informações sobre como os eventos funcionam, consulte Visão Geral do Serviço Events.
Tipos de Eventos
Estes são os tipos de eventos que as instâncias do serviço Oracle Digital Assistant emitem:
Nome Amigável | Tipo de Evento |
---|---|
Início da Alteração do Compartimento do Digital Assistant |
|
Final da Alteração do Compartimento do Digital Assistant |
|
Início da Criação de Instância do Digital Assistant |
|
Final da Criação de Instância do Digital Assistant |
|
Início da Exclusão de Instância do Digital Assistant |
|
Final da Exclusão de Instância do Digital Assistant |
|
Atualização de Instância do Digital Assistant |
|
Exemplo de Evento de Instância do Serviço Digital Assistant
Este é um evento de referência para instâncias do serviço Oracle Digital Assistant.
{
"id": "ocid1.eventschema.oc1.phx.abyhqljrfajridyag4epdbthdjuhwgkwxxog32ed4e36yx2zotmphyxe3z5q",
"exampleEvent": {
"eventID": "unique_id",
"eventTime": "2019-10-09T13:58:03.575Z",
"contentType": "application/json",
"eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
"cloudEventsVersion": "0.1",
"source": "DigitalAssistant",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"eventTypeVersion": "2.0",
"data": {
"resourceName": "example_name",
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"availabilityDomain": "all",
"compartmentName": "example_name",
"resourceId": "ocid1.odainstance.oc1.phx.unique_ID"
}
},
"serviceName": "Digital Assistant",
"displayName": "ODA Instance - Create End",
"eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
"additionalDetails": [],
"timeCreated": "2019-10-09T13:58:03.575Z"
}
Métricas, Alarmes, Notificações e Faturamento
Você pode monitorar a integridade, o desempenho e o uso de instâncias do serviço Oracle Digital Assistant no Oracle Cloud Infrastructure usando métricas, alarmes e notificações.
Por exemplo, é possível:
- Ver quantas mensagens foram enviadas durante um determinado período por usuários para habilidades e assistentes digitais em sua instância de serviço.
- Ver os erros que ocorreram durante um determinado período.
- Definir alarmes para alertá-lo quando alguma dessas métricas atingir um determinado limite.
Para obter informações sobre como esses recursos funcionam, consulte Visão Geral do Serviço Monitoring e Visão Geral do Serviço Notifications.
Métricas do Digital Assistant
As métricas do Oracle Digital Assistant são emitidas com o namespace de métrica oci_digitalassistant
.
Veja aqui as métricas disponíveis para instâncias do Oracle Digital Assistant.
Métrica | Nome para Exibição da Métrica | Unidade | Descrição | Dimensões |
---|---|---|---|---|
RuntimeRequests |
Solicitações de Runtime | contagem |
Número de solicitações de runtime enviadas para o serviço. Isso inclui
|
resourceId resourceDisplayName shape |
RuntimeErrorResponses |
Respostas com Erro de Runtime | contagem |
Número de respostas com erro de runtime retornadas durante conversas com uma habilidade ou um assistente digital. Isso inclui chamadas de API que retornam códigos de status de 400 a 499 e de 500 a 599. Esses erros podem indicar problemas com um canal ou sua configuração. |
resourceId resourceDisplayName shape errorType |
CustomComponentErrorResponses |
Respostas com Erro do Componente Personalizado | contagem | Número de respostas com erro recebidas dos componentes personalizados ou das funções do serviço Functions. | resourceId resourceDisplayName shape |
CustomComponentRejectedResponses |
Respostas Rejeitadas do Componente Personalizado | contagem |
Número de respostas inválidas recebidas de componentes personalizados ou funções do serviço Functions. Por exemplo, isso pode incluir respostas com um código de status 200, mas que são encapsuladas em JSON com formato inválido. |
resourceId resourceDisplayName shape |
Você pode exibir métricas por instância de serviço individual ou em formato agregado para todas as instâncias.
Exibir Métricas de uma Única Instância
Para exibir métricas de uma instância de serviço individual:
- Na Console de Infraestrutura, clique em
na parte superior esquerda para abrir o menu de navegação, selecione Análise e Inteligência Artificial e depois clique emDigital Assistant.
- Selecione o compartimento da instância.
- Selecione a instância.
- Role para baixo até a seção Métricas da página para exibir as métricas.
Exibir Métricas de Todas as Instâncias
Para exibir métricas agregadas de todas as instâncias de serviço:
- Na Console de Infraestrutura, clique em
na parte superior esquerda para abrir o menu de navegação, selecione Observabilidade e Gerenciamento e depois clique em Métricas do Serviço.
- Na lista drop-down Compartimentos, selecione o compartimento para o qual você deseja exibir métricas.
- No Namespace de Métrica, selecione oci_digitalassistant.
Monitorar Faturamento
A Console de Infraestrutura fornece várias ferramentas de faturamento e pagamento que facilitam o monitoramento do faturamento, dos custos de serviço e do uso do Oracle Digital Assistant.
Para ver seu faturamento e uso, execute as seguintes etapas:
- Acesse o Oracle Cloud. Você pode encontrar o nome da sua conta e informações de log-in no e-mail de boas vindas.
- Na Console de Infraestrutura, clique em
na parte superior esquerda para abrir o menu de navegação, selecione Governança e Administração e depois selecione uma das seguintes opções:
-
Análise de Custo: oferece ferramentas de visualização fáceis de usar para ajudá-lo a rastrear e otimizar seus gastos.
-
Relatório de Custo e Uso: exiba arquivos de valores separados por vírgulas (CSV) que possam ser usados para obter detalhamentos dos recursos para reconciliação de faturas e auditoria.
Observação
Na primeira vez em que acessar os relatórios de uso, você deverá criar uma política no compartimento raiz. Siga as instruções da página Relatório de Uso para criar a política, copiando as instruções conforme orientado.
-
Orçamentos: defina limites para os gastos. Você pode definir alertas sobre seu orçamento para que saiba quando pode excedê-lo, e pode ver todos os seus orçamentos e gastos em um só local.
-
Faturas: exiba e faça download de faturas para seu uso.
-
Para obter mais informações sobre as ferramentas de faturamento e pagamento, consulte Visão Geral das Ferramentas de Faturamento e Pagamento.
Interromper e Iniciar Instâncias
Você pode interromper e iniciar instâncias do Oracle Digital Assistant.
Quando você interrompe uma instância, o estado da instância muda para INACTIVE, o que significa que a instância não pode ser acessada e qualquer medição será suspensa. Iniciar uma instância a retorna ao estado ACTIVE, disponibilizando-a aos usuários e retomando a medição.
Para interromper ou iniciar uma instância:
- Na Console de Infraestrutura, clique em
na parte superior esquerda 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 na página).
- Selecione o compartimento da instância.
- Selecione a instância.
- Clique no botão Interromper ou Iniciar.
Excluir uma Instância
Para excluir permanentemente uma instância do Oracle Digital Assistant:
- 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).
- Selecione o compartimento da instância.
- Selecione a instância.
- No menu Mais Ações, selecione Excluir.
Break Glass
O Oracle Break Glass para Oracle Digital Assistant permite que você restrinja com segurança o acesso da Oracle ao seu ambiente de nuvem.
O recurso Break Glass para Oracle Digital Assistant será ativado se você tiver uma instância do Digital Assistant pareada com uma assinatura do Oracle Cloud Applications baseada no Fusion que inclua o Break Glass.
Quando você usa o Break Glass, os representantes do Suporte Técnico da Oracle só podem acessar seu ambiente de nuvem após aprovações e autorização relevantes para diagnosticar e solucionar problemas que possam surgir no ambiente de nuvem.
O Break Glass tem estes recursos principais:
- Aprovação de acesso temporário, no qual os funcionários da Oracle só podem acessar dados de instância por meio de um processo rigoroso de aprovação do cliente. Normalmente, esse processo só seria iniciado para ajudar a resolver uma solicitação de atendimento ao cliente.
Esse acesso é por tempo limitado. Qualquer credencial de acesso temporário será redefinida automaticamente após o tempo acordado.
Esse acesso é registrado e há relatórios detalhados disponíveis.
- A opção para fazer upload da sua própria chave de criptografia principal TDE (Transparent Data Encryption).
Por padrão, seus dados no ambiente do Oracle Cloud são criptografados em repouso usando TDE.
Com o Break Glass, você pode fazer upload da sua própria chave de criptografia principal TDE e gerenciar o ciclo de vida. Se você fornecer sua própria chave, seus dados também serão protegidos e auditados usando o Data Vault. Você também pode atualizar periodicamente as chaves.
Aprovação de Acesso Temporário
Se você enviar uma solicitação de serviço (SR) e o Suporte Técnico da Oracle determinar que precisa acessar alguns de seus dados para fins de depuração, você poderá concordar em conceder acesso temporário aos dados da instância de serviço. Este é o fluxo geral do processo:
- Você envia uma SR.
- Se o Suporte Técnico da Oracle determinar que precisa de acesso a qualquer um dos seus dados para fins de depuração, ele entrará em contato com o administrador por e-mail solicitando aprovação para conduzir uma sessão do Break Glass. (O e-mail tem um link para a página Aprovação de Acesso Temporário do Digital Assistant, na qual o administrador pode clicar em Aprovar ou Rejeitar.)
- Se o administrador aprovar a solicitação, uma senha temporária será gerada para permitir que o Suporte Técnico da Oracle inicie uma sessão do Break Glass para acessar os dados necessários.
- Quando o suporte técnico da Oracle concluir o trabalho na sessão do Break Glass, ele encerrará a sessão. Se ele não encerrar explicitamente a sessão, ela vai expirar automaticamente dentro do prazo acordado.
Fornecer a Própria Chave
Por padrão, a Oracle fornece e gerencia as chaves TDE para criptografar os dados da sua instância do Digital Assistant.
Se sua instância tiver o Break Glass ativado, você também poderá substituir a chave privada fornecida pela Oracle por sua própria, o que também permite que você gire as chaves conforme necessário.
Quando você alterna pela primeira vez para usar sua própria chave, precisa dar tempo para que sua instância fique fora de serviço. Você também deve fazer backup de qualquer artefato de chave em sua instância.
Criar e Importar sua Chave TDE Principal
Para fornecer sua própria chave, siga estas etapas:
- No Oracle Digital Assistant, clique em
para abrir o menu lateral e selecione Definições > Break Glass.
- Na Página Fornecer Sua Própria Chave, clique em + Fornecer Sua Própria Chave.
- Clique em Chave Pública para fazer download da chave pública de encapsulamento da Oracle que você precisará para criptografar sua própria chave principal de criptografia de dados transparente (TDE).
- Use o OpenSSL para gerar e criptografar sua chave:
- Crie um novo diretório para a chave e designe-o a uma variável de ambiente:
$ mkdir –p dir_of_key
$ export KEYPATH dir_of_key
- Verifique se o diretório é restrito:
$ chmod go-rwx $KEYPATH
- Gere a chave principal TDE:
$ openssl rand 32 > $KEYPATH/clearkey
- Criptografe sua chave principal TDE gerada com a chave pública de encapsulamento da Oracle baixada na etapa 3:
$ openssl pkeyutl -encrypt -in $KEYPATH/clearkey -inkey $KEYPATH/wrappingkey -pubin -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 > $KEYPATH/wrappedkey
- Crie um novo diretório para a chave e designe-o a uma variável de ambiente:
- No campo Origem de Dados da Chave Externa, faça upload da chave principal TDE criptografada (por exemplo,
wrappedkey
, como no exemplo anterior). - No campo Endereço de E-mail, digite o endereço de e-mail da pessoa a ser notificada quando a reconfiguração da instância do Digital Assistant for concluída e a instância estiver pronta para ser usada novamente.
- Clique em Submeter e, em seguida, em Confirmar.
Atualizar a Chave
Se você tiver fornecido anteriormente sua própria chave TDE para sua instância do Digital Assistant, poderá atualizar essa chave.
- No Oracle Digital Assistant, clique em
para abrir o menu lateral e selecione Definições > Break Glass.
- Na Página Fornecer Sua Própria Chave, clique em + Atualizar a chave.
- Clique em Chave Pública para fazer download da chave pública de encapsulamento da Oracle que você precisará para criptografar sua própria chave principal de criptografia de dados transparente (TDE).
- Use o OpenSSL para gerar e criptografar sua chave:
- Crie um novo diretório para a chave e designe-o a uma variável de ambiente:
$mkdir –p dir_of_key
$ export KEYPATH dir_of_key
- Verifique se o diretório é restrito:
$ chmod go-rwx $KEYPATH
- Gere a chave principal TDE:
$ openssl rand 32 > $KEYPATH/clearkey
- Criptografe sua chave principal TDE gerada com a chave pública de encapsulamento da Oracle baixada na etapa 3:
$ openssl pkeyutl -encrypt -in $KEYPATH/clearkey -inkey $KEYPATH/wrappingkey -pubin -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 > $KEYPATH/wrappedkey
- Crie um novo diretório para a chave e designe-o a uma variável de ambiente:
- No campo Origem de Dados da Chave Externa, faça upload da chave principal TDE criptografada.
- Clique em Submeter e, em seguida, em Confirmar.
Depois de criar ou atualizar sua chave, você precisará aguardar 16 dias ou mais para poder atualizá-la novamente.
Recuperação de Desastre
O Oracle Digital Assistant tem uma arquitetura de alta disponibilidade (HA) para impedir desastres e se recuperar facilmente. Veja aqui algumas facetas da arquitetura do Oracle Cloud Infrastructure e do Digital Assistant que são usadas para evitar e minimizar desastres:
- O Oracle Cloud Infrastructure é dividido em regiões. Cada região fica separada de outras regiões por grandes distâncias, o que significa que desastres como terremotos e eventos climáticos maiores que podem impactar negativamente o serviço em uma região são extremamente improváveis de afetar as outras regiões.
- Em cada data center, há três domínios de falha, cada um deles é um agrupamento de hardware e infraestrutura fisicamente distinto, com sua própria fonte de energia e refrigeração.
- A arquitetura de uma única instância do Digital Assistant é distribuída entre os diferentes domínios de falha com backup automatizado, o que a torna resiliente contra todos os desastres que podem ocorrer nessa região.
Failover entre Regiões
O Oracle Digital Assistant é arquitetado para alta disponibilidade (HA). No entanto, se você precisar garantir que sua instância ainda possa funcionar se um desastre atingir a região da instância, poderá solicitar a configuração do failover entre regiões.
Quando o failover entre regiões é configurado e a instância principal é desativada:
- Todas as solicitações de runtime para a instância principal são redirecionadas para a instância de backup.
- Um banner aparece na interface do usuário do Digital Assistant que observa se a instância de backup está sendo usada.
- Você não deverá trabalhar em habilidades, assistentes digitais, canais, Insights ou em outros artefatos (seja na interface do usuário ou por meio de APIs REST) na instância de backup. Nenhuma alteração feita na instância de backup será preservada quando a instância principal for restaurada.
Quando a interrupção termina:
- O serviço para a instância principal é restaurado.
- Todos os dados do Insights acumulados na instância de backup são preservados e combinados com os dados existentes do Insights associados à instância principal.
- Artefatos como habilidades e assistentes digitais são restaurados para o estado em que estavam quando a instância principal foi desativada. (Na prática, isso simplesmente significa que nenhuma alteração que você fizer nesses artefatos na instância de backup será preservada.)
Configurar Failover
Para configurar o failover entre regiões:
- Registre uma solicitação de serviço (SR) para failover entre regiões e, na solicitação, mencione o URL da instância principal do Digital Assistant.
- Depois que a equipe de Suporte tiver respondido a você com informações sobre quais regiões de backup estão disponíveis, inscreva-se em uma região de backup na Console do OCI.
A equipe de Suporte criará a instância de backup.
Durante a configuração do failover, uma habilidade no nível do sistema (denominada Echo
) é configurada na instância que você especificou e expôs por meio de um canal Web (denominado heartbeat
) nessa instância. Na região de backup, a instância principal é consultada regularmente sobre seu status de integridade por meio dessa habilidade.
Ponto Final Privado
Você pode configurar um ponto final privado para conceder ao seu Oracle Digital Assistant acesso seguro a serviços de backend que não estão expostos à internet pública.
Por exemplo, talvez você precise configurar um ponto final privado para se conectar a um banco de dados local ou a um banco de dados em execução em uma VCN do Oracle Cloud Infrastructure que você precisa usar para habilidades de Diálogo SQL. Ou talvez você precise estabelecer conexão com o serviço REST local ou em uma VCN.
Configurar um Ponto Final Privado
Para configurar um ponto final privado para o Digital Assistant, siga estas etapas gerais:
- Certifique-se de ter as permissões necessárias para configurar pontos finais privados e anexá-los às instâncias do Digital Assistant.
- Se você ainda não as tiver no lugar, na Console do OCI, crie uma rede virtual na nuvem (VCN) e seus recursos associados, incluindo:
- Pelo menos uma sub-rede.
- Tabelas de roteamento para rotear o tráfego por meio da sub-rede para seus destinos.
- Listas de segurança ou grupos de segurança de rede para estabelecer um conjunto de regras de segurança de entrada e saída que você usará para o ponto final privado.
- Opcionalmente, um gateway de Internet para conceder acesso à Internet à VCN.
- Opcionalmente, um gateway NAT (Tradução de Endereço de Rede), que permite que recursos que não têm endereços IP públicos acessem a Internet sem expô-los a conexões de Internet de entrada.
- Crie o ponto final privado e associe-o à sua instância do Digital Assistant.
- No Digital Assistant, configure um serviço de dados ou serviço REST que aponte para o ponto final.
Permissões para Pontos Finais Privados
Para configurar pontos finais privados, você precisa ter as permissões adequadas na Console de Infraestrutura.
Há dois tipos de recursos para pontos finais privados que abrangem estas permissões necessárias:
oda-private-endpoints
- permite configurar pontos finais privados e proxies SCAN.oda-private-endpoint-attachments
- permite anexar um ponto final privado a uma instância do Digital Assistant.
As permissões para esses tipos de recursos também fazem parte do tipo de recurso oda-family
. Portanto, se você for coberto por uma instrução de política para gerenciar tipos de recursos oda-family
no compartimento no qual seu ponto final privado está, não precisará criar políticas separadas para seus pontos finais privados.
Veja a seguir exemplos de políticas amplas para permitir a criação e a configuração de pontos finais privados e anexá-los às instâncias do Digital Assistant.
allow group <group-name> to manage oda-private-endpoints in compartment <private-endpoint-compartment>
allow group <group-name> to manage oda-private-endpoint-attachments in compartment <private-endpoint-compartment>
Para obter mais detalhes sobre como as políticas funcionam, consulte Políticas do Digital Assistant.
Criar uma Política para Acessar um Ponto Final Privado
-
Na Console de Infraestrutura, clique em
na parte superior esquerda para abrir o menu de navegação, selecione Identidade e Segurança e depois clique em Políticas.
É exibida uma lista das políticas no compartimento que você está exibindo.
-
Na lista de compartimentos, selecione o compartimento ao qual deseja anexar a política. Isso controla quem pode modificar ou excluir posteriormente a política (consulte Anexação de Políticas).
-
Clique em Criar Política.
-
Conclua o assistente, certificando-se de que o nome fornecido seja exclusivo entre todas as políticas da sua tenancy.
Criar um Ponto Final Privado
- 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).
- Na navegação esquerda da página Serviços AI exibida, clique em Pontos finais privados.
- Se você ainda não tiver feito isso, crie o compartimento no qual deseja manter o ponto final privado e, opcionalmente, adicione a VCN e a sub-rede que você usará a esse compartimento.
Consulte Entendendo Compartimentos e Gerenciando Compartimentos.
- Clique em Criar ponto final privado e preencha os campos obrigatórios, incluindo a VCN e a sub-rede privada.
- Depois que o ponto final for criado, clique em Associar Instância do ODA, selecione o compartimento que contém a instância do Digital Assistant que você deseja poder usar o ponto final privado e selecione essa instância.
Adicionar um Serviço para o Ponto Final Privado no Assistente Digital
Depois de criar um ponto final privado, adicione um serviço para esse ponto final privado para usá-lo no Digital Assistant.
- Para adicionar um serviço de dados para o ponto final privado, consulte Estabelecer Conexão com o Serviço de Dados.
- Para adicionar um serviço REST para o ponto final privado, consulte Adicionar um Serviço REST para um Ponto Final.
Proxies de SCAN para Pontos Finais Privados
Se você estiver usando seu ponto final privado para um banco de dados ativado para RAC, também precisará configurar um proxy SCAN para o ponto final privado.
Para configurar um proxy SCAN:
- Obtenha o nome do DNS SCAN e o número da porta do banco de dados.
- Se o banco de dados for local, obtenha-o do administrador do banco de dados.
- Se o banco de dados estiver no OCI, faça o seguinte na Console de Infraestrutura:
- Navegue para a página Detalhes do Sistema de Banco de Dados do banco de dados e selecione a guia Informações do sistema de banco de dados.
- Na seção Rede da página, copie o nome de DNS SCAN e cole-o em um local conveniente.
- Observe o Número da Porta.
- Na Console de Infraestrutura, clique em
na parte superior esquerda para abrir o menu de navegação, selecione Análise e IA e selecione Pontos finais privados (que aparece na categoria Serviços de IA da página).
- Selecione seu ponto final privado.
- Na seção Recursos da página, selecione Proxies SCAN.
- Clique em Adicionar proxy SCAN.
- Na caixa de diálogo Adicionar proxy SCAN, selecione o tipo (FQDN (para nome de domínio totalmente qualificado) ou endereço IP) e preencha o restante dos campos obrigatórios.
- Se você tiver selecionado FQDN como o tipo de proxy, use o nome do DNS SCAN do banco de dados para o Nome do host e o número da porta do banco de dados como a Porta.
- Se você tiver selecionado Endereço IP como o tipo de proxy, clique em Adicionar Listener SCAN para adicionar endereços IP e números de porta para um ou mais listeners SCAN no banco de dados.
Se você não conseguir criar um proxy SCAN por meio da Console de Infraestrutura, poderá fazer isso com as APIs de gerenciamento do Digital Assistant, que você pode chamar usando a CLI (Interface de Linha de Comando) do OCI. Consulte Usando a CLI do OCI para Configurar Proxies de SCAN.
Usando a CLI do OCI para Configurar Proxies de SCAN
Você pode usar a CLI do OCI para configurar proxies SCAN para um ponto final privado do Digital Assistant.
Consulte https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm para obter informações sobre como obter a configuração da CLI.
Consulte https://docs.oracle.com/en-us/iaas/tools/oci-cli/3.47.0/oci_cli_docs/cmdref/oda.html para obter a referência de comando para APIs do Digital Assistant.
Veja alguns exemplos de comandos da CLI:
- Obtenha uma lista de proxies SCAN para um ponto final privado existente do Digital Assistant:
$ oci oda management oda-private-endpoint-scan-proxy list --oda-private-endpoint-id <ocid-for-private-endpoint> --region <region-name> --auth security_token --profile oc1_boat
Isso deverá retornar uma lista vazia se nenhum proxies SCAN tiver sido criado.
- Crie um proxy SCAN para um endereço de Listener SCAN baseado em IP:
$ oci oda management oda-private-endpoint-scan-proxy create --scan-listener-type IP --protocol TCP --scan-listener-infos '[{"scan-listener-fqdn": null, "scan-listener-ip": "2.2.2.2", "scan-listener-port": 1521}]' --oda-private-endpoint-id <ocid-for-private-endpoint> --region <region-name> --auth security_token --profile oc1_boat
- Crie um proxy SCAN para um endereço de Listener SCAN baseado em FQDN:
$ oci oda management oda-private-endpoint-scan-proxy create --scan-listener-type FQDN --protocol TCP --scan-listener-infos '[{"scan-listener-fqdn": "myhost.example.com", "scan-listener-ip": null, "scan-listener-port": 1521}]' --oda-private-endpoint-id <ocid-for-private-endpoint> --region <region-name> --auth security_token --profile oc1_boat
Os exemplos acima incluem os argumentos
--auth security_token
e --profile oc1_boat
, mas talvez eles não sejam necessários, dependendo de como você configurou a autenticação para sua instalação da CLI.
Informações Adicionais de Administração
Uma vez que você configurou a instância do Oracle Digital Assistant e os usuários, talvez queira se aprofundar mais na configuração da sua conta. Estes são alguns tópicos que contêm mais detalhes sobre a administração de serviços no Oracle Cloud Infrastructure que você pode querer explorar:
Criação e Gestão Programática de Habilidades e Assistentes Digitais
A API da Instância do Serviço Digital Assistant permite que você gerencie de forma programática habilidades e seus artefatos, assistentes digitais e canais. Isso inclui criação, atualização, exclusão e treinamento. Além disso, você pode gerenciar outros recursos em sua instância dos quais suas habilidades dependem, como serviços de autorização e serviços de tradução.
Você pode acessar a API por meio de vários SDKs e de uma CLI. Consulte a página Developer Tools and Resources do OCI para obter os detalhes.
Habilidades empacotadas
Se você estiver gerenciando várias instâncias do Digital Assistant, também poderá gerenciar programaticamente pacotes para essas instâncias.
Um pacote pode conter alguma combinação de habilidades e assistentes digitais, bem como especificar quaisquer recursos necessários, como serviços de tradução, serviços de autorização e parâmetros personalizados necessários para as habilidades.
Você pode gerenciar a importação e a atualização desses pacotes por meio da API da Instância do Serviço Digital Assistant.
Para obter informações sobre como trabalhar com a API e os SDKs e a CLI baseados nessa API, consulte a página Ferramentas e Recursos do Desenvolvedor do OCI.
Importação e Gerenciamento de Pacotes
Em geral, o processo de importação de pacotes usando a API (diretamente ou por meio da CLI ou de um dos SDKs) é:
- Se ela ainda não existir, crie a instância do Oracle Digital Assistant na qual você deseja importar o pacote.
- Chame
CreateOdaInstance
para criar a instância. - Na resposta à chamada
CreateOdaInstance
, obtenha o valor do cabeçalho de respostaopc-work-request-id
e use-o para chamarGetWorkRequest
para monitorar o andamento da operação de criação da instância. - Depois que a criação da instância for concluída, usando o valor do atributo
odaInstanceId
que foi retornado no corpo da resposta para chamarGetOdaInstance.
- Chame
- Chame
ListPackages
para ver quais pacotes estão disponíveis para a instância (ou instâncias) especificada. - Para todos os pacotes disponíveis que você deseja importar, chame
GetPackage
para obter o contrato de importação do pacote.O contrato de importação especifica condições que precisam ser atendidas para que você possa importar o pacote. Isso pode incluir coisas como especificar um provedor de autenticação e preencher valores para parâmetros personalizados.
- Atenda ao contrato de importação.
Você faz isso construindo uma carga útil que fornece valores para todos os parâmetros necessários no contrato de importação. O payload pode ser semelhante a este:
{ "packageId": "<packageId-OCID>", "parameterValues": { "authProvider.providerX.clientSecret": "some value", "authProvider.providerX.authorizationEndpointUrl": "http://host:80/file", "authProvider.providerX.revokeEndpointUrl": "http://host:80/file", "authProvider.providerX.allowedScopes": "some value", "authProvider.providerX.tokenEndpointUrl": "http://host:80/file", "authProvider.IDCS_OAuthForIDR.allowedScopes": "some value", "authProvider.providerX.clientId": "some value", "skillParameter.da.backendRestEndPoint": "http://host:80/file", } }
Para simplificar essa tarefa, a resposta
GetPackage
contém uma seção chamadadefaultParameterValues
que você pode usar para montar a parte do valor do parâmetro do payload. - Importe o pacote para a(s) instância(s).
- Chame
CreateImportedPackage
usando o payload que você acabou de montar. - Na resposta à chamada
CreateImportedPackage
, obtenha o valor do cabeçalho de respostaopc-work-request-id
e use-o para chamarGetWorkRequest
para monitorar o andamento da operação de importação do pacote. - Depois que a importação do pacote for concluída, use o valor do atributo
odaInstanceId
que foi retornado no corpo da resposta para chamarGetImportedPackage
para exibir os detalhes do pacote.
- Chame
Se uma atualização de um pacote estiver disponível, você poderá adicionar esse pacote atualizado à instância por meio da operação UpdateImportedPackage
.