この記事で説明する機能は、2026年5月11日から6月12日にかけて、すべてのSuiteプランおよびSupportプランを対象に順次利用可能になります。そのため、お客様のアカウントではこの機能がまだ表示されない場合があります。詳しくは、こちらの製品関連の告知をご覧ください。
複数のリクエストパラメータを受け付けるAPIであっても、APIコールを成功させるためにすべてのパラメータが必須であるとは限りません。パラメータが想定されているにもかかわらず指定されていない場合、APIは空文字列 "" または null などの有効な値を期待するため、インテグレーションが失敗する可能性があります。その場合、APIコールが中断されないように、インテグレーションビルダーでこれらのパラメータをnull化する必要があります。
オプションパラメータをnull化するには
- オプションパラメータの動作を理解します。
まず、APIがオプション値を空文字列または null として適切に処理できることを確認してください。 - チャットの開始時に、オプションパラメータをnullまたは空文字列に初期化します。
これにより、パラメータが省略された場合でもAPIコールが失敗するのを防ぐことができます。詳細については、「AIエージェントのアクションについて」を参照してください。
- インテグレーションビルダーのインテグレーションで、パラメータがリクエストパラメータとして収集され、「必須」チェックボックスがオフになっていることを確認してください。
- 「テスト値」入力ボックスにカーソルを合わせ、値の再フォーマットを示す記号が表示されるまで待ちます。
この記号をクリックすると、ダイアログが表示されます。「Reformatting JSONata」と書かれたテキストボックスに、次のJSONata式を追加します。
```$a and $not($a = "null") ? $a : ""```
このJSONata式は、パラメータが存在し、値が設定されているかどうかを確認します。- パラメータが存在し、値がある場合は、そのパラメータ値をAPIに渡します。
- パラメータが存在しない場合、または値がない場合は、空文字列を指定するか、完全に省略します。
値の再フォーマット方法の詳細については、「AIエージェント向けリクエストパラメータ値の再フォーマット」を参照してください。
これにより、APIコールにオプション値がある場合でも、インテグレーションビルダーでシームレスに処理されるようになります。