Chamar etapa Habilidade do Now Assist

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Execute um publicado Now Assisthabilidade de uma ação. Configure o. Now Assistentradas de habilidade e saídas de habilidade das entradas de etapa e saídas de etapa.

    Funções e disponibilidade

    Disponível como uma etapa de ação de Workflow Studio. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.

    Requisitos do Kit de habilidades do Now Assist
    Esta etapa requer Kit de habilidades do Now Assist. Para obter mais informações, consulte Exploring Now Assist Skill Kit.
    Requisitos da função
    Esta etapa requer funções concedidas pelo desenvolvimento delegado ou atribuídas ao usuário. Para obter mais informações, consulte Acesso do usuário ao Workflow Studio fluxos.

    Entradas

    Forneça um valor para cada entrada necessária para sua ação. Para adicionar valores dinâmicos, você também pode arrastar e soltar pilhas do painel de dados ou selecioná-las no seletor de pilhas.

    Configuração de habilidade
    Tipo de dados: Reference

    Referência a um registro Configuração de habilidade do Now Assist [sn_nowassist_skill_config]. A carga é gerada com base na Configuração de habilidade selecionada.

    Carga
    Tipo de dados: String

    Cadeia de caracteres formatada em JSON que contém a carga a ser enviada para Now Assist E o OneExtend Framework para processamento.

    Se esta etapa falhar
    Tipo de dados: Choice

    Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Para usar o código de status da etapa ou a mensagem para uma condição de erro de ação personalizada, consulte Avaliação de erro de ação.

    Saídas

    Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em sua ação.

    Erro
    Tipo de dados: String

    Mensagem de erro produzida pela habilidade. Esta saída fica vazia quando a habilidade executa com sucesso o. Now Assist solicitação de habilidade.

    Provedor
    Nome do provedor de LLM que atendeu Now Assist solicitação de habilidade.
    Resposta
    Resposta de texto gerada pelo LLM, como um resumo ou uma resposta a uma conversa.
    Resultado
    Cadeia de caracteres formatada em JSON que contém os resultados gerados pelo LLM para a carga de entrada.
    Status
    Status da chamada para o provedor.
    Status da etapa
    Tipo de dados: Object

    Cápsula de dados do objeto que contém detalhes de tempo de execução sobre a etapa. Cada etapa em uma ação retorna um Status da etapa.

    Código de status da etapa
    Tipo de dados: Integer
    Cápsula de dados inteiros que indica se a etapa produziu um erro. Uma etapa retorna um valor de 1 quando produz um erro por qualquer motivo. Por exemplo, uma etapa pode produzir um erro se não tiver dados de entrada obrigatórios ou retornar uma saída no tipo de dados incorreto. Uma etapa retorna um valor de 0 quando é executada com sucesso. Esses códigos não podem ser personalizados.
    • Sucesso [0]: A etapa foi bem-sucedida.
    • Erro [1]: A etapa produziu um erro.
    Mensagem de status da etapa
    Tipo de dados: String

    Cápsula de dados da cadeia de caracteres que contém a mensagem de erro produzida pela etapa ou operação do sistema. Você não pode personalizar a mensagem de status da etapa.

    Chame a habilidade Resumo de fluxo

    Ação que usa a etapa de habilidade de Chamar Now Assist para a habilidade Resumo de fluxo.

    Esta ação de exemplo chama a habilidade Resumir fluxo, que fornece um resumo em texto do que um fluxo ou subfluxo faz. A habilidade Resumo de fluxo tem duas entradas de habilidade.
    • sys_id. Esta entrada contém o SYS ID do componente a ser resumido.
    • type. Esta entrada contém o tipo de componente a ser resumido.
    Para oferecer suporte às duas entradas de habilidade, esta ação de exemplo tem duas entradas de ação correspondentes.
    • Flow to summarize. Esta entrada contém o SYS ID do componente a ser resumido.
    • Type. Esta entrada contém o tipo de componente a ser resumido, como fluxo, subfluxo ou ação.
    Nota:
    Uma ação não pode ter uma entrada com o nome sys_id, porque esse nome é uma palavra reservada.

    Podemos testar esta ação fornecendo estes valores de entrada de exemplo.

    Configuração de habilidade
    Este exemplo usa o Resumo de fluxo Now Assist Registro de configuração de habilidade.
    Carga
    Este exemplo usa um objeto JSON para mapear valores de entrada de ação para valores de habilidade. Neste exemplo, fornecemos o SYS ID do fluxo de autorização de mudança - normal - e o tipo de fluxo.

    Exemplo de detalhes de execução da habilidade de resumo do fluxo de chamadas

    Estes são os valores de saída de exemplo produzidos pela habilidade Resumo de fluxo.

    Saída de erro
    Este exemplo não produz uma saída de erro.
    Saída do provedor
    Este exemplo usa o provedor Now LLM.
    Saída de resposta

    Este exemplo usa a habilidade Resumo de fluxo para gerar um resumo para o fluxo Mudança - Normal - Autorizar. Normalmente, você usaria esta saída de Resposta como uma entrada para outra ação ou lógica de fluxo.

    Este fluxo, chamado "Mudança - Normal - Autorizar", foi projetado para processar uma solicitação de mudança que usa o Modelo de mudança normal e está no estado de Autorização, garantindo que não esteja em espera.

    O fluxo começa verificando se o gerente do grupo de atribuição já aprovou a solicitação de mudança. Caso contrário, ele aplica uma Política de aprovação de mudança, especificamente para aprovações de risco.

    Em seguida, o fluxo avalia se o processo de aprovação foi ignorado, rejeitado ou aprovado. Se ignorado, não fará nada. Se rejeitado, ele envia uma notificação por e-mail para as partes relevantes. Se aprovado, ele atualiza o registro de solicitação de mudança para marcá-lo como aprovado.

    Em paralelo, o fluxo aguarda até que a solicitação de mudança esteja em espera ou inativa e desconsidera todas as aprovações de solicitação de mudança. Ele também avalia o modelo de mudança novamente.

    O fluxo termina após a conclusão dessas tarefas.

    Saída do resultado
    Este exemplo retorna um objeto JSON que contém os elementos de resposta e fluxo usados para gerar a resposta.
    Saída de status
    Este exemplo retorna um valor de saída de sucesso.