All Products
Search
Document Center

DataWorks:CreateAgent

Last Updated:Jun 11, 2026

Membuat Agen.

Deskripsi operasi

Request Description

  • Agent Name: Must be unique under the current account.

  • Model Configuration: An optional parameter used to specify the model used by the Agent and its related settings.

  • Visibility Level: Defines who can access the Agent. Supports visibility within the account, to specified projects, or to specific users.

  • Visibility Scope: When PROJECT or USER is selected as the visibility level, the specific project ID or user ID list must be further specified.

  • Other Parameters: Items such as display name and description are optional and can be filled in based on actual needs.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama Agen. Harus unik dalam akun saat ini.

my-agent

DisplayName

string

No

Nama tampilan Agen.

我的助手

Description

string

No

Deskripsi Agen.

数据分析助手

Model

object

No

Konfigurasi model.

{ "modelName": "dataworks-public-bailian/qwen-max" }

SystemPrompt

string

No

Prompt sistem.

你是一个数据分析助手。

Tools

array

No

Daftar alat.

-

string

No

Tool information.

-

Skills

array

No

Daftar keterampilan.

-

string

No

Skill configuration.

["my-skill"]

CallableAgents

array

No

Daftar sub-Agen yang dapat dipanggil oleh Agen ini.

-

string

No

Agent name.

["agent-name"]

Metadata

object

No

Metadata tambahan (pasangan kunci-nilai).

{}

Visibility

string

No

Tingkat visibilitas.
TENANT: Terlihat dalam akun.
PROJECT: Terlihat untuk proyek tertentu.
USER: Terlihat untuk pengguna tertentu.

TENANT

VisibilityScope

object

No

Cakupan (dalam OAuth) visibilitas. Bidang yang sesuai dipilih berdasarkan Visibility.

ProjectIds

array

No

The list of visible project IDs. Takes effect when Visibility is PROJECT.

string

No

List of workspace IDs.

[21791]

UserIds

array

No

The list of visible user IDs. Takes effect when Visibility is USER.

string

No

The list of visible user IDs. Takes effect when Visibility is USER.

[]

Elemen respons

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

824F80BA-1778-5D8A-BAFF-668A4D9C4CC7

Agent

object

Details of the created Agent.

Name

string

The name of the Agent.

my-agent

GmtCreateTime

string

The creation time (millisecond timestamp).

1780555634000

GmtModifiedTime

string

The last modification time (millisecond timestamp).

1780555634000

Contoh

Respons sukses

JSONformat

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "Agent": {
    "Name": "my-agent",
    "GmtCreateTime": "1780555634000",
    "GmtModifiedTime": "1780555634000"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.