跳到主要内容

变量管理

变量可以存储语言偏好、行为习惯等用户特征。通过变量管理，智能体能够动态记忆用户信息并生成个性化回复。

  • 核心机制：变量以 key-value（键值对）形式存储数据。
  • 赋值逻辑：大语言模型自动分析用户输入的语义，匹配对应变量并动态赋值。
  • 应用场景：在提示词中声明变量用途。例如，根据用户的语言偏好切换回答语种。

变量类型​

您可通过 系统变量 和 用户变量 满足不同业务需求。二者区别如下：

类型控制权数据来源可读写性
系统预设变量
• App 用户变量平台预设用户行为／设备环境仅系统可写
• 记忆变量平台预设用户长期交互数据仅系统可写
• 角色变量平台预设业务面板配置仅系统可写
自定义变量开发者定义用户主动提供或会话中动态生成全渠道可读可写

App 用户变量​

存储 App 用户与智能设备关联的静态信息，用于优化智能体在家庭场景中的服务。

  • 典型场景

    • 天气播报：通过 家庭纬度 和 家庭经度 变量获取本地实时天气。
    • 设备控制：通过 房间信息、家庭设备分类、设备 AI 指令属性 等变量定位设备并调节其属性，例如调节卧室灯具的亮度。

  • 支持变量表

    变量名称描述默认值支持渠道其他说明
    sys.categories家庭设备分类系统自动生成Tuya、SmartLife、OEM App只读
    sys.homeLatitude家庭纬度坐标系统自动生成Tuya、SmartLife、OEM App只读
    sys.rooms家庭房间划分信息系统自动生成Tuya、SmartLife、OEM App只读
    sys.currentTime家庭所在时区的当前时间系统自动生成Tuya、SmartLife、OEM App只读
    sys.homeLongitude家庭经度坐标系统自动生成Tuya、SmartLife、OEM App只读
    sys.deviceNames设备名称列表系统自动生成Tuya、SmartLife、OEM App只读
    sys.attributes家庭设备的 AI 指令属性系统自动生成Tuya、SmartLife、OEM App只读

  • 使用规则

    • 启用方式：默认关闭，需要您在开发者平台手动启用。
    • 数据权限：数据仅通过 智能生活 App、涂鸦 App 及 OEM App 渠道获取。数据由系统自动生成，禁止人工修改。例如，用户搬家后经纬度发生变化时，需要重新触发定位请求。

角色变量​

角色变量专用于 业务面板场景，如 AI 娃娃和智能音箱。用户可自定义角色属性，增强交互拟真度。

  • 典型场景

    • 儿童陪伴机器人：用户通过 role_name 变量设定角色称呼（如“小助手乐乐”）。

  • 默认变量表

    变量名称描述支持渠道其他说明
    sys.roleName角色名称AI 玩具面板只读
    sys.roleIntroduce角色描述AI 玩具面板只读
    sys.roleSupplementDesc角色补充描述AI 玩具面板只读

  • 使用规则

    • 变量需在开发者平台开启后才能使用。
    • C 端用户可修改角色变量的值。修改实时生效，无需重新部署智能体。

    更多介绍，请参考 使用变量。

记忆变量​

存储用户在与智能体交互过程中需要 长期保留 的个性化数据，支持跨会话持久化读写。

  • 典型场景

    • 根据兴趣匹配内容：sys.memoryInterests 变量记录用户选择的兴趣爱好，对话时据此推荐相关内容并适配回答。
    • 通过记忆了解用户习惯：sys.memoryHistoryChatSummary 变量保存历史对话总结，延续上下文，给予更贴切的回复。

  • 默认变量表

    变量名称描述支持渠道其他说明
    sys.memoryUserFullName姓名。记录并总结用户的姓名，便于个性化交流。全渠道每次会话总结
    sys.memoryInterests兴趣爱好。记录用户的兴趣爱好，以便提供相关内容推荐。全渠道同上
    sys.memoryAge年龄。记录用户的年龄信息，用于优化交流体验。全渠道同上
    sys.memoryBirthday生日。记录用户的生日信息，便于提供提醒或祝福。全渠道同上
    sys.memoryProfession职业。记录用户的职业信息，以便更好地理解需求。全渠道同上
    sys.memoryGoalsAndWishes目标和愿望。记录用户的目标和愿望，便于个性化支持。全渠道同上
    sys.memoryPetsKeptAtHome记录用户家里养的宠物，以便个性化互动。全渠道同上
    sys.memoryHistoryChatSummary归纳用户的历史对话，延续上下文。全渠道同上

  • 使用规则

    • 启用方式：默认关闭，需在开发者平台手动启用。
    • 数据权限：智能体所有投放渠道均可获取该数据。数据由系统自动生成，禁止人工修改。

自定义变量​

允许您 完全自主定义 变量类型，用于捕捉用户与智能体在动态交互中的临时状态或扩展业务需求，如用户角色、实时情绪等。

  • 典型场景
    • 情绪感知：通过 current_mood 变量（取值范围 0-10）动态调整回复语气。
    • 身份适配：通过 user_role 变量（如“家长”“访客”）切换智能体的应答策略。

建议填写准确的变量名称和描述，以提高智能体命中用户数据的准确性。示例：

变量名称变量描述用例场景
custom_moodLevel用户实时情绪值（0-10 分级）当检测到情绪值 ≥ 7 时，使用更积极的语气回复。
custom_interactionFrequency用户当日互动次数统计若当日互动 ≥ 5 次，推送关怀提醒：需要休息一下吗？
custom_preferredTopic用户最近关注的话题标签根据 custom_preferredTopic=#烹饪 优先推荐食谱相关内容。

使用变量​

  1. 登录 涂鸦开发者平台。

  2. 选择 智能体 > 智能体开发 > 我的智能体，单击 创建 Agent 或 Agent 管理，进入智能体开发页面。

    智能体开发页面
    智能体开发页面

  3. 滚动到 变量 区域，单击右侧的添加按钮（+）。

    变量区域
    变量区域

  4. 管理变量。在 编辑变量 页面，您可以创建自定义变量、开启系统变量，或开启角色变量管理。

    • 创建自定义变量：在 自定义变量 区域单击 新增，填写变量名称、描述和默认值，然后单击 保存。准确的名称和描述有助于智能体更准确地命中用户数据。

      创建自定义变量
      创建自定义变量

    • 开启系统变量：打开开关，启用 App 用户变量和记忆变量。开启后，系统提示词会自动引用相关变量信息。若需补充特殊说明，可在提示词中描述变量的使用场景。

      开启系统变量
      开启系统变量

    • 开启角色变量管理：角色变量适用于 AI 玩具、音响等需要角色预设的场景，需与对应品类的面板配合使用，从而实现 C 端用户自定义智能体的角色、音色、性格等功能。

      1. 打开开关，启用角色变量组。

        启用角色变量组
        启用角色变量组

      2. 在 角色预设管理 页面，单击 添加预设 添加官方角色或自定义角色。

        添加预设角色
        添加预设角色

      3. 变量启用且完成智能体开发与设备端关联后，配合 AI 玩具面板使用时，即可在面板端查看预设角色信息。

相关文档​