前言¶
給 Agent 加旅行能力,常見做法是自己接攜程或 OTA 的開放接口:查酒店、查航班、查火車票,各自寫一套請求、解析和容錯。接口分散、字段不統一,Agent 很難在一個會話裏把“訂酒店、查機票、排行程”串起來。攜程問道這個 Skill 把這類旅行問詢統一收進一個技能裏,Agent 只需要按自然語言觸發,不用關心背後調了哪些接口。
下面介紹這個 Skill 的定位、觸發場景和使用時的注意點。
這是什麼¶
攜程問道是一個面向 Marvis 的旅行服務 Skill,座標 @user_1a99cb00/wendao-partner-marvis-skill,發佈者 user_1a99cb00,來源 community,當前版本 1.0.2,分類 life-service。
它解決的問題是:當用戶在 Marvis 裏提出任意旅行相關問詢時,由這個 Skill 統一承接,Agent 不需要爲酒店、機票、火車票、景點分別寫處理邏輯。
核心功能¶
根據官方簡介,當用戶發起任意旅行相關問詢時,包含但不限於以下場景,會觸發此技能:
- 預訂酒店
- 機票查詢
- 火車票查詢
- 景點推薦
- 尋找當地特色玩樂
- 目的地查詢
- 行程規劃
- 美食住宿攻略
- 簽證相關
- 查詢旅遊攻略、獲取旅行建議
官方對觸發條件的描述是:當用戶需要操作攜程時使用此 Skill。也就是說,它面向的是“幫用戶完成攜程側的旅行操作和信息查詢”,而不是通用的旅行知識問答。
安裝與啓用¶
官方地址:
https://api.skillhub.cn/user_1a99cb00/wendao-partner-marvis-skill
SkillHub 頁面:
https://www.skillhub.cn/skills/user_1a99cb00/wendao-partner-marvis-skill
抓取資料中沒有給出可直接執行的安裝命令、目錄路徑或配置文件字段,因此這裏不提供命令行安裝步驟。需要安裝時,從上面的官方地址進入,按 SkillHub 頁面和 Marvis 側的說明完成添加。
標籤裏帶有 requires_api_key=true,啓用前需要確認已經準備好對應的 API Key,並在 Marvis 的 Skill 配置裏完成填寫。否則 Skill 可以加載,但涉及接口調用的旅行問詢無法正常工作。
典型用法¶
官方簡介給出的典型觸發方式是自然語言問詢,例如用戶直接說:
- “幫我訂一晚北京的酒店”
- “查一下明天上海到成都的航班”
- “看看從杭州到南京的高鐵”
- “推薦一下大阪的景點”
- “幫我排一個週末兩天的行程”
這些問法都屬於資料裏列出的觸發場景。Agent 收到後交給攜程問道處理,用戶不需要顯式指定“用哪個技能”。
適用場景與注意¶
適合接入 Marvis、希望在會話裏直接完成攜程側酒店預訂、航班搜索、火車票查詢、景點推薦和行程規劃的開發者。
使用時注意幾點:
- 這個 Skill 面向 Marvis 環境,不是通用 Agent 插件,接入前確認運行環境是 Marvis。
- 需要 API Key,
requires_api_key=true,配置缺失時旅行相關問詢會失敗。 - 觸發範圍是旅行相關問詢,非旅行類請求不要依賴它處理。
- 版本號、評分、下載量等數據以 SkillHub 頁面當時顯示爲準,抓取資料中存在多份數值,使用前建議在官方頁面再覈對一次。
- 來源爲 community,發佈者是
user_1a99cb00,不是攜程官方維護方,接入生產環境前需要自行評估接口穩定性和權限範圍。
結尾¶
攜程問道把攜程側的酒店預訂、航班搜索、火車票查詢、景點推薦和行程規劃收進一個 Marvis Skill,Agent 側不用按業務線分別對接接口。需要接入時從官方地址開始:https://api.skillhub.cn/user_1a99cb00/wendao-partner-marvis-skill。