Database Autonomy Service (DAS) の大規模言語モデル機能にアクセスするための非同期 API です。
操作説明
前提条件:
最新バージョンの Alibaba Cloud SDK または DAS SDK を使用する必要があります。
SDK を使用して DAS サービスを呼び出す場合、リージョンとして cn-shanghai を指定する必要があります。
オフラインタスクは、DAS Enterprise Edition が有効になっているデータベースインスタンスに対してのみ作成できます。DAS Enterprise Edition のさまざまなバージョンでサポートされているデータベースとリージョンの詳細については、「DAS の製品エディションと機能」をご参照ください。
DAS エージェントで Chat API を使用する方法の詳細については、「DAS エージェントインタラクションのベストプラクティス (Chat API との統合)」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
hdm:Chat |
get |
*All Resource
|
なし | なし |
リクエスト構文
POST /chat HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Message |
string |
必須 |
メッセージオブジェクトです。 |
{"id":"68fe0321-37fe-4c75-a118-b61b33156f6a","role":"user","content":[{"type":"text","text":"hello"}]} |
| SessionId |
string |
任意 |
セッション ID です。このパラメーターは任意で、UUID である必要があります。指定しない場合は、新しいセッションが作成されます。会話のコンテキストを維持するには、後続のすべてのリクエストで同じセッション ID を使用します。 |
123e4567-e89b-12d3-a456-xxxxxxxxxxxx |
| AgentId |
string |
任意 |
エージェント ID です。このパラメーターは任意です。DAS エージェントを有効にすると自動的に生成されるエージェントの ID、またはカスタムエージェントの ID を使用できます。このパラメーターを省略すると、デフォルトエージェントが使用されます。 |
ag-472T0DxtmjIxxxxx |
| Summary |
string |
任意 |
概要情報を返すかどうかを指定します。 |
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマです。 |
||
| Type |
string |
イベントタイプです。 |
TEXT_MESSAGE_CONTENT |
| MessageId |
string |
メッセージ ID です。 |
61820b594664275c4429**** |
| Role |
string |
会話におけるロールです。 |
assistant |
| Delta |
string |
レスポンスの増分コンテンツです。 |
hello |
| ActivityType |
string |
エージェントの現在のアクティビティステータスを示します。 |
waiting_for_agent_thinking |
| ToolCallId |
string |
ツールコール ID です。 |
call_edf9cdb69e0e4c9796a6a5a6 |
| ToolCallName |
string |
ツールの名前です。 |
das_api |
| Content |
string |
レスポンスのコンテンツです。 |
I see you have several PolarDB instances, and I will query them for you shortly |
| ParentMessageId |
string |
親メッセージの ID です。 |
76bee207-31ee-4707-8851-6b9d4da033aa |
| ThreadId |
string |
スレッド ID です。 |
8e481be1-21d5-4a92-a2fb-fb54be0ab4f6 |
| StepName |
string |
実行ステップの名前です。 |
sub_agent_performance_diagnose_mysql |
| RunId |
string |
Run ID です。 |
ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7 |
| TaskTrackerId |
string |
コールバックツールの識別子です。 |
das_api |
| Name |
string |
追加情報のキーです。 |
summary |
| Value |
any |
追加情報の値です。 |
{"CharCount":393,"End":1777428785996,"RequestId":"BE59AED5-D831-5811-BBAD-590B917B2089","SessionId":"123e4567-e89b-12d3-a456-xxxxxxxxxxxx","Start":1777428707927} |
例
成功レスポンス
JSONJSON
{
"Type": "TEXT_MESSAGE_CONTENT",
"MessageId": "61820b594664275c4429****",
"Role": "assistant",
"Delta": "hello",
"ActivityType": "waiting_for_agent_thinking",
"ToolCallId": "call_edf9cdb69e0e4c9796a6a5a6",
"ToolCallName": "das_api",
"Content": "I see you have several PolarDB instances, and I will query them for you shortly",
"ParentMessageId": "76bee207-31ee-4707-8851-6b9d4da033aa",
"ThreadId": "8e481be1-21d5-4a92-a2fb-fb54be0ab4f6",
"StepName": "sub_agent_performance_diagnose_mysql",
"RunId": "ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7",
"TaskTrackerId": "das_api",
"Name": "summary",
"Value": "{\"CharCount\":393,\"End\":1777428785996,\"RequestId\":\"BE59AED5-D831-5811-BBAD-590B917B2089\",\"SessionId\":\"123e4567-e89b-12d3-a456-xxxxxxxxxxxx\",\"Start\":1777428707927}"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | |
| 500 | Timeout | The request processing has failed due to timeout. | |
| 403 | NoPermission | You are not authorized to do this action. | |
| 404 | InstanceNotFound | Requested instance not found. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。