メインコンテンツへスキップ
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” を指定します。これにより、CountryExpense Type の field がそれに応じて再定義され、ドキュメントの処理が高速化されます。

特定の 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 で表示および編集できます。
Tip: Document skill にパラメータがない場合、Process skill にパラメータを追加する必要はありません。

Skill の Parameter の種類

Skill の Parameter には、次の 3 種類があります。
TypeDescription
Data Catalog接続先のサーバー上のデータ カタログへの接続 string を含みます
Textstring 値を含みます
BooleanBoolean 値を含みます。取り得る値は YesNo です

関連項目