跳到主要內容

已不再支援此瀏覽器。

請升級至 Microsoft Edge,以利用最新功能、安全性更新和技術支援。

下載 Microsoft Edge Internet Explorer 和 Microsoft Edge 的詳細資訊
microsoft-foundry.rest.security.o-auth2-auth

DataGenerationJobs

Create a data generation job

POST /data_generation_jobs

Submits a new data generation job for asynchronous execution. Requests with type set to conversations, or traces with generate_test_case_rubric set to true, require Foundry-Features: DataGenerationJobs=V1Preview; the service rejects these requests without this opt-in. Ordinary turn-level trace requests without rubric generation do not require the header. Conversation samples require scenario to be evaluation. Jobs with type: conversations reconstruct existing traced conversations, use sources of type traces, and do not support sample_level. The generate_test_case_rubric flag is supported for both trace and conversation jobs and requires a nonempty model_options.model when true. The conversation-only generate_test_case_description flag also requires a nonempty model_options.model when true. For conversation jobs, model options must be omitted when neither flag is enabled. Create, get, and list responses preserve type: conversations. The response includes the effective generation settings.

標頭參數

Foundry-Features enum

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

DataGenerationJobs=V1Preview
Operation-Id string

Client-generated unique ID for idempotent retries. When absent, the server creates the job unconditionally.

查詢參數

api-version string 必要

The API version to use for this operation.

要求本文

The data generation job inputs to create.

Content-Type: application/json
下列其中一項:
evaluation EvaluationDataGenerationJobInputs

Caller-supplied inputs for an evaluation data generation job.

scenario enum 必要

The scenario of the data generation job, which is Evaluation for this model.

evaluation
output_configuration EvaluationDataGenerationJobOutputConfiguration

Dataset output configuration for an evaluation data generation job.

name string

Dataset name to assign to the output.

description string

Description to assign to the output dataset.

tags object

Tags to assign to the output dataset.

[key: string] string
write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
supervised_finetuning_preview SupervisedFineTuningDataGenerationJobInputs

Caller-supplied inputs for a supervised fine-tuning data generation job. This is a preview feature.

scenario enum 必要

The scenario of the data generation job, which is Supervised Fine-tuning preview for this model.

supervised_finetuning_preview
output_configuration SupervisedFineTuningDataGenerationJobOutputConfiguration

File output configuration for a supervised fine-tuning data generation job. This is a preview feature.

name string 必要

Filename to assign to the generated fine-tuning file.

write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
merge_file_id string

File ID to merge into when write_mode is merge.

reinforcement_finetuning_preview ReinforcementFineTuningDataGenerationJobInputs

Caller-supplied inputs for a reinforcement fine-tuning data generation job. This is a preview feature.

scenario enum 必要

The scenario of the data generation job, which is Reinforcement Fine-tuning preview for this model.

reinforcement_finetuning_preview
output_configuration ReinforcementFineTuningDataGenerationJobOutputConfiguration

File output configuration for a reinforcement fine-tuning data generation job. This is a preview feature.

name string 必要

Filename to assign to the generated fine-tuning file.

write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
merge_file_id string

File ID to merge into when write_mode is merge.

回覆

The request has succeeded and a new resource has been created as a result.

標題

Operation-Location string 必要

URL to poll for the job status.

Location string 必要

URL of the created job resource.

主體

Content-Type: application/json
下列其中一項:
evaluation EvaluationDataGenerationJob

Evaluation data generation job resource.

scenario enum 必要

The scenario of the data generation job, which is Evaluation for this model.

evaluation
output_configuration EvaluationDataGenerationJobOutputConfiguration

Dataset output configuration for an evaluation data generation job.

name string

Dataset name to assign to the output.

description string

Description to assign to the output dataset.

tags object

Tags to assign to the output dataset.

[key: string] string
write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
supervised_finetuning_preview SupervisedFineTuningDataGenerationJob

Supervised fine-tuning data generation job resource. This is a preview feature.

scenario enum 必要

The scenario of the data generation job, which is Supervised Fine-tuning preview for this model.

supervised_finetuning_preview
output_configuration SupervisedFineTuningDataGenerationJobOutputConfiguration

File output configuration for a supervised fine-tuning data generation job. This is a preview feature.

name string 必要

Filename to assign to the generated fine-tuning file.

write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
merge_file_id string

File ID to merge into when write_mode is merge.

reinforcement_finetuning_preview ReinforcementFineTuningDataGenerationJob

Reinforcement fine-tuning data generation job resource. This is a preview feature.

scenario enum 必要

The scenario of the data generation job, which is Reinforcement Fine-tuning preview for this model.

reinforcement_finetuning_preview
output_configuration ReinforcementFineTuningDataGenerationJobOutputConfiguration

File output configuration for a reinforcement fine-tuning data generation job. This is a preview feature.

name string 必要

Filename to assign to the generated fine-tuning file.

write_mode string | enum

The supported write modes for data generation job outputs.

以下任何一項:
string
enum
overwritemerge
merge_file_id string

File ID to merge into when write_mode is merge.

Client error

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Server error

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Request

POST /data_generation_jobs HTTP/1.1

回應

Status: 201
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
zh-tw
您的隱私權選擇
  • AI 免責聲明
  • 舊版本
  • 部落格
  • 參與
  • 隱私權
  • 消費者健康隱私
  • 使用規定
  • 商標
  • © Microsoft 2026