ChatCompletionSkill interface

Azure AI FoundryのChat Completionsエンドポイントを通じて言語モデルを呼び出しるスキルです。

Extends

プロパティ

apiKey

モデルに対して認証するための API キー。 apiKey と authIdentity の両方を同時に指定することはできません。

commonModelParameters

顧客が微調整できる共通の言語モデル パラメーター。 省略すると、合理的なデフォルトが適用されます。

extraParameters

チャット完了呼び出しに追加する必要があるモデル固有のパラメーターのオープン型ディクショナリ。 Azure AI Foundry の機能拡張パターンに従います。

extraParametersBehavior

Azure AI Foundryがどのように追加パラメータを扱うのか。 デフォルトは「error」です。

odatatype

ポリモーフィック識別子。このオブジェクトは、さまざまな型を指定します。

responseFormat

LLM が応答をどのようにフォーマットするかを決定します。 デフォルトは「テキスト」応答タイプです。

継承されたプロパティ

authIdentity

送信接続に使用されるユーザー割り当てマネージド ID。 authResourceId が指定されていて、指定されていない場合は、システム割り当てマネージド ID が使用されます。 インデクサーの更新時に、ID が指定されていない場合、値は変更されません。 「none」に設定すると、このプロパティの値はクリアされます。

authResourceId

Azure関数や変換を提供する他のアプリケーションで外部コードに接続するカスタムスキルに適用されます。 この値は、Azure Active Directoryに登録された際に機能やアプリのために作成されたアプリケーションIDであるべきです。 指定すると、カスタム スキルは、検索サービスのマネージド ID (システムまたはユーザー割り当て) と関数またはアプリのアクセス トークンを使用して関数またはアプリに接続します。この値は、アクセス トークンのスコープを作成するためのリソース ID として使用されます。

batchSize

ドキュメントの数を示す目的のバッチ サイズ。

context

ドキュメントのルートやドキュメントのコンテンツ (/document や /document/content など) など、操作が行われるレベルを表します。 既定値は /document です。

degreeOfParallelism

設定されている場合、Web API に対して実行できる並列呼び出しの数。

description

スキルの入力、出力、および使用方法を記述するスキルの説明。

httpHeaders

http 要求を行うために必要なヘッダー。

httpMethod

http 要求のメソッド。

inputs

スキルの入力には、ソース データ セット内の列、またはアップストリーム スキルの出力を指定できます。

name

スキルセット内で一意に識別されるスキルの名前。 名前が定義されていないスキルには、スキル配列内の 1 から始まるインデックスの既定の名前が付けられます。先頭には文字 '#' が付きます。

outputs

スキルの出力は、検索インデックス内のフィールドか、別のスキルによる入力として使用できる値のいずれかです。

timeout

要求に必要なタイムアウト。 既定値は 30 秒です。

uri

Web API の URL。

プロパティの詳細

apiKey

モデルに対して認証するための API キー。 apiKey と authIdentity の両方を同時に指定することはできません。

apiKey?: string

プロパティ値

string

commonModelParameters

顧客が微調整できる共通の言語モデル パラメーター。 省略すると、合理的なデフォルトが適用されます。

commonModelParameters?: CommonModelParameters

プロパティ値

extraParameters

チャット完了呼び出しに追加する必要があるモデル固有のパラメーターのオープン型ディクショナリ。 Azure AI Foundry の機能拡張パターンに従います。

extraParameters?: {[propertyName: string]: unknown}

プロパティ値

{[propertyName: string]: unknown}

extraParametersBehavior

Azure AI Foundryがどのように追加パラメータを扱うのか。 デフォルトは「error」です。

extraParametersBehavior?: string

プロパティ値

string

odatatype

ポリモーフィック識別子。このオブジェクトは、さまざまな型を指定します。

odatatype: "#Microsoft.Skills.Custom.ChatCompletionSkill"

プロパティ値

"#Microsoft.Skills.Custom.ChatCompletionSkill"

responseFormat

LLM が応答をどのようにフォーマットするかを決定します。 デフォルトは「テキスト」応答タイプです。

responseFormat?: ChatCompletionResponseFormat

プロパティ値

継承されたプロパティの詳細

authIdentity

送信接続に使用されるユーザー割り当てマネージド ID。 authResourceId が指定されていて、指定されていない場合は、システム割り当てマネージド ID が使用されます。 インデクサーの更新時に、ID が指定されていない場合、値は変更されません。 「none」に設定すると、このプロパティの値はクリアされます。

authIdentity?: SearchIndexerDataIdentity

プロパティ値

承元:WebApiSkill.authIdentity

authResourceId

Azure関数や変換を提供する他のアプリケーションで外部コードに接続するカスタムスキルに適用されます。 この値は、Azure Active Directoryに登録された際に機能やアプリのために作成されたアプリケーションIDであるべきです。 指定すると、カスタム スキルは、検索サービスのマネージド ID (システムまたはユーザー割り当て) と関数またはアプリのアクセス トークンを使用して関数またはアプリに接続します。この値は、アクセス トークンのスコープを作成するためのリソース ID として使用されます。

authResourceId?: string

プロパティ値

string

承元WebApiSkill.authResourceId

batchSize

ドキュメントの数を示す目的のバッチ サイズ。

batchSize?: number

プロパティ値

number

承元WebApiSkill.batchSize

context

ドキュメントのルートやドキュメントのコンテンツ (/document や /document/content など) など、操作が行われるレベルを表します。 既定値は /document です。

context?: string

プロパティ値

string

承元WebApiSkill.context

degreeOfParallelism

設定されている場合、Web API に対して実行できる並列呼び出しの数。

degreeOfParallelism?: number

プロパティ値

number

承元WebApiSkill.degreeOfParallelism

description

スキルの入力、出力、および使用方法を記述するスキルの説明。

description?: string

プロパティ値

string

承元WebApiSkill.description

httpHeaders

http 要求を行うために必要なヘッダー。

httpHeaders?: {[propertyName: string]: string}

プロパティ値

{[propertyName: string]: string}

WebApiSkill.httpHeadersから継承

httpMethod

http 要求のメソッド。

httpMethod?: string

プロパティ値

string

承元WebApiSkill.httpMethod

inputs

スキルの入力には、ソース データ セット内の列、またはアップストリーム スキルの出力を指定できます。

inputs: InputFieldMappingEntry[]

プロパティ値

承元WebApiSkill.inputs

name

スキルセット内で一意に識別されるスキルの名前。 名前が定義されていないスキルには、スキル配列内の 1 から始まるインデックスの既定の名前が付けられます。先頭には文字 '#' が付きます。

name?: string

プロパティ値

string

承元WebApiSkill.name

outputs

スキルの出力は、検索インデックス内のフィールドか、別のスキルによる入力として使用できる値のいずれかです。

outputs: OutputFieldMappingEntry[]

プロパティ値

WebApiSkill.outputsから継承

timeout

要求に必要なタイムアウト。 既定値は 30 秒です。

timeout?: string

プロパティ値

string

WebApiSkill.timeoutから継承

uri

Web API の URL。

uri: string

プロパティ値

string

承元WebApiSkill.uri