4.4. Ansible Lightspeed インテリジェントアシスタントのデプロイ
このセクションでは、OpenShift Container Platform に Ansible Lightspeed インテリジェントアシスタントをデプロイする際に必要な手順を説明します。
4.4.1. Ansible Automation Platform Operator のインストールと設定
Ansible Lightspeed インテリジェントアシスタントをデプロイして使用できるように、OpenShift Container Platform に Ansible Automation Platform Operator をインストールして設定します。
4.4.1.1. Ansible Automation Platform Operator のインストール
OpenShift Container Platform に Ansible Automation Platform Operator をインストールします。
手順
- Red Hat OpenShift Container Platform にログインします。
-
に移動します。 - Ansible Automation Platform を検索し、 をクリックします。
Update Channel を選択します。
- stable-2.x: namespace スコープ Operator をインストールします。これにより、Automation Hub および Automation Controller インスタンスのデプロイメントが、Operator がインストールされている namespace に制限されます。これは、ほとんどの場合に適しています。stable-2.x チャネルは管理者特権を必要とせず、単一の namespace のみを監視するため、使用するリソースが少なくなります。
- stable-2.x-cluster-scoped: すべての namespace で Ansible Automation Platform のカスタムリソースとデプロイメントを管理する単一の namespace に Ansible Automation Platform Operator をインストールします。Ansible Automation Platform Operator には、クラスター内のすべての namespace に対する管理者権限が必要です。
- Installation Mode、Installed Namespace、および Approval Strategy を選択します。
- をクリックします。
インストールプロセスが開始します。インストールが完了すると、指定した namespace に Ansible Automation Platform Operator がインストールされたことを通知するモーダルが表示されます。
検証
- をクリックして、新しくインストールされた Ansible Automation Platform Operator を表示し、次の Operator カスタムリソースが存在することを確認します。
Automation Controller | Automation Hub | Event-Driven Ansible (EDA) | Red Hat Ansible Lightspeed |
---|---|---|---|
|
|
|
|
- Ansible Automation Platform Operator に Succeeded ステータスが表示されていることを確認します。
4.4.1.2. Ansible Automation Platform Operator の設定
namespace に Ansible Automation Platform Operator をインストールした後、コンポーネントをプラットフォームゲートウェイにリンクするように Ansible Automation Platform Operator を設定します。
4.4.1.2.1. プラットフォームゲートウェイへのコンポーネントのリンク
namespace に Ansible Automation Platform Operator をインストールしたら、Ansible Automation Platform インスタンスを設定できます。その後、すべてのプラットフォームコンポーネントを単一のユーザーインターフェイスにリンクします。
手順
- Red Hat OpenShift Container Platform にログインします。
-
に移動します。 - Ansible Automation Platform Operator のデプロイメントを選択します。
- Details タブを選択します。
- Ansible Automation Platform タイルで、 をクリックします。
- Create Ansible Automation Platform ページで、Name フィールドにインスタンスの名前を入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow spec: database: resource_requirements: requests: cpu: 200m memory: 512Mi storage_requirements: requests: storage: 100Gi controller: disabled: false eda: disabled: false hub: disabled: false storage_type: file file_storage_storage_class: <read-write-many-storage-class> file_storage_size: 10Gi
spec: database: resource_requirements: requests: cpu: 200m memory: 512Mi storage_requirements: requests: storage: 100Gi controller: disabled: false eda: disabled: false hub: disabled: false storage_type: file file_storage_storage_class: <read-write-many-storage-class> file_storage_size: 10Gi
- をクリックします。
検証
Ansible Automation Platform Operator のデプロイメントに移動し、Ansible Automation Platform インスタンスと、デプロイされた AutomationController、EDA、および AutomationHub インスタンスが表示されるはずです。
をクリックして、すべてのインスタンスが正しくデプロイされているかどうかを確認します。ここに、
または、コマンドラインで確認することもできます。その場合は、oc get route
を実行します。
すべての Pod が正常に実行されていることを確認する必要もあります。以下の手順を実行します。
-
に移動します。 - YAML 設定ビューの namespace メタデータに名前が記載されているプロジェクトに切り替えます。
- すべての Pod に Running または Completed ステータスが表示されていること、エラーステータスが表示されている Pod がないことを確認します。
4.4.2. チャットボット設定シークレットの作成
Ansible Lightspeed インテリジェントアシスタントを Ansible Automation Platform Operator に接続できるように、インテリジェントアシスタントの設定シークレットを作成します。
手順
- Red Hat OpenShift Container Platform に管理者としてログインします。
-
に移動します。 - Projects リストから、Ansible Automation Platform Operator をインストールしたときに作成した namespace を選択します。
-
をクリックします。 -
Secret name フィールドに、シークレットの一意の名前を入力します。たとえば、
chatbot-configuration-secret
です。 次のキーと、キーに関連付ける値を個別に追加します。
キー 値 すべての LLM セットアップの設定
chatbot_model
お使いの LLM セットアップで設定されている LLM モデル名を入力します。
chatbot_url
お使いの LLM セットアップの推論 API ベース URL を入力します。たとえば、
https://your_inference_api/v1
です。chatbot_token
API トークンまたは API キーを入力します。このトークンは、推論 API が呼び出されたときに、認証ヘッダーとともに送信されます。
chatbot_llm_provider_type
任意
次のいずれかの値を使用して、お使いの LLM セットアップのプロバイダータイプを入力します。
-
Red Hat Enterprise Linux AI:
rhoai_vllm
(デフォルト値) -
Red Hat OpenShift AI:
rhelai_vllm
-
IBM watsonx.ai:
watsonx
-
OpenAI:
openai
-
Microsoft Azure OpenAI:
azure_openai
chatbot_context_window_size
任意
LLM セットアップのコンテキストウィンドウの長さを設定するには、値を入力します。
デフォルト=
128000
chatbot_temperature_override
任意
Temperature が低いと、予測可能な結果が生成されます。Temperature が高いと、より多様で創造的な回答が可能になります。
以下の値のいずれかを入力します。
-
0
: 回答の創造性とランダム性が最も低い。 -
1
: 回答の創造性とランダム性が最も高い。 null
: デフォルトの Temperature 設定をオーバーライドまたは無効にします。注記一部の OpenAI o シリーズモデル (o1、o3-mini、および o4-mini モデル) では、Temperature 設定がサポートされていません。したがって、これらの OpenAI モデルを使用するには、値を null に設定する必要があります。
IBM watsonx.ai のみの追加設定
chatbot_llm_provider_project_id
IBM watsonx セットアップのプロジェクト ID を入力します。
Microsoft Azure OpenAI のみの追加設定
chatbot_azure_deployment_name
Microsoft Azure OpenAI セットアップのデプロイメント名を入力します。
chatbot_azure_api_version
任意
Microsoft Azure OpenAI セットアップの API バージョンを入力します。
-
Red Hat Enterprise Linux AI:
- Create をクリックします。チャットボットの認可シークレットが正常に作成されます。
4.4.3. Ansible Automation Platform Operator の YAML ファイルの更新
チャットボットの認可シークレットを作成したら、そのシークレットを使用するように Ansible Automation Platform Operator の YAML ファイルを更新する必要があります。
手順
- Red Hat OpenShift Container Platform に管理者としてログインします。
-
に移動します。 - インストールされている Operator のリストから、Ansible Automation Platform Operator を選択します。
- Ansible Automation Platform カスタムリソースを見つけて選択し、必要なアプリケーションをクリックします。
- YAML タブを選択します。
テキストをスクロールして
spec:
セクションを見つけ、spec:
セクションの下に次の詳細を追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow spec: lightspeed: disabled: false chatbot_config_secret_name: <name of your chatbot configuration secret>
spec: lightspeed: disabled: false chatbot_config_secret_name: <name of your chatbot configuration secret>
- Save をクリックします。Ansible Lightspeed インテリジェントアシスタントサービスのセットアップには数分かかります。
検証
チャットインターフェイスサービスが正常に実行されていることを確認します。
-
に移動します。 api という用語でフィルタリングし、次の API に Running ステータスが表示されていることを確認します。
-
myaap-lightspeed-api-<version number>
-
myaap-lightspeed-chatbot-api-<version number>
-
-
Ansible Automation Platform にチャットインターフェイスが表示されることを確認します。
Ansible Automation Platform にアクセスします。
-
に移動します。 - インストールされている Operator のリストから、Ansible Automation Platform をクリックします。
- Ansible Automation Platform カスタムリソースを見つけて選択し、作成したアプリケーションをクリックします。
Details タブで、次のフィールドに利用可能な情報を記録します。
- URL: これは Ansible Automation Platform インスタンスの URL です。
- Gateway Admin User: これは、Ansible Automation Platform インスタンスにログインするためのユーザー名です。
- Gateway Admin password: これは、Ansible Automation Platform インスタンスにログインするためのパスワードです。
- 先ほど記録した URL、ユーザー名、パスワードを使用して、Ansible Automation Platform にログインします。
-
Ansible Lightspeed インテリジェントアシスタントにアクセスします。
-
タスクバーの右上隅に表示される Ansible Lightspeed インテリジェントアシスタントのアイコン
をクリックします。
次の画像のようにチャットインターフェイスが表示されることを確認します。
.
-
タスクバーの右上隅に表示される Ansible Lightspeed インテリジェントアシスタントのアイコン