O conector do ServiceNow para o Gemini Enterprise permite pesquisar e realizar ações nos seus dados e registros.
Tipos de conector
O Gemini Enterprise oferece dois tipos de conectores para você escolher como quer acessar seus registros:
Pesquisa federada: acesse seus registros em tempo real diretamente do app ServiceNow sem ingestão de dados. Esse modo usa o fluxo de concessão do código de autorização, que requer um processo baseado em redirecionamento para receber tokens de acesso.
Ingestão de dados: sincronize e indexe seus registros em um repositório de dados local para uma pesquisa de alto desempenho. Esse modo usa as credenciais de senha do proprietário do recurso (ROPC, na sigla em inglês), que utilizam credenciais diretas (nome de usuário e senha) para receber secrets.
Verifique se o registro do app ServiceNow está configurado com os fluxos de autenticação corretos com base no seu caso de uso:
- Se estiver configurando ações, pesquisa federada ou ambas, configure o fluxo do código de autorização.
- Se estiver configurando apenas a ingestão de dados, configure o fluxo ROPC.
- Se você configurar a ingestão de dados com as ações, será necessário oferecer suporte ao fluxo de ROPC e ao fluxo do código de autorização.
Versões compatíveis do ServiceNow
O conector do ServiceNow é compatível com a versão v2 e mais recentes da API do ServiceNow.
Ações permitidas
Quando o repositório de dados do ServiceNow está ativado, os usuários finais podem usar comandos de linguagem natural no Gemini Enterprise para realizar as ações listadas nesta seção.
As ações se enquadram em três categorias, com base em como são ativadas no console:
- As ações mutativas criam ou modificam registros no ServiceNow. É possível ativar cada um individualmente ao criar o repositório de dados ou depois.
- As ações somente leitura ativadas por padrão leem dados do ServiceNow para o usuário final. Eles são ativados automaticamente, mas você pode desativá-los.
- As ações somente leitura disponíveis mediante solicitação leem dados do ServiceNow, mas estão desativadas por padrão. É possível ativá-los individualmente.
Ações mutativas
| Ação | Descrição |
| Criar incidente | Crie um novo registro de incidente no ServiceNow para relatar e acompanhar uma interrupção de serviço. |
| Atualizar incidente | Atualize um incidente no ServiceNow usando o ID exclusivo do sistema. |
| Criar solicitação de mudança | Crie uma solicitação de mudança no ServiceNow para gerenciar e acompanhar formalmente as mudanças no sistema. |
| Criar tarefa | Crie uma tarefa genérica no ServiceNow para acompanhar qualquer trabalho que precise ser feito. |
| Update task | Atualiza uma tarefa do ServiceNow identificada pelo ID do sistema. |
| Criar solicitação do catálogo de serviços | Crie uma solicitação de catálogo de serviços no ServiceNow para pedir itens ou serviços. |
| Atualizar solicitação do catálogo de serviços | Atualizar uma solicitação de catálogo de serviços no ServiceNow. |
| Criar item de solicitação | Crie um item de solicitação no ServiceNow para rastrear um item ou serviço individual em uma solicitação do catálogo de serviços. |
| Atualizar item de solicitação | Atualiza um item de solicitação atual no ServiceNow. |
| Enviar item do catálogo | Envie um pedido de item do catálogo de serviços no ServiceNow em nome do usuário solicitante. |
| Aprovar registro | Aprovar ou rejeitar um registro de aprovação pendente do ServiceNow
(sysapproval_approver). Usados com frequência para agir em solicitações de
mudança, itens solicitados ou pedidos de catálogo aguardando aprovação.
|
| Adicionar comentário ao tíquete | Anexe uma entrada de diário (comentário adicional ou nota de trabalho) a qualquer registro derivado de tarefa do ServiceNow (incidente, solicitação de mudança, item solicitado, solicitação etc.) sem modificar outros campos. |
| Criar registro | Cria um registro em uma tabela especificada do ServiceNow. |
| Atualizar registro | Atualiza um registro em uma tabela especificada do ServiceNow. |
| Fazer upload do anexo | Fazer upload de um arquivo como anexo para um registro atual do ServiceNow usando a API Attachment. |
Ações somente leitura ativadas por padrão
| Ação | Descrição |
| Listar incidentes | Listar ou consultar incidentes. |
| Listar solicitações de mudança | Listar ou consultar solicitações de mudança. |
| Listar tarefas | Listar ou consultar tarefas. |
| Listar itens de solicitação | Listar ou consultar itens de solicitação. |
| Listar solicitações do catálogo de serviços | Listar ou consultar solicitações do catálogo de serviços. |
| Solicitação de pesquisa no catálogo de serviços | Pesquisar ou consultar solicitações do catálogo de serviços. |
| Item do pedido de pesquisa | Listar ou consultar itens solicitados. |
| Pesquisar catálogo | Listar ou consultar catálogos de serviços. |
| Pesquisar item do catálogo | Listar ou consultar itens do catálogo. |
| Listar categorias do catálogo | Listar ou consultar categorias de catálogo. |
| Pesquisar base de conhecimento | Listar ou consultar artigos de conhecimento. |
| Listar bases de conhecimento | Listar ou consultar bases de conhecimento. |
| Listar problemas | Listar ou consultar problemas. |
| Listar serviços | Listar ou consultar serviços. |
| Listar interrupções | Listar ou consultar interrupções. |
| Pesquisar itens de configuração | Listar ou consultar itens de configuração (CIs). |
| Listar recursos de hardware | Listar ou consultar recursos de hardware. |
| Listar licenças de software | Listar ou consultar licenças de software. |
| Pesquisar usuário | Listar ou consultar usuários. |
| Pesquisar departamentos | Pesquisar ou consultar departamentos. |
| Pesquisar locais | Pesquisar ou consultar locais. |
| Pesquisar projeto | Pesquisar ou consultar projetos. |
Ações somente leitura disponíveis mediante solicitação
| Ação | Descrição |
| Listar recursos | Listar ou consultar recursos. |
| Listar depósitos | Listar ou consultar depósitos. |
| Listar contratos de serviço | Listar ou consultar contratos de serviço. |
| Listar definições de SLA | Listar ou consultar definições de SLA. |
| Listar consumidores | Listar ou consultar consumidores. |
| Listar contas | Listar ou consultar contas. |
| Listar contatos | Listar ou consultar contatos. |
| Listar casos | Listar ou consultar casos. |
| Listar direitos de acesso | Listar ou consultar direitos de acesso. |
| Listar categorias de conhecimento | Listar ou consultar categorias de conhecimento. |
| Pesquisar história | Listar ou consultar histórias (rm_story). |
| Pesquisar anexo | Pesquisar ou consultar anexos. |
| Pesquisar portfólio | Pesquisar ou consultar portfólios. |
| Pesquisar cartão de ponto | Pesquisar ou consultar cartões de ponto. |
Limitações
Nesta seção, descrevemos problemas e limitações conhecidos que podem afetar o uso do repositório de dados do ServiceNow.
- Ao criar um app ou adicionar um repositório de dados a um app, recomendamos associar apenas um repositório de dados a ações que pertencem a um único tipo de conector.
- Não é possível aplicar um perímetro do VPC Service Controls em repositórios de dados do ServiceNow. Para aplicar o VPC Service Controls, exclua e recrie os repositórios de dados. Para mais informações sobre o VPC Service Controls e como usar ações depois de ativar o VPC Service Controls, consulte Proteger seu app com o VPC Service Controls.
- O repositório de dados do ServiceNow é compatível apenas com os locais
global,useeu.
A seguir
- Para criar e configurar um conector com o ServiceNow, consulte Configurar um repositório de dados do ServiceNow.