ツールの追加
ツールはエージェントワークフローに追加でき、エージェントが外部システムとやり取りしたり、操作を実行したり、フロー内のステップを自動化したりできるようにします。
エージェントワークフローにツールを追加するには：
以下のオプションから1つを選んでください：
「ワークフロー項目
を追加」アイコンをクリックします。 ツールタブを選択します。開始ノードと終了ノードの間の接続線をクリックし、「 ツールを呼び出す 」を選択します。
ローカルインスタンスからツールを選択してください。
エージェントワークフローにメンバー認証情報を使用するツールを追加する
エージェントワークフローに、接続にメンバー認証情報を使用するツールを追加できます。 メンバー認証情報の詳細については、 「認証情報の種類」 を参照してください。
実行時にメンバーの認証情報が利用できない場合、システムはチャットで認証情報の入力を促します。 ツールが認証情報を必要とする複数の接続を使用する場合、システムは実行時に必要に応じて、各認証情報の入力を求めます。
メンバー認証情報で接続が正常に確立されると、システムは 「管理 > 接続 > 認証情報 」タブにその認証情報を保存します。 接続が成功した後、再度認証情報の入力を求められることはありません。 ただし、接続に時間ベースの認証を使用するツールでは、指定された時間間隔後にチャット内で認証情報の再入力が求められる場合があります。
エラー処理を管理する
エラー処理は、ワークフロー内のツールの障害を管理します。 ツールが失敗した場合、ワークフローを設定して、その操作を自動的に再試行させることができます。 再試行が失敗した場合、ワークフローはユーザーにカスタムエラーメッセージを表示するか、設定に基づいて別の失敗処理フローに進みます。 この機能により、ワークフローにおけるエラーの管理が可能となり、ワークフロー全体の信頼性が向上します。
ツールのエラー処理の設定
ツールのエラー処理を設定するには：
ワークフロービルダーでツールを選択してください。
「エラー処理」 の横にある
をクリックします。「 エラー処理」 で、 「エラー発生時に再試行」 スイッチをオンに設定します。
「エラー時の再試行」 設定を構成します：
再試行の最大回数 ：再試行の回数（1～5回）を指定します。
再試行間の待機時間（ms） ：再試行の間の遅延時間をミリ秒単位で指定します（1000～60000）。 デフォルト値は1000ミリ秒です。
[エラー発生時] セクションで、ツールが失敗した際のワークフローの対応方法を選択します。
失敗してエラーメッセージを表示する ：ワークフローは失敗したツールで停止し、エラーメッセージが表示されます。 「エラーメッセージ 」フィールドに、ツールが失敗した際に表示されるカスタムメッセージを入力してください。 このオプションがデフォルトの動作です。
失敗ブランチを作成 ：ツールが失敗した場合、ワークフローは別の失敗パスに沿って処理を続行します。 ワークフロービルダーでは、失敗したノードから「 失敗」ブランチが表示され、失敗経路の次のアクティビティを追加するオプションが表示されます。
ワークフロービルダーのツール上に再試行インジケーターが表示されます。
エラー処理の設定が完了した後、 「作成失敗ブランチ」 から 「失敗してエラーメッセージを送信」 に切り替えると、確認ダイアログが表示されます。 変更を確認すると、ワークフローから既存の失敗ブランチコネクタが削除されます。
エラー処理が設定されているツールでは、ツールのプロパティに、再試行の設定とエラー処理の方法がまとめられた概要が表示されます。
再試行に対応しているエラーコード
自動再試行では、以下のエラーコードがサポートされています：
408 リクエストタイムアウト：クライアントからのリクエスト送信に時間がかかりすぎました。 再試行は成功する可能性があります。
409 競合：バージョンの競合を示します。 競合が解消されたら、再度試してください。
425 早すぎます：リクエストの送信が早すぎました。 後で再試行してください。
429 リクエストが多すぎます：スロットリングが発生していることを示します。 「Retry After」ヘッダーで指定された遅延時間が経過した後、再試行します。
500 Internal Server Error：一時的なサーバーエラーが発生したことを示します。
502 Bad Gateway：一時的なプロキシまたはサーバーの問題を示しています。 再試行は成功する可能性があります。
503 サービス利用不可：サーバーが一時的に利用できないか、メンテナンス中であることを示します。
504 ゲートウェイタイムアウト：アップストリームサーバーが期限内に応答しなかったことを示します。 再試行は成功する可能性があります。