アクション移行時の拡張機能のマッチングの理解
AIアシスタントのアクションスキルを移行する場合、アクションを別のAI アシスタントにコピーする場合、アクションを複製する場合、またはコールアウト設定を含むアクションをインポートする場合、システムは対象のAIアシスタント内で最も適合する拡張機能を使用しようとします。 このプロセスにより、移行後に別の拡張機能を指す操作など、予期しない動作が発生する可能性があります。
対象のAIアシスタントに、同じエンドポイント設定を持つ複数の拡張機能が含まれている場合（全体的な仕様が異なっていても）、システムがそのアクションを誤った拡張機能に関連付けてしまう可能性があります。
アクションをコピーまたはインポートする前に、 対象のAIアシスタントに必要な拡張機能がすでに設定されていることを確認してください。 この準備段階により、不一致が減少します。
不一致の理由
コールアウト設定が指定されている AIアシスタントのアクションスキルのステップには、マッチングアルゴリズムに関連する以下の側面があります。
コールアウトハッシュ
呼び出しパス
HTTP 動詞
コールアウトハッシュとは、 AIアシスタントのアクションスキルステップが使用するように設定されている、操作オブジェクト（/エンドポイント）の設定全体を表すハッシュ値のことです。 callout path および HTTP の動詞値は、 OpenAPI 拡張仕様のoperationオブジェクトにある同じ設定から導出されます。
スキル、アクション、またはステップをインポートする前に、システムは、 対象のAIアシスタントに、 ソースとなるAIアシスタントと同じ操作オブジェクトを定義する拡張機能がすでにインポートされていることを前提としています。
スキル、アクション、またはステップをインポートすると、システムは、AIアシスタントスキルのハッシュ、パス、および HTTP 動詞の値を、ターゲットとなるAIアシスタント拡張機能で利用可能な操作オブジェクトのリストと照合しようとします。 システムは、3つの条件すべてに合致する操作オブジェクトが見つからない場合、または対象の AI /aspects アシスタントのすべての拡張仕様において該当するオブジェクトが見つからない場合、不一致であると判断します。
複数の拡張仕様が同一の操作オブジェクト構成を定義する場合、システムは最初の一致する拡張仕様を使用します。
AIアシスタントビルダーシステムは、 OpenAPI 拡張仕様の操作オブジェクト仕様について、それらを参照解除することなくハッシュ値を生成します。 したがって、 OpenAPI 仕様書内で参照されているコンポーネントに対して行った変更は、ハッシュ生成プロセスでは反映されません。
拡張不一致を防止する方法
誤った拡張子の一致を防ぐには、次のいずれかの方法をご検討ください：
重複する拡張子を削除する
対象のAIアシスタントから、重複する操作オブジェクトの仕様を含む拡張機能を削除します。
重複する操作オブジェクトをクリーンアップする
拡張機能から重複する操作オブジェクトを削除し、一意性を確保する。
拡張機能を明示的にバージョン管理する
この方法は時間がかかり、変更された操作オブジェクトを参照するコールアウトの手動での再構成が必要になる可能性があります。
各拡張機能仕様に固有のバージョン識別子を割り当て、それらを以下に含める:
ドキュメントレベルの属性（名前、説明、概要）
各操作オブジェクト
これにより、すべての操作オブジェクトに対して一意のハッシュ値が保証されます