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

# Visier エージェント統合
<a name="visier-integration"></a>

Visier エージェントアクションコネクタを使用すると、自然言語を通じて Amazon Quick で Visier の人事分析プラットフォームに直接アクセスできます。Amazon Quick を離れることなく、ライブワークフォースデータのクエリ、人員数の傾向の分析、保持状態の評価、ワークフォース概要の作成などを行うことができます。

Visier エージェントはカスタム OAuth アプリ認証を使用します。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="visier-integration-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ API アクセスと Visier エージェントが有効になっているアクティブな Visier アカウント。Visier エージェントを有効にして認証を設定する方法については、[Visier MCP サーバーのドキュメント](https://docs.visier.com/developer/agents/mcp/mcp-server-set-up.htm)を参照してください。
+ クエリするワークフォースデータに対して Visier アカウントで設定された適切なデータアクセススコープ。
+ Visier 管理者からの OAuth 認証情報 (クライアント ID とクライアントシークレット）。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Visier の設定
<a name="visier-source-setup"></a>

Amazon Quick を設定する前に、Visier 管理コンソールで次の手順を実行します。

1. Visier 管理者コンソールにサインインし、アカウントがアクティブであることを確認します。

1. **設定**、**API、統合**で Visier エージェント機能を有効にします。

1. Amazon Quick に OAuth クライアントを登録し、リダイレクト URIs のリストに Amazon Quick コールバック URL を追加します。 `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   {{{region}}} を自分のリージョン (例: ) に置き換えますAWS`us-east-1`。

1. **クライアント ID** と**クライアントシークレット**を記録します。Amazon Quick を設定するときに必要になります。

1. クエリするワークフォースデータと分析にアカウントがアクセスできることを確認します。

## Amazon Quick でのコネクタのセットアップ
<a name="visier-quicksuite-setup"></a>

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **Visier エージェント**を検索して選択します。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明を追加** を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定で**、**カスタム OAuth アプリ**を選択し、次のフィールドを設定します。
   + **ベース URL** – Amazon Quick によって事前に入力された Visier エージェント MCP ベース URL。
   + **クライアント ID** – Visier 管理コンソールの OAuth クライアント ID。
   + **パブリック OAuth クライアント** (オプション) – Visier OAuth クライアントがパブリッククライアント (クライアントシークレットなし) として設定されている場合は、このオプションを選択します。
   + **クライアントシーク**レット – Visier 管理コンソールからの OAuth クライアントシークレット。
   + **トークン URL** – Amazon Quick によって事前に入力された OAuth トークンエンドポイント。
   + **認可 URL** – Amazon Quick によって事前に入力された OAuth 認可エンドポイント。
   + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

1. [**次へ**] を選択します。

1. 表示される Visier サインインポップアップで、Visier 認証情報を入力し、**サインイン**を選択して Amazon Quick がユーザーに代わって Visier にアクセスすることを許可します。

1. **レビュー**ページで、Amazon Quick は Visier Agent が公開するツールを検出し、テーブルに表示します。使用可能なアクションのリストを確認し、**次へ**を選択します。

1. **公開**ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

1. **[公開]** を選択します。

## 使用可能なアクション
<a name="visier-integration-actions"></a>

コネクタを設定したら、次のアクションを使用できます。Visier エージェントは、その人材分析機能を呼び出し可能なツールとして公開します。


**Visier エージェントが使用できるアクション**  

| [アクション] | 説明 | 
| --- | --- | 
| ask\_vee\_question | Visier の Vee AI に、人員数、ターンオーバー、人員配置などの自然言語ワークフォースの質問をします。 | 
| aggregate\_metric\_values | メトリクスの集計値を計算します。オプションでディメンション別にグループ化され、特定のメンバー別にフィルタリングされます。 | 
| sample\_vee\_questions | Vee に開始を求めることができるサンプル質問のリストを返します。 | 
| search\_analytic\_objects | 検索文字列に一致する分析オブジェクト (従業員や申請者など) を検索します。 | 
| search\_analytic\_object\_properties | 特定の分析オブジェクトで使用できるすべてのプロパティを返します。 | 
| list\_analytic\_object\_property\_values | 従業員の在職期間や給与など、特定の分析オブジェクトメンバーのプロパティ値を一覧表示します。 | 
| search\_metrics | 検索文字列に一致するメトリクスを検索します。 | 
| search\_dimensions\_for\_metric | 特定のメトリクスで使用できるディメンションを検索し、グループ化またはフィルタリングに使用できます。 | 
| search\_dimensions\_for\_analytic\_object | 特定の分析オブジェクトで使用できるディメンションを検索します。 | 
| search\_filter\_dimension\_members | 特定のディメンションのフィルタリング可能なメンバーを返します。 | 
| get\_object\_reference\_graph | 特定の分析オブジェクトが他のオブジェクトに接続する方法を示す参照グラフを返します。 | 

## の管理とトラブルシューティング
<a name="visier-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="visier-troubleshooting-auth"></a>
+ **MCP サーバー接続が失敗**する – **設定**、**API、統合**の Visier 管理者コンソールで Visier エージェント機能を有効にしたことを確認します。Amazon Quick でベース URL、トークン URL、認可 URL が正しく入力されていることを確認します。
+ **無効なクライアント認証情報** – クライアント ID とクライアントシークレットが Visier 管理者コンソールの値と一致していることを確認します。Visier OAuth クライアントのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **データアクセスエラー** – Visier アカウントで設定されたデータアクセススコープに、クエリしようとしているワークフォースデータが含まれていることを確認します。Visier 管理者に連絡して、アカウントのアクセス許可を確認してください。
+ **ツールが検出され**ない – コネクタの作成後に Amazon Quick がツールを検出しない場合は、Visier Agent がアクティブであり、認証情報の有効期限が切れていないことを確認します。