All Products
Search

This Product

    Database Autonomy Service:Chat

    Document Center

    Database Autonomy Service:Chat

    Last Updated:Oct 12, 2026

    Memanggil antarmuka logika asinkron untuk kemampuan model Tingkat Tinggi DAS.

    Deskripsi operasi

    Sebelum memulai:

    • Gunakan versi terbaru dari Alibaba Cloud atau DAS SDK.

    • Saat menggunakan SDK untuk memanggil layanan DAS, tentukan wilayah sebagai cn-shanghai.

    • Hanya instans database dengan DAS Edisi Perusahaan yang diaktifkan yang mendukung pembuatan tugas offline. Untuk database dan wilayah yang didukung oleh setiap edisi DAS Edisi Perusahaan, lihat Edisi DAS dan fitur yang didukung.

    Untuk metode dan contoh lainnya tentang cara menggunakan antarmuka Chat untuk berinteraksi dengan Agen DAS, lihat Praktik terbaik untuk interaksi Agen DAS (integrasi API Chat).

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    hdm:Chat

    get

    *All resources.

    *

    		 None None

    Sintaks permintaan

    POST /chat HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Message

    string

    No

    Paket.

    {"id":"68fe0321-37fe-4c75-a118-b61b33156f6a","role":"user","content":[{"type":"text","text":"hello"}]}
    SessionId

    string

    No

    Opsional. ID sesi, yang merupakan string UUID. Jika tidak ditentukan, sesi baru akan dibuat secara default. ID sesi yang sama harus dipertahankan untuk percakapan kontekstual.

    123e4567-e89b-12d3-a456-xxxxxxxxxxxx
    AgentId

    string

    No

    Opsional. ID agen yang digunakan untuk layanan. Anda dapat menentukan agen yang dihasilkan setelah mengaktifkan Agen DAS atau agen yang dibuat secara manual. Jika tidak ditentukan, agen default akan digunakan.

    ag-472T0DxtmjIxxxxx
    Summary

    string

    No

    Apakah akan mengeluarkan informasi ringkasan.

    false
    Resume

    string

    No

    Umpan balik interaksi pengguna.

    [{"metadata":{"a2uiClientDataModel":{"decided":true,"interaction":{"request":{"allowFreeText":true,"question":"question?","options":[{"label":"162","value":"162"},{"label":"242","value":"242"},{"label":"243","value":"243"},{"label":"486","value":"486"}]},"kind":"choice","interruptId":"5857955e-4856-4ab3-969e-f8b4c484bda4","status":"pending"},"free_text":""},"a2uiAction":{"name":"das_interaction_response","context":{"value":"162"},"surfaceId":"render-choice-7c03eb4f927f42ff8c30b30a2cc0797d","sourceComponentId":"opts-0","timestamp":"2026-09-15T06:54:15.556Z"}},"payload":{"value":"162"},"interruptId":"5857955e-4856-4ab3-969e-f8b4c484bda4","status":"resolved"}]

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Tanggapan.

    ActivityType

    string

    Heartbeat.

    waiting_for_agent_thinking
    AgentId

    string

    ID agen.

    agent-7f9c2a81
    Content

    string

    Konten tanggapan.

    I see you have several PolarDB instances, and I will query them for you shortly
    Delta

    string

    Apakah konten bersifat inkremental.

    hello
    Kind

    string

    Tipe langkah untuk STEP_STARTED, seperti tugas.

    task
    Label

    string

    Nama tampilan agen anak untuk STEP_STARTED.

    SQL performance diagnostics
    MessageId

    string

    ID paket.

    61820b594664275c4429****
    Name

    string

    Kunci ekstensi.

    summary
    OriginatingToolCallId

    string

    ID asli pemanggilan alat.

    ag-xxxx
    ParentAgentId

    string

    ID agen induk.

    agent-3a6f1c92
    ParentMessageId

    string

    ID paket induk.

    76bee207-31ee-4707-8851-6b9d4da033aa
    Role

    string

    ID peran percakapan.

    assistant
    RunId

    string

    ID run.

    ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7
    StepName

    string

    Nama langkah eksekusi.

    sub_agent_performance_diagnose_mysql
    StepStatus

    string

    Status langkah untuk STEP_FINISHED, seperti completed.

    completed
    TaskTrackerId

    string

    Kelas alat callback.

    das_api
    ThreadId

    string

    ID thread.

    8e481be1-21d5-4a92-a2fb-fb54be0ab4f6
    Timestamp

    integer

    Stempel waktu event.

    1767225600000
    ToolCallError

    string

    Error yang terjadi saat memanggil alat.

    error
    ToolCallId

    string

    ID pemanggilan alat.

    call_edf9cdb69e0e4c9796a6a5a6
    ToolCallName

    string

    Nama alat.

    das_api
    Type

    string

    Tipe event.

    TEXT_MESSAGE_CONTENT
    Value

    any

    Nilai ekstensi.

    {"CharCount":393,"End":1777428785996,"RequestId":"BE59AED5-D831-5811-BBAD-590B917B2089","SessionId":"123e4567-e89b-12d3-a456-xxxxxxxxxxxx","Start":1777428707927}

    Contoh

    Respons sukses

    JSONformat

    {
  "ActivityType": "waiting_for_agent_thinking",
  "AgentId": "agent-7f9c2a81",
  "Content": "Saya melihat Anda memiliki beberapa instans PolarDB, dan saya akan mengkuerinya untuk Anda sebentar lagi",
  "Delta": "halo",
  "Kind": "tugas",
  "Label": "Diagnostik Performa SQL",
  "MessageId": "61820b594664275c4429****",
  "Name": "ringkasan",
  "OriginatingToolCallId": "ag-xxxx",
  "ParentAgentId": " agent-3a6f1c92",
  "ParentMessageId": "76bee207-31ee-4707-8851-6b9d4da033aa",
  "Role": "asisten",
  "RunId": "ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7",
  "StepName": "sub_agent_performance_diagnose_mysql",
  "StepStatus": "selesai",
  "TaskTrackerId": "das_api",
  "ThreadId": "8e481be1-21d5-4a92-a2fb-fb54be0ab4f6",
  "Timestamp": 1767225600000,
  "ToolCallError": "error",
  "ToolCallId": "call_edf9cdb69e0e4c9796a6a5a6",
  "ToolCallName": "das_api",
  "Type": "TEXT_MESSAGE_CONTENT",
  "Value": "{\"CharCount\":393,\"End\":1777428785996,\"RequestId\":\"BE59AED5-D831-5811-BBAD-590B917B2089\",\"SessionId\":\"123e4567-e89b-12d3-a456-xxxxxxxxxxxx\",\"Start\":1777428707927}"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParams The request parameters are invalid. Parameter permintaan tidak valid.
    500 Timeout The request processing has failed due to timeout. Permintaan gagal diproses karena habis waktu pengatur waktu.
    403 NoPermission You are not authorized to do this action. Anda tidak memiliki izin untuk melakukan operasi ini.
    404 InstanceNotFound Requested instance not found. ID instans terkait tidak dapat ditemukan.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.