---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform
Release :
- yokohama
ft:locale :
- pt-BR
ft:publication_title :
- Capacidades da Now Platform da Yokohama
ft:clusterId :
- platcap
bundleId :
- platcap
workflow :
- Platform
---
# Catálogo de serviços blocos de tópico em Virtual Agent com tecnologia NLU
# Catálogo de serviços blocos de tópico em Virtual Agent com tecnologia NLU {#ariaid-title1}
* Versão de lançamento: Yokohama
*
* Atualizado 30 de jan. de 2025
*
*  7 min. de leitura
É possível planejar uma conversa de tópico no Virtual Agent desenvolvida por Compreensão da linguagem natural (NLU) incluindo blocos de tópicos reutilizáveis para realizar tarefas de envio de solicitação.
## Pesquisar Item do Catálogo {#request-topic-blocks-va__section_g5n_2g1_3mb}
Você pode usar este bloco de tópicos para pesquisar um item do catálogo com base nos critérios de pesquisa. Se houver vários resultados de pesquisa, você poderá selecionar um na exibição de carrossel.{#request-topic-blocks-va__table_inb_mg1_3mb__entry__2}
| Parâmetro | Descrição |
|-|-|
| query_term | Palavra-chave para pesquisar um item do catálogo. Para obter informações sobre como configurar a pesquisa de palavras-chave para um item do catálogo, consulte [Configurar pesquisa de palavra-chave para itens do catálogo](https://servicenow-prod.fluidtopics.net/aRKvpItnRLsdo6CVguMLeQ "Quando você pesquisa um item do catálogo por uma palavra-chave em Catálogo de serviços, os resultados da pesquisa são exibidos considerando alguns campos da tabela do catálogo."). |
| catálogos | Lista separada por vírgulas de catálogos nos quais um item do catálogo deve ser pesquisado. |
| result_limit | Número de resultados de pesquisa que devem ser exibidos. Por padrão, este número é definido como 5. |
[Tabela 1. Parâmetros de entrada]
{#request-topic-blocks-va__table_inb_mg1_3mb} {#request-topic-blocks-va__table_pks_mg1_3mb__entry__2}
| Parâmetro | Descrição |
|-|-|
| catalog_item_id | Se um item do catálogo for selecionado, o sys_id do item será retornado. Se nenhum item do catálogo for selecionado, ou seja, nenhuma dessas opções estiver selecionada, o valor -1 será retornado. |
| item_type | sys_class_name do item do catálogo que o usuário selecionou. |
| is_conversational | Especifica se o item do catálogo pode ser solicitado no modo de conversa no Virtual Agent. |
[Tabela 2. Parâmetros de saída]
{#request-topic-blocks-va__table_pks_mg1_3mb}
## Solicitar Item do Catálogo {#request-topic-blocks-va__section_fmt_fg1_3mb}
Você pode usar este bloco de tópicos para solicitar um item do catálogo.
{#request-topic-blocks-va__table_kkf_4g1_3mb__entry__2}
| Parâmetro | Descrição |
|-|-|
| catalog_item_id | sys_id do item do catálogo que deve ser solicitado. |
| execute_contextual_search | Opção para especificar se a pesquisa contextual deve ser executada para um produtor de registro com base em sua configuração. Para obter informações sobre como definir a pesquisa contextual para um produtor de registro, consulte [Definir pesquisa contextual para produtor de registro](https://www.servicenow.com/docs/access?context=t_CntxtSearchRP&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). |
| confirm_catalog_item | Opção para especificar se o usuário deve confirmar o item do catálogo antes de prosseguir para a próxima etapa. Se a opção estiver definida como falsa, o usuário poderá responder às perguntas dos itens do catálogo ignorando a confirmação. |
| show_end_state_card | Opção para exibir as informações do cartão de estado final sobre o registro gerado para o usuário. |
[Tabela 3. Parâmetros de entrada]
{#request-topic-blocks-va__table_kkf_4g1_3mb} {#request-topic-blocks-va__table_gbq_4g1_3mb__entry__2}
| Parâmetro | Descrição |
|-|-|
| record_id | sys_id do registro gerado após o envio do item. Se o item do catálogo não for compatível com o modo de conversa ou se o usuário não tiver acesso ao item, será retornado o valor -1. |
| record_table | Nome da tabela na qual o registro é gerado. |
| variáveis | Perguntas relacionadas ao item do catálogo. |
[Tabela 4. Parâmetros de saída]
{#request-topic-blocks-va__table_gbq_4g1_3mb}
## tipos de renderizador Virtual Agent {#request-topic-blocks-va__section_vnx_mpw_b5b}
Um item do catálogo pode ser renderizado no Virtual Agent como uma conversa, janela, pop-up ou em linha.
## Solicitação de item do catálogo usando um tipo de renderizador de conversa {#request-topic-blocks-va__section_x5d_d32_3mb}
Um usuário pode enviar uma solicitação no modo de conversa (respondendo às perguntas na linha).
As condições a seguir devem ser atendidas quando um usuário solicita um item do catálogo no modo de conversa no Virtual Agent com tecnologia NLU.
* Um item do catálogo não pode ter mais perguntas do que o número especificado na propriedade glide.sc.conversational.request.question.limit. Por padrão, este número é definido como 10. Para obter mais informações sobre esta propriedade, consulte [Propriedades do Catálogo de serviços](https://servicenow-prod.fluidtopics.net/0wQUwdw~YfBhofOdPv2MVw "A aplicação do Catálogo de serviços contém propriedades usadas para definir várias configurações na aplicação.").
* Um item do catálogo pode ter políticas de IU de catálogo sem script. Essas políticas de IU devem ser definidas de forma que as variáveis sejam afetadas sequencialmente, ou seja, somente uma variável de ordem inferior afeta uma variável de ordem superior.
* Um item do catálogo não pode ter scripts de cliente do catálogo que sejam definidos para o Now Mobile ou o Portal de serviços.
* Somente as seguintes variáveis são compatíveis:
* Anexo
* Caixa de seleção (Um grupo de variáveis de caixa de seleção não é compatível)
* Data
* Data/Hora
* E-mail
* Endereço IP
* Rótulo
* Pesquisa com múltipla escolha (sem implicações de preço e qualificador de referência avançado)
* Pesquisa com caixa de seleção (sem implicações de preço e qualificador de referência avançado)
* Múltipla escolha (sem implicações de preço)
* Texto de Várias Linhas
* Escala numérica (sem implicações de preço)
* Referência (sem implicações de preço e qualificador de referência avançado)
Nota:
Variáveis de tipo de referência que correspondam a uma tabela a uma tabela com mais de 7000 registros não são compatíveis. O limite superior para o número de registros pode ser especificado na propriedade glide.sc.va.reference_question_choices.limit. Por padrão, é definido como 7000.
* Solicitado para (sem implicações de preço e qualificador de referência avançado)
* Rótulo de Rich Text
* Caixa de seleção (sem implicações de preço)
* Texto de Linha Única
* URL
* Texto de Linha Única Larga
* Sim/Não
* Variáveis de contêiner
{#request-topic-blocks-va__ul_lj4_nv4_g3b}
* Os seguintes atributos de variáveis são compatíveis:
* ref_ac_order_by
* allowed_extensions
* max_file_size
{#request-topic-blocks-va__ul_f23_nd1_3mb}
Nota:
Todos os outros atributos de variáveis são ignorados em Virtual Agent.
* Um item do catálogo pode ter um conjunto de variáveis de linha única, mas não um conjunto de variáveis com várias linhas.
* Se um item do catálogo tiver um valor padrão configurado para uma pergunta, o valor padrão será exibido no Virtual Agent, o que permite ao usuário prosseguir com o valor padrão sem precisar selecioná-lo manualmente. O usuário também pode escolher um valor diferente do valor padrão.
* Se um item do catálogo tiver uma pesquisa de dados configurada para uma pergunta, o valor definidor será exibido no Virtual Agent, o que permite ao usuário prosseguir com o valor definidor ou escolher um valor diferente. Se a pergunta definidora preceder a pergunta combinadora, o item do catálogo com pesquisa de dados não será permitido como um item de conversa.
* O usuário não pode ignorar os seguintes tipos de pergunta para um item do catálogo:
* Múltipla Escolha de Pesquisa
* Selecionar Caixa
* Caixa de Seleção de Pesquisa
* Sim/Não
* Escala numérica (se a configuração Não selecionar a primeira escolha não estiver selecionada)
* Múltipla escolha (se a configuração Não selecionar a primeira escolha não estiver selecionada, ou se a configuração Não incluir qualquer opção estiver selecionada)
{#request-topic-blocks-va__ul_t3n_4qb_c5b}
* Se o usuário estiver usando o Virtual Agent em uma ferramenta de colaboração compatível diferente, como o Microsoft Teams:
* Não há suporte para pesquisar um valor usando o ícone de pesquisa no tipo de seleção de campos.Figura 1. Campos do tipo opção no Microsoft Teams Figura 2. Campos do tipo opção no Virtual Agent
* A pesquisa de um valor nos campos de tipo de referência é realizada na forma de uma pergunta.Figura 3. Campos do tipo referência no Microsoft Teams Figura 4. Campos do tipo referência no Virtual Agent
{#request-topic-blocks-va__ul_yxq_qrs_f5b}
{#request-topic-blocks-va__ul_oln_svz_hmb} Se o item do catálogo não for de conversa, o formulário de solicitação poderá aparecer como qualquer um destes tipos de renderizador:
* Em linha
* Pop-up
* Janela
{#request-topic-blocks-va__ul_a5g_bbj_dcc}
As condições determinam se o formulário de item do catálogo para o item do catálogo não conversacional aparecerá como em linha, pop-up ou janela.
Nota:
Com base no número de perguntas, uma propriedade glide.sc.va.inline_render.question.limit determina se o formulário de item do catálogo aparece como em linha ou pop-up. Por padrão, o valor da propriedade é 20.
{#request-topic-blocks-va__table_nv2_hbj_dcc__entry__2}
| O formulário de item do catálogo aparece como | Condições |
|-|-|
| Em linha | * O item do catálogo não contém variáveis de página de IU ou personalizadas. * Se o item do catálogo tiver 20 perguntas ou menos, o formulário do item aparecerá como em linha. O valor padrão da propriedade glide.sc.va.inline_render.question.limit é 20. * O item do catálogo não contém o conjunto de variáveis com várias linhas (MRVS). {#request-topic-blocks-va__ul_n1c_kbj_dcc} |
| Pop-up | * O item do catálogo não contém variáveis de página personalizadas ou de IU. * Se o item do catálogo tiver mais de 20 perguntas, o formulário do item aparecerá como um pop-up. O valor padrão da propriedade glide.sc.va.inline_render.question.limit é 20. {#request-topic-blocks-va__ul_t32_4bj_dcc} |
| Janela | * O item do catálogo contém variáveis de página personalizadas ou de IU. * A propriedade glide.sc.va.render_type.legacy é definida como verdadeira. {#request-topic-blocks-va__ul_em2_frw_dcc} |
[ ]
{#request-topic-blocks-va__table_nv2_hbj_dcc}
## Solicitação de item do catálogo usando um tipo de renderizador em linha {#request-topic-blocks-va__section_wjt_srq_bcc}
Os solicitantes do item do catálogo podem enviar um item do catálogo preenchendo o formulário em linha no Virtual Agent com tecnologia NLU. Ao solicitar um item do catálogo marcado com o tipo de renderizador em linha, o solicitante pode preencher o item e as respectivas opções na conversa Virtual Agent.
Por exemplo, um solicitante pode preencher um formulário em linha na conversa Virtual Agent e enviar o item.Figura 5. Solicitação em linha de um item do catálogo
## Solicitação de item do catálogo usando um tipo de renderizador como pop-up {#request-topic-blocks-va__section_k5s_4n1_25b}
Um usuário pode enviar uma solicitação de item do catálogo como um pop-up para itens que não sejam de conversa. Em um pop-up, o Virtual Agent oferece um link para que o usuário envie a solicitação em um pop-up sem precisar navegar para uma nova guia. Um item do catálogo que não seja de conversa somente poderá ser renderizado como pop-up se não tiver variáveis Personalizadas, Personalizadas com rótulo ou de Página de IU.
Nota:
Se você não quiser renderizar sua conversa do Virtual Agent como um pop-up, defina a propriedade glide.sc.va.render_type.legacy como verdadeira, o que renderiza todos os itens do catálogo que não sejam de conversa no portal configurado em uma nova guia.
## Solicitação de item do catálogo usando um tipo de renderizador como janela {#request-topic-blocks-va__section_mlk_xn1_25b}
Um usuário pode enviar uma solicitação de item do catálogo em uma janela. Em uma janela, o Virtual Agent oferece um link para o usuário enviar a solicitação no Portal de serviços definido na propriedade sn_itsm_va.com.snc.itsm.virtualagent.portal_url. Um item que não seja de conversa será renderizado como uma janela se tiver uma variável Personalizada, Personalizada com rótulo ou de Página de IU.
Um item do catálogo será renderizado como uma janela se for dos seguintes tipos:
* Conteúdo de Itens
* Guia de pedido
* Iniciador do Assistente
* Modelo de Mudança padrão
{#request-topic-blocks-va__ul_t5v_zqs_f5b}
* **[Como enviar uma conversa de tópico de solicitação](https://servicenow-prod.fluidtopics.net/IHbT0kbLVkpyQvN5_Zmeqg)**
Os usuários podem enviar solicitações em conversas com o Virtual Agent.
**Conceitos relacionados**
* [Conversa de tópico de visualização do construtor de catálogo](https://servicenow-prod.fluidtopics.net/UFjIpz9iRzqRMzegmhpulQ "No construtor de catálogo, um usuário pode visualizar um item do catálogo em uma conversa Virtual Agent.")