preference

name	preference
description	Use this skill when the user states or updates their preferences, e.g. hotel brands, airlines, home location, seat preference. Triggers when user says "我喜欢住汉庭", "我还喜欢如家", "我搬家到上海了", "我常坐东航". This skill uses PreferenceAgent and requires a MemoryManager to persist preferences; when used standalone, apply returned preferences via memory_manager.long_term.save_preference.

Preference (偏好管理)

识别用户偏好并支持追加（还、也）与覆盖（搬家到、改成）。使用 PreferenceAgent。持久化由 MemoryManager 完成：在协调器流程中由协调器写回；单独调用时需根据返回的 preferences 列表自行调用 memory_manager.long_term.save_preference()。

When to Use

• 用户说「我喜欢XX」「我还喜欢XX」「我搬家到XX」「我常坐东航」等

Agent

• PreferenceAgent (agents/preference_agent.py)
• 入参：model、memory_manager（用于读取当前偏好；写回由协调器或调用方完成）
• 异步：run(state) 为 async，需 await

行为

• append：识别「还」「也」等，在已有列表上追加
• replace：识别「搬家到」「改成」等，覆盖原值
• 偏好类型：hotel_brands, airlines, home_location, seat_preference, meal_preference, budget_level 等，支持自定义

初始化与调用

import asyncio
from context.memory_manager import MemoryManager
from agents.preference_agent import PreferenceAgent
from utils.langchain_runtime import build_chat_model

async def save_preference(user_query: str, user_id: str = "default_user", session_id: str = "default"):
    model = build_chat_model()
    memory_manager = MemoryManager(user_id=user_id, session_id=session_id, llm_model=model)
    agent = PreferenceAgent(name="PreferenceAgent", model=model, memory_manager=memory_manager)
    data = await agent.run({"context": {"rewritten_query": user_query}})
    if data.get("has_preferences") and data.get("preferences"):
        for item in data["preferences"]:
            pref_type = item.get("type")
            value = item.get("value")
            action = item.get("action", "replace")
            current = memory_manager.long_term.get_preference().get(pref_type)
            if action == "append" and isinstance(current, list):
                memory_manager.long_term.save_preference(pref_type, current + [value])
            else:
                memory_manager.long_term.save_preference(pref_type, value)
    return data

# 使用
data = asyncio.run(save_preference("我还喜欢如家"))
# data: {"preferences": [{"type": "hotel_brands", "value": "如家", "action": "append"}], "has_preferences": true}

返回格式

• preferences: 列表，每项 { "type", "value", "action": "append"|"replace" }
• has_preferences: bool

偏好提取规则

【任务说明】 你需要判断用户的意图：

1. 追加（append）：用户想在已有偏好基础上增加新的选项

   • 关键词：「还」、「也」、「另外」、「以及」
   • 示例："我还喜欢汉庭" → 追加到 hotel_brands
   • 示例："我也常坐东航" → 追加到 airlines

2. 覆盖（replace）：用户想更新/替换原有的偏好

   • 关键词：「搬家到」、「改成」、「现在是」、「换成」
   • 示例："我搬家到上海了" → 覆盖 home_location
   • 示例："我现在喜欢靠窗座位" → 覆盖 seat_preference

3. 首次设置：用户第一次提及某个偏好

   • 如果当前偏好中没有这个字段，默认使用 replace

【常见偏好类型】

• home_location: 家庭地址/常住地
• hotel_brands: 酒店品牌偏好
• airlines: 航空公司偏好
• seat_preference: 座位偏好
• meal_preference: 餐食偏好
• budget_level: 预算等级
• transportation_preference: 交通偏好
• food_preference: 美食偏好 （支持自定义新的偏好类型）

【输出格式】(严格JSON) {{ "preferences": [ {{ "type": "hotel_brands", "value": "汉庭", "action": "append" }}, {{ "type": "home_location", "value": "上海浦东新区", "action": "replace" }} ], "has_preferences": true }}

【重要规则】

1. action 只能是 "append" 或 "replace"
2. 根据用户的语气和上下文判断 action
3. 如果用户使用「还」、「也」等词，使用 append
4. 如果用户使用「搬家」、「改成」等词，使用 replace
5. 如果是首次提及，使用 replace
6. 如果用户未提及任何偏好，返回 {{"preferences": [], "has_preferences": false}}