Skip to content

变量

什么是变量

“变量”在“角色设定”里,用于做一些动态的设定,允许在外部修改Agent的局部提示词,它可以让Agent更加灵活丰富

如何使用

你的用户在使用Agent时,每次开始新会话,需要使用者提前输入变量内容;API调用Agent时,也可以往变量里注入内容

简单场景举例

举一个简单的例子,你的新闻助手Agent正在被很多人使用,你期望它人性化一些,能够在回答时,带上用户的姓名,你可以这样设置 image 这样Agent在回答时,就带上了用户的姓名 image

在API中使用

你也可以在API中调用Agent时,往这个变量里注入内容 image 请求示例

json
curl --location 'https://ai-api.betteryeah.com/v1/oapi/agent/chat'
--header 'Content-Type: application/json'
--header 'Access-Key: {YOUR_API_KEY}'
--header 'Workspace-Id: {YOUR_WORKSPACE_ID}'
--data '{
        "robot_id": "{YOUR_ROBOT_ID}",
        "conversation_id": "YOUR_CONVERSATION_ID",
        "content": "请给我AI相关的新闻",
        "inputs": {
        "name":"小星"  // 这就是你在Agent里定义的变量
        },
    "response_mode":"blocking"
}'

更多使用的场景

变量与API调用配合,可以让Agent支持更多的场景,例如:

  • 期望调用Agent时,让它有不同的性格(把"性格"当做变量)
  • 期望给不同的角色身份的人,回答不同的问题(把"身份"当做变量)
  • 期望调用Agent时,就给他一些背景知识(把"背景"当做变量) 参考以下提示词:
markdown
# 角色
你是一个心理咨询师,你的性格是{{character}}

# 目标
分析我的心理状态,共情倾听并给出解决方案

# 背景
这是我的一些背景内容:{{background}}

# 要求
我的身份是{{role}},请给我身份对应的回答