Conversation Authoring Project - Train

Szolgáltatás:: Azure AI Services

API-verzió:: 2025-11-01

Betanítási feladatot indít el egy projekthez.

POST {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/:train?api-version=2025-11-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
Endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpont, például https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	A használni kívánt projekt neve.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
modelLabel	True	string	A kimeneti modell címkéjét jelöli.
trainingMode	True	TrainingMode	A betanítási művelet módját jelöli.
evaluationOptions		AnalyzeConversationAuthoringEvaluationOptions	A kiértékelési lehetőségeket jelöli. Alapértelmezés szerint a kiértékelés típusa százalékos, a betanítás felosztási százaléka 80, a tesztelés felosztási százaléka pedig 20.
trainingConfigVersion		string	A betanítási konfiguráció verzióját jelöli. Alapértelmezés szerint a "legújabb" értéket használja, amely a legújabb kiadott betanítási konfigurációs verziót használja.

Válaszok

Name	Típus	Description
202 Accepted		A kérelmet feldolgozásra elfogadták, de a feldolgozás még nem fejeződött be. Fejlécek Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Name

Típus

Description

202 Accepted

A kérelmet feldolgozásra elfogadták, de a feldolgozás még nem fejeződött be.

Fejlécek

Operation-Location: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize
Jogkivonat URL-címe: https://login.microsoftonline.com/common/oauth2/token

Hatókörök

Name	Description
https://cognitiveservices.azure.com/.default

Példák

Successful Train Project

Mintakérelem

HTTP

POST {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/:train?api-version=2025-11-01

{
  "modelLabel": "model1",
  "trainingMode": "standard",
  "trainingConfigVersion": "latest",
  "evaluationOptions": {
    "kind": "percentage",
    "testingSplitPercentage": 20,
    "trainingSplitPercentage": 80
  }
}

Mintaválasz

Állapotkód:: 202

operation-location: {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01

Definíciók

Name	Description
AnalyzeConversationAuthoringEvaluationOptions	A kiértékelés futtatásához használt beállításokat jelöli.
AnalyzeConversationAuthoringTrainingJobOptions	Új képzési feladat megkezdésének lehetőségeit jelöli.
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
EvaluationKind
TrainingMode

AnalyzeConversationAuthoringEvaluationOptions

Tárgy

A kiértékelés futtatásához használt beállításokat jelöli.

Name	Típus	Description
kind	EvaluationKind	A kiértékelési típust jelöli. Alapértelmezés szerint a kiértékelés típusa százalékra van állítva.
testingSplitPercentage	integer (int32)	A tesztelési adatkészlet felosztási százalékát jelöli. Csak akkor szükséges, ha a kiértékelés típusa százalékos.
trainingSplitPercentage	integer (int32)	A betanítási adatkészlet felosztási százalékát jelöli. Csak akkor szükséges, ha a kiértékelés típusa százalékos.

AnalyzeConversationAuthoringTrainingJobOptions

Tárgy

Új képzési feladat megkezdésének lehetőségeit jelöli.

Name	Típus	Description
evaluationOptions	AnalyzeConversationAuthoringEvaluationOptions	A kiértékelési lehetőségeket jelöli. Alapértelmezés szerint a kiértékelés típusa százalékos, a betanítás felosztási százaléka 80, a tesztelés felosztási százaléka pedig 20.
modelLabel	string	A kimeneti modell címkéjét jelöli.
trainingConfigVersion	string	A betanítási konfiguráció verzióját jelöli. Alapértelmezés szerint a "legújabb" értéket használja, amely a legújabb kiadott betanítási konfigurációs verziót használja.
trainingMode	TrainingMode	A betanítási művelet módját jelöli.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Az Azure REST API irányelvei szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

EvaluationKind

Felsorolás

Érték	Description
percentage	Ossza fel az adatokat betanítási és tesztkészletekre a felhasználó által megadott százalékok szerint.
manual	Ossza fel az adatokat a kiválasztott adatkészlet szerint az adatok minden példájához.

TrainingMode

Felsorolás

Érték	Description
advanced	Finomhangolt neurális hálózati transzformátormodelleket használó betanítások. Többnyelvű projekteket tud képezni.
standard	Gyorsabb betanítási idők a gyorsabb iterációk érdekében.