Conduct Agent Q&A Dialogue (OpenAI Protocol)

POST 
/v1/aibot/openai/chat/completions

Conduct Agent Q&A Dialogue (OpenAI Protocol)

Request

application/json

Body

required

model stringrequired

Agent ID

messages object[]required
Messages
Array [
role stringrequired
Role of historical information
content stringrequired
Content of historical information
]
stream booleanrequired

Whether to return in stream mode

Responses

x-stream:false

When the Agent dialogue is successful, non-streaming return

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

id string

Conversation record ID

object string

Interface type

created number

Conversation timestamp

model string

Agent ID

choices undefined[]
choices
Array [
index number
index
message object
role string
Message type
content string
Message content
finish_reason string
Conversation end flag; 'continue' indicates the conversation is ongoing, 'stop' indicates the conversation has ended
]
usage object

token usage

prompt_tokens number

Indicates the number of tokens in the prompt, remains unchanged across multiple responses

completion_tokens number

Total tokens in the response. In streaming responses, represents the cumulative total of all completion tokens up to now, continues to accumulate across multiple responses

total_tokens number

Represents the sum of prompt_tokens and completion_tokens

Example (from schema)

{
  "id": "record-427d3652",
  "object": "chat.completion",
  "created": "1726030224",
  "model": "bot-xxxx",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello"
      },
      "finish_reason": "continue"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 0
  }
}

x-stream:true

When the Agent dialogue is successful, streaming return

application/json

Schema

Schema

id string

Conversation record ID

object string

Interface type

created number

Conversation timestamp

model string

Agent ID

choices undefined[]
choices
Array [
index number
index
delta object
role string
Message type
content string
Message content
finish_reason string
Conversation end flag; 'continue' indicates the conversation is ongoing, 'stop' indicates the conversation has ended
]
usage object

token usage

prompt_tokens number

Indicates the number of tokens in the prompt, remains unchanged across multiple responses

completion_tokens number

Total tokens in the response. In streaming responses, represents the cumulative total of all completion tokens up to now, continues to accumulate across multiple responses

total_tokens number

Represents the sum of prompt_tokens and completion_tokens

Example (from schema)

{
  "id": "record-427d3652",
  "object": "chat.completion",
  "created": "1726030224",
  "model": "bot-xxxx",
  "choices": [
    {
      "index": 0,
      "delta": {
        "role": "assistant",
        "content": "Hello"
      },
      "finish_reason": "continue"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 0
  }
}

default

Returned when Agent conversation fails

application/json

Schema

Schema

code string

Error code

message string

Error message

requestId string

Request ID

Example (from schema)

{
  "code": "INVALID_CREDENTIALS",
  "message": "Credentials are invalid",
  "requestId": "6360ba4b-f672-434b-9dee-35686a5589a4"
}

Loading...