Pular para o conteúdo principal
Os parâmetros de skill permitem ajustar o comportamento de uma skill sem precisar modificá-la, retreiná-la e publicá-la novamente. Isso é útil para skills complexas que exigem grandes volumes de documentos de treinamento. No caso de uma Skill de Documento, os parâmetros de skill são usados para adequar a skill a diversos cenários de processamento de documentos. No caso de uma Skill de Processo, os parâmetros de skill são usados para referenciar e ajustar os parâmetros de sua Skill de Documento.
Importante: Somente usuários com as funções Tenant Administrator e Skill Designer podem criar e editar parâmetros de skill.

Casos de uso

Vários cenários comuns demonstram o valor dos parâmetros de skill:

Processar faturas de diferentes clientes usando seus próprios catálogos de dados

Talvez você queira usar a mesma Skill de faturas pronta para processar faturas de diferentes clientes. Nesse caso, você pode usar parâmetros da skill para indicar o catálogo de dados correto em uma transação específica criada com a Vantage API. Algumas skills prontas, incluindo a skill Invoice, têm parâmetros padrão que podem ser usados para fazer referência aos catálogos de dados utilizados por uma skill. Você só precisa alterar seus valores, informando um novo catálogo de dados na transação. Para saber como editar os valores dos parâmetros da skill via a Vantage API, consulte Acessando parâmetros da skill via a Vantage API.

Restringindo a detecção automática de país e tipo de despesa

Você pode querer usar a Skill Receipt para processar recibos de varejo apenas de um país específico, por exemplo, da Alemanha. Algumas Skills incorporadas, incluindo a Skill Receipt, têm parâmetros padrão que podem ser usados para restringir a detecção automática de país e tipo de despesa. Para processar apenas recibos alemães, você precisará especificar “DE” e “GeneralRetail” como valores desses parâmetros. Os campos Country e Expense Type serão redefinidos de acordo, e os documentos serão processados mais rapidamente.

Atribuindo um novo valor a um determinado campo

Você pode querer configurar sua Skill de Documento para atribuir um novo valor ao campo Date ao processar um conjunto específico de documentos. Para isso, será necessário criar um novo Parameter de skill do tipo Boolean, definir seu valor como No e adicionar uma regra com script para o campo Date. A regra com script pode ser semelhante ao seguinte:
if (Context.Skill.Parameters["New parameter"].Value == false) {
  Context.GetField("Date field").Value = 'Nova data'
}
Ao processar um conjunto específico de documentos, a regra verificará se o valor do parâmetro Boolean da skill está definido como No e, se estiver, o valor “New date” será atribuído ao campo Date.

Relações entre Parameters em diferentes níveis

Uma Skill de Processo pode incluir uma atividade Extract que, por sua vez, usa uma Skill de Documento. Em cada nível dessa estrutura em cadeia, você pode adicionar e configurar os seguintes parâmetros:
  • Parâmetros da Skill de Documento: usados para compartilhar dados extraídos entre as atividades da Skill de Documento e para especificar várias configurações de processamento de documentos. Você pode visualizar e editar esses parâmetros no Vantage, no Advanced Designer e via a Vantage API.
  • Parâmetros da atividade Extract: essencialmente, são os parâmetros da Skill de Documento que podem ser acessados a partir da atividade Extract. Você pode visualizar e editar esses parâmetros no Vantage.
  • Parâmetros da Skill de Processo: usados para referenciar parâmetros da atividade Extract e alterar seus valores. Você pode visualizar e editar esses parâmetros no Vantage e via a Vantage API.
Dica: Se sua Skill de Documento não tiver parâmetros, você não precisa adicionar nenhum parâmetro à Skill de Processo.

Tipos de Parameter de Skill

Os Parameter de Skill podem ser de qualquer um dos três tipos a seguir:
TipoDescrição
Catálogo de dadosContém uma connection string para um catálogo de dados no servidor ao qual você está conectado
TextContém um valor string
BooleanContém um valor Boolean. Os valores possíveis são Yes e No

Veja também