Skip to main content
PATCH
/
api
/
v1
/
agents
/
{id}
{
  "fullName": "<string>",
  "welcomeText": "<string>",
  "systemPrompt": "<string>",
  "role": "<string>",
  "description": "<string>",
  "modelId": "<string>",
  "temperature": 0,
  "top_p": 123,
  "top_k": 123,
  "frequency_penalty": 123,
  "isPublic": false,
  "maxTimeoutInSeconds": 123,
  "toolIds": [
    "<string>"
  ],
  "knowledgeStoreId": "<string>",
  "knowledgeStoreParams": {}
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Agent ID

Body

multipart/form-data
​
fullName
string

The full name of the agent

​
welcomeText
string

Welcome text for the agent (2-1000 characters)

​
systemPrompt
string

The system prompt for the agent (128-4096 characters)

​
role
string

The Role of the agent, like Du Telecom customer support

​
description
string

The description of the agent

​
modelId
string

The ID of the model

​
temperature
number
default:0

The temperature for the model (0 to 1)

​
top_p
number

The top_p value for the model

​
top_k
number

The top_k value for the model

​
frequency_penalty
number

The frequency_penalty for the model

​
isPublic
boolean
default:false

Whether the agent is public or not

​
avatar
file

The avatar file for the agent (optional, max 2MB, image files only). Set to null to remove existing avatar.

​
maxTimeoutInSeconds
number

Max timeout for an agent in seconds

​
toolIds
string[]

The tool ids

​
knowledgeStoreId
string

The knowledge store id

​
knowledgeStoreParams
object

The knowledge store id

Response

The agent has been successfully updated.

​
fullName
string

The full name of the agent

​
welcomeText
string

Welcome text for the agent (2-1000 characters)

​
systemPrompt
string

The system prompt for the agent (128-4096 characters)

​
role
string

The Role of the agent, like Du Telecom customer support

​
description
string

The description of the agent

​
modelId
string

The ID of the model

​
temperature
number
default:0

The temperature for the model (0 to 1)

​
top_p
number

The top_p value for the model

​
top_k
number

The top_k value for the model

​
frequency_penalty
number

The frequency_penalty for the model

​
isPublic
boolean
default:false

Whether the agent is public or not

​
avatar
file

The avatar file for the agent (optional, max 2MB, image files only). Set to null to remove existing avatar.

​
maxTimeoutInSeconds
number

Max timeout for an agent in seconds

​
toolIds
string[]

The tool ids

​
knowledgeStoreId
string

The knowledge store id

​
knowledgeStoreParams
object

The knowledge store id