翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# コンタクトをエージェントにルーティングするための事前定義された属性を作成する
<a name="predefined-attributes"></a>

事前定義された属性は、名前と値のペアで構成されます。例えば、`language` などの名前、`English`、`French`、`Japanese` などの値などです。キュー内のエージェントまたはエージェントのプールにコンタクトをルーティングするために、事前定義された属性を使用できます。

**ヒント**  
エージェントの習熟度レベルの定義は、事前定義された属性の作成時には行わずに、ユーザープロファイルで行います。習熟度レベルは、特定の属性値に対するエージェントの専門知識のレベルを 1 から 5 の範囲で示す指標です。レベル 1 は習熟度が最も低く、5 は最高です。

事前定義された属性は Connect Customer 、 管理ウェブサイトを使用して手動で作成および管理できます。手順については、このトピックで説明します。または、[事前定義された属性管理 API](#predefined-attributes-apis) を使用してプログラム的に行います。

**Topics**
+ [重要事項](#important-things-predefined-attributes)
+ [システムの事前定義された属性](#sytem-predefined-attributes)
+ [事前定義された属性を作成する](#predefined-attributes-create-web-admin)
+ [属性や値の名前を更新する](#update-predefined-attributes)
+ [事前定義された属性管理 API](#predefined-attributes-apis)

## 重要事項
<a name="important-things-predefined-attributes"></a>
+ 事前定義された属性の情報は暗号化されません。「[Amazon Connect での PII 準拠に関するベストプラクティス](compliance-validation-best-practices-PII.md)」に準拠することを強くお勧めします。
+ 属性ごとに最大 500 個の値を作成できます。
+ 事前定義された属性の**名前**の長さは最大 100 文字です。
+ 事前定義された属性の**値**の長さは最大 100 文字です。
+ 事前定義された属性名と値のパターンは、`^(?!(aws:|connect:))[\p{L}\p{Z}\p{N}_.:/=+-@']+$` です。例えば、文字、数値、空白記号、または `_.:/=+-@'` の特殊文字はすべて使用できます。ただし、先頭を `aws:` や `connect:` にすることはできません。
+ 重複する名前や値を持つ事前定義された属性を作成することはできません。また、大文字と小文字は区別されるため、重複する名前は使用できません。例えば、`Language` という名前が付けられた事前定義された属性が Amazon Connect インスタンスにある場合、`language` という名前の新しい事前定義された属性を作成することはできません。
+ 属性を削除できるのは、属性がいずれのエージェントにも関連付けられていない場合のみです。

  属性を削除する前に、その属性を持つエージェントを待っているコンタクトがないことを確認してください。確認を怠ると、コンタクトが一致を見つけられません。
+ Amazon Connect インスタンスで許可される事前定義された属性のクォータについては、「[Connect Customer クォータ](amazon-connect-service-limits.md#connect-quotas)」を参照してください。

## システムの事前定義された属性
<a name="sytem-predefined-attributes"></a>

`connect:` で識別されるシステム属性は、Amazon Connect が設定する事前定義された属性です。`connect:` の名前と値の変更または削除はできません。

以下のシステム属性を使用できます。
+ `connect:Language`。`connect:Language` について 500 のカスタム値を追加できます。
+ `connect:Subtype`。`connect:Subtype` は変更できないものの、ルーティングのルーティング条件として使用することはできます。

## 事前定義された属性を作成する
<a name="predefined-attributes-create-web-admin"></a>

1.  Connect Customer 管理者アカウント、または**ルーティング** - **事前定義された属性** - **アクセス**許可を持つセキュリティプロファイルに割り当てられたアカウントを使用して**、管理者**ウェブサイトにログインします。

1. Amazon Connect の左側のナビゲーションメニューで、**[ルーティング]**、**\\事前定義された属性]** を選択します。

1. 次の図に示すように、**[属性管理]** ページで、**[属性の追加]** を選択します。  
![[属性管理] ページ、[属性の追加] ボタン。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/add-attribute.png)

1. 必要に応じて、**[事前定義された属性を追加]** ページの **[詳細]** セクションの次のフィールドに入力します。

   1. **名前**: セグメント属性の名前を入力します。

   1. **連絡先検索フィルターとして使用**: このセグメント属性でコンタクト検索を有効にする場合に選択します。

   1. **詳細なインサイトを得るために分析で を使用する**: このセグメント属性で分析を有効にするかどうかを選択します。

      このオプションを表示するには、インスタンスに対して Amazon Connect 無制限 AI を有効にする必要があります。

      注: 属性の値は分析目的で使用されるため、個人を特定できる情報 (PII) を保存しないでください。

   1. **有効な値の強制**: この属性をコンタクトセグメント属性として使用する際、事前定義された値のみを許可する場合に選択します。

1. 属性に値を追加するには、**[値を追加]** を選択します。例えば、事業部門に「セールス」、「マーケティング」、「経理」と入力できます。  
![[保存] をクリックして、属性と値を保存します。](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/predefined-attribute-add.png)

1. **[保存]** をクリックして、定義済みの属性と値を保存します。

## 属性や値の名前を更新する
<a name="update-predefined-attributes"></a>

1. 今後のコンタクトでこの属性を使用するのをやめて、このコンタクトをアクティブコンタクトタイプでドレインします。

1. すべての属性を更新します。

## 事前定義された属性管理 API
<a name="predefined-attributes-apis"></a>
+ [CreatePredefinedAttribute](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePredefinedAttribute.html)
+ [UpdatePredefinedAttribute](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePredefinedAttribute.html)
+ [DeletePredefinedAttribute](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeletePredefinedAttribute.html)
+ [DescribePredefinedAttribute](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePredefinedAttribute.html)
+ [ListPredefinedAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListPredefinedAttributes.html)