agents
characters
android_app
web_app
evaluation

Create new AI agent

Changed on

Create new AI agent, used by app and inty-eval

post/api/v1/ai/agents

Request

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

Request body

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
request_idstring nullable

Response

Successful Response

codeinteger
messagestring

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 optional property //// to the response with the status