カスタム スキルを追加する

• 5 分

カスタム スキルをインデックス作成ソリューションに統合するには、Custom.WebApiSkill スキルの種類を使用して、そのスキルをスキルセットに追加する必要があります。

スキル定義では次を行う必要があります。

• 必要に応じて、パラメーターやヘッダーを含む、Web API エンドポイントの URI を指定する。
• コンテキストを設定して、ドキュメント階層内でスキルを呼び出すポイントを指定する。
• 入力値を割り当てる (通常は既存のドキュメント フィールドから)。
• 新しいフィールドに出力を格納する。ターゲット フィールド名の指定は任意です (指定しない場合は出力名が使用されます)。

{
    "skills": [
      ...,
      {
        "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
        "description": "<custom skill description>",
        "uri": "https://<web_api_endpoint>?<params>",
        "httpHeaders": {
            "<header_name>": "<header_value>"
        },
        "context": "/document/<where_to_apply_skill>",
        "inputs": [
          {
            "name": "<input1_name>",
            "source": "/document/<path_to_input_field>"
          }
        ],
        "outputs": [
          {
            "name": "<output1_name>",
            "targetName": "<optional_field_name>"
          }
        ]
      }
  ]
}

スキルセットには、ユース ケースに応じて、組み込みスキルとカスタム スキルの両方を含めることができます。 上の例にある skills 配列にはすべてのスキルが含まれており、カスタム スキル コードは検索サービスの外部で実行されます (該当する場合)。これについては、このモジュールの後半の演習で説明します。

次のユニットでは、追加の Azure リソースを使用して、特定の種類のカスタム スキルについて確認します。