agents
characters
android_app
web_app
evaluation

更新智能体（AI 角色）

Changed on

更新任何图片，都会将图片全部记录在 background_images 字段中，用于保存历史记录如果没有提供 avatar，则会自动截取头像，并记录在 avatar 字段中

put/api/v1/ai/agents/{agent_id}

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Request body

namestring nullable
genderstring nullable
avatarstring nullable
backgroundstring nullable
background_imagesstring[] nullable
background_animatedstring nullable
voice_idstring nullable
settingsobject nullable
introstring nullable
openingstring nullable
opening_audio_urlstring nullable
visibility'PUBLIC' | 'PRIVATE'

AI 角色可见性

source'USER_CREATED' | 'AUTO_GENERATED'

AI 角色来源

photosstring[] nullable
categorystring nullable
promptstring nullable

已废弃 - 请使用personality字段代替

main_promptstring nullable
mode_promptstring nullable
character_card_specstring nullable
personalitystring nullable
scenariostring nullable
message_examplestring nullable
creator_notesstring nullable
post_history_instructionsstring nullable
alternate_greetingsstring[] nullable
character_bookobject nullable
tagsstring[] nullable
character_versionstring nullable
extensionsobject nullable
energy_pointsinteger nullable

需要新增的能量点数，会累加到 agent 的积分列中

replace_background_imagesboolean nullable

是否替换 background_images 列表。为 True 时完全替换，为 False 或 None 时追加

request_idstring nullable

Response

Successful Response

namestring required
genderstring required
avatarstring nullable
backgroundstring nullable
background_imagesstring[] nullable
background_animatedstring nullable
voice_idstring nullable
settingsobject nullable
introstring nullable
openingstring nullable
opening_audio_urlstring nullable
visibility'PUBLIC' | 'PRIVATE'

AI 角色可见性

source'USER_CREATED' | 'AUTO_GENERATED'

AI 角色来源

photosstring[] nullable
categorystring nullable
promptstring nullable

已废弃 - 请使用personality字段代替

main_promptstring nullable

主提示词 - 作为第一个system message，覆盖全局默认主提示词。可以是预设 ID 或自定义文本

mode_promptstring nullable

模式提示词 - 放在角色卡提示词后面，覆盖全局默认模式提示词。可以是预设 ID 或自定义文本

character_card_specstring nullable
personalitystring nullable

角色性格特点 (推荐)

scenariostring nullable

背景设定 (推荐)

message_examplestring nullable

对话示例

creator_notesstring nullable

创作者备注

post_history_instructionsstring nullable
alternate_greetingsstring[] nullable
character_bookobject nullable
tagsstring[] nullable
character_versionstring nullable
extensionsobject nullable
idstring required
readable_idstring required
status'PENDING' | 'APPROVED' | 'REJECTED' required

AI角色状态

creator_idstring nullable
created_atinteger required
updated_atinteger nullable
deleted_atinteger nullable
versioninteger required
energy_pointsinteger

Agent 当前能量点数，对应数据库 points 列

is_followedboolean
follower_countinteger
connector_countinteger

Changes

  • 1e014c365df2Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

  • 5b77ae7cc5c4Revision changes
    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status