スキルベース・アクション・プロバイダーのAPIの実装

スキルプロバイダーのAPI仕様の詳細については、会話スキルを参照してください：Pro-Code Conversational Skill Clientで実装するAPIエンドポイントのマスタードキュメント を参照してください。

会話スキルのためにJavaSDKを使用することもできます。 詳細は、 会話スキル Javaの会話スキル watsonx Assistant をご覧ください。

スキル・ベース・アクション・プロバイダーの登録

エンドポイントを作成した後、スキルベースのアクションプロバイダー watsonx Assistant に登録する必要があります。 その方法の詳細については、会話スキルプロバイダーの登録 を参照してください。

異なるスキーマでの認証の例がもっと必要な場合は、会話スキル・プロバイダを作成する を参照してください。

APIを使用してスキルベースのアクションを作成する

APIを使用してスキルベースのアクションを作成するには、まず、スキルプロバイダーのエンドポイントを参照するスキルのOpenAPI仕様を作成する必要があります。

OAS エディターか、watsonx Orchestrate OpenAPI Builder を使って、このタスクを完了できます。 詳細は、watsonx Orchestrate ドキュメントの Building OpenAPI specifications for skills を参照してください。

その後、 watsonx Assistantの Import skillsエンドポイント を使用してスキルをインポートできます。 それが終わったら、アシスタントのスキルを使うことができる。

UIを使ったスキルの創造

また watsonx Assistant を使用してスキルベースのアクションを作成することもできます。

UIからスキルベースのアクションを作成するには、スキルプロバイダーのAPIが 会話スキルのリスト エンドポイントを実装している必要があります。

スキルのアクションは、他のアクションからの入力値の取得や、出力値の他のアクションへのマッピングをサポートしていません。

スキルベースのアクションを作成するには、以下の手順に従います

1. watsonx Assistantで 、[アクション] > [新しいアクション] > [スキルベースのアクション] に移動します。

2. スキルからアクションを作成するページで、アクションをリンクさせたいスキルをクリックし、スキルをアクションの土台にします。

   このステップでオプションとして表示されるには、そのスキルのアプリに接続する必要があります。 詳しくは、 接続の管理とアプリへの接続 をご覧ください。

3. アクションの名前フィールドに、アクションの名前を入力します。

4. アクション条件の追加では、アクショントリガーの条件を追加・編集することができます。

   詳細については、 アクションに条件を追加するを参照してください

5. フレーズを入力してくださいフィールドに、顧客がスキルを発動させるために入力または尋ねるフレーズを入力します。 例えば、I want to pay my electricity bills です。

6. ページの右上にある以下のオプションを使用して、アシスタント体験を向上させます：

   • アクション・レスポンス・モード

     Clarifying や Confident のように、アシスタントの応答モードを定義します。

   • アクションノート

     アクションノートウィンドウを開き、説明、ドキュメント、コメント、その他の注釈を追加して、アクションを構築する際の作業追跡に役立てることができます。

   • アクション設定

     アクションの設定ウィンドウを開き、明確な質問をすると会話のトピックを変更するアクションの設定を有効または無効にします。

7. 保存ボタンをクリックしてアクションを保存します。

アシスタントが新しく作成したアクションを使えるようになります。