すべてのプロダクト
Search
ドキュメントセンター

DataWorks:CreateAgent

最終更新日:Jun 11, 2026

エージェントの作成

操作説明

リクエストの説明

  • エージェント名: 現在のアカウント内で一意である必要があります。

  • モデル構成: エージェントで使用するモデルおよび関連設定を指定するためのオプションパラメータです。

  • 可視性レベル: エージェントへのアクセス権限を定義します。アカウント内、指定されたプロジェクト、または特定のユーザーへの可視性をサポートします。

  • 可視性スコープ: 可視性レベルとして PROJECT または USER を選択した場合、具体的なプロジェクト ID またはユーザー ID のリストをさらに指定する必要があります。

  • その他のパラメータ: 表示名や説明などの項目はオプションであり、実際のニーズに応じて記入できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

Name

string

必須

エージェントの名前。現在のアカウント内で一意である必要があります。

my-agent

DisplayName

string

任意

エージェントの表示名。

我的助手

Description

string

任意

エージェントの説明。

数据分析助手

Model

object

任意

モデルの構成。

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

SystemPrompt

string

任意

システムプロンプト。

你是一个数据分析助手。

Tools

array

任意

ツールのリスト。

-

string

任意

ツール情報。

-

Skills

array

任意

スキルのリスト。

-

string

任意

スキルの構成。

["my-skill"]

CallableAgents

array

任意

このエージェントから呼び出し可能なサブエージェントのリスト。

-

string

任意

エージェント名。

["agent-name"]

Metadata

object

任意

拡張メタデータ(キーと値のペア)。

{}

Visibility

string

任意

可視性レベル。
TENANT: アカウント内で可視。
PROJECT: 指定されたプロジェクトに対して可視。
USER: 指定されたユーザーに対して可視。

TENANT

VisibilityScope

object

任意

可視性のスコープ。Visibility に基づいて対応するフィールドが選択されます。

ProjectIds

array

任意

可視プロジェクト ID のリスト。Visibility が PROJECT の場合に有効です。

string

任意

ワークスペース ID のリスト。

[21791]

UserIds

array

任意

可視ユーザー ID のリスト。Visibility が USER の場合に有効です。

string

任意

可視ユーザー ID のリスト。Visibility が USER の場合に有効です。

[]

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

RequestId

string

リクエスト ID。

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

Agent

object

作成されたエージェントの詳細。

Name

string

エージェントの名前。

my-agent

GmtCreateTime

string

作成時刻(ミリ秒タイムスタンプ)。

1780555634000

GmtModifiedTime

string

最終更新時刻(ミリ秒タイムスタンプ)。

1780555634000

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。