Skill の Parameter を使用すると、Skill を変更・再学習・再公開しなくても挙動を調整できます。これは、多数の学習用ドキュメントを必要とする複雑な Skill に有用です。
Document skill の場合、Skill の Parameter はさまざまなドキュメント処理シナリオに Skill を適合させるために使用します。Process skill の場合、Skill の Parameter は関連する Document skill の Parameter を参照・調整するために使用します。
Tenant Administrator と Skill Designer のロールを持つユーザーのみが、Skill の Parameter を作成および編集できます。
いくつかの一般的なシナリオが、Skill の Parameter の有用性を示しています。
それぞれの顧客のデータ カタログを使って請求書を処理する
同じ組み込みの Invoice Skill を使って、異なる顧客の請求書を処理したい場合があります。この場合、Vantage API で作成した特定のトランザクションに適切なデータ カタログを渡すために、Skill の Parameter を使用できます。Invoice Skill を含む一部の組み込み Skill には、Skill 内で使用するデータ カタログを参照できる既定の Parameter が用意されています。トランザクションで新しいデータ カタログを渡して、その値を変更するだけでかまいません。
Vantage API を介して Skill の Parameter の値を編集する方法については、Vantage API を介した Skill の Parameter へのアクセスを参照してください。
たとえば、ドイツなど特定の国の小売レシートのみを処理するために Receipt Skill を使用したい場合があります。Receipt Skill を含む一部の組み込み Skill には、自動の国別判定および経費タイプ判定を制限できる既定の Parameter が用意されています。ドイツのレシートだけを処理するには、これらの Parameter の値として “DE” と “GeneralRetail” を指定します。これにより、Country と Expense Type の field がそれに応じて再定義され、ドキュメントの処理が高速化されます。
特定のドキュメントセットを処理する際に、Document skill を設定して Date field に新しい値を割り当てたい場合があります。これを行うには、新しい Boolean Skill Parameter を作成し、その値を No に設定して、Date field に対するスクリプトルールを追加します。スクリプトルールは次のようになります。
if (Context.Skill.Parameters["New parameter"].Value == false) {
Context.GetField("Date field").Value = '新しい日付'
}
特定のドキュメントセットを処理する際、ルールは Boolean Skill Parameter の値がNoに設定されているかを確認し、設定されていれば「New date」の値をDate field に割り当てます。
異なるレベルにおける Parameter 間の関係
Process skill には Extract アクティビティを含めることができ、さらにその中で Document skill を使用できます。この入れ子構造の各レベルで、次のパラメータを追加・設定できます。
- Document skill のパラメータ: Document skill 内の各アクティビティ間で抽出データを共有し、さまざまな文書処理の設定を指定するために使用します。これらのパラメータは Vantage、Advanced Designer、または Vantage API で表示および編集できます。
- Extract アクティビティのパラメータ: 本質的には、Extract アクティビティからアクセスできる Document skill のパラメータです。これらのパラメータは Vantage で表示および編集できます。
- Process skill のパラメータ: Extract アクティビティのパラメータを参照し、その値を変更するために使用します。これらのパラメータは Vantage および Vantage API で表示および編集できます。
Document skill にパラメータがない場合、Process skill にパラメータを追加する必要はありません。
Skill の Parameter には、次の 3 種類があります。
| Type | Description |
|---|
| Data Catalog | 接続先のサーバー上のデータ カタログへの接続 string を含みます |
| Text | string 値を含みます |
| Boolean | Boolean 値を含みます。取り得る値は Yes と No です |