Communitygithub.com

asyntai/agent-skills

透過 Asyntai MCP 伺服器設定與管理 Asyntai AI 客服機器人(網站對話小幫手)— 新增知識、編輯代理人指令、調整小工具外觀、查看對話記錄、潛在客戶與分析數據、找出需要補充知識的主題,以及即時回覆訪客。

agent-skills 是什麼?

此技能讓 AI 代理(如 Claude Code、Cursor 等)能夠直接與 Asyntai 平台進行互動,管理並操作 Asyntai 所託管的 AI 客服機器人。核心功能是透過 Asyntai MCP 伺服器提供一組工具,涵蓋客服機器人的完整生命週期管理,包括知識庫管理(新增、刪除、爬取網站)、對話與分析查看、即時客服干預、以及帳戶與方案查詢。這讓開發者或 AI 代理可以無縫整合 Asyntai 的客服功能,而無需手動操作儀表板。支援多種 MCP 用戶端,包括 Claude Code(HTTP)、Cursor/VS Code/Windsurf(遠端 MCP),以及任何只支援本地指令的代理(透過橋接套件)。使用時需先進行一次性 OAuth 授權連線,之後即可安全地讀取網站資訊,並在使用變更工具前先詢問使用者,確保操作的安全與合規。

相容平台✓Claude Code~Codex CLI✓Cursor✓Windsurf
npx skills add https://github.com/asyntai/agent-skills/tree/HEAD/skills/manage-ai-support-agent

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

管理 Asyntai AI 客服代理人

Asyntai 將 AI 客服機器人部署在客戶的網站上。 託管的 Asyntai MCP 伺服器提供與 Asyntai 控制台相同的管理功能。

連線 MCP 伺服器(一次性設定)

請先檢查:如果 list_websites 等工具已可用,請跳過此章節。

伺服器為 https://asyntai.com/mcp(遠端,Streamable HTTP,OAuth 登入)。無需 API 金鑰。任何 Asyntai 帳戶(包含免費方案)均可使用。

  • Claude Code:執行 claude mcp add --transport http asyntai https://asyntai.com/mcp,然後執行 /mcp,選擇 asyntai 並點選 Authenticate。

  • 其他支援遠端 MCP 的代理(Cursor、VS Code、Windsurf 等):新增一個遠端 MCP 伺服器,URL 為 https://asyntai.com/mcp。

  • 只能啟動本地指令的代理:使用橋接套件:

    {
      "mcpServers": {
        "asyntai": { "command": "npx", "args": ["-y", "@asyntai/mcp"] }
      }
    }
    

首次工具呼叫會開啟瀏覽器一次以批准存取。如果使用者沒有帳戶,可以前往 https://asyntai.com/auth/ 免費建立一個。

以相同方式開始每項任務

  1. 呼叫 list_websites。大部分帳戶只有一個網站。部分帳戶有多個。
  2. 如果有多個網站,請先詢問使用者再進行任何變更。變更資料的工具需要使用 website_id。請勿猜測其值。
  3. 先讀取再變更:在 update_ai_instructions 前先 get_ai_instructions,在新增或刪除知識前先 list_knowledge,在 update_widget_settings 前先 get_widget_settings。

常見任務

  • 將聊天機器人放到網站上:list_websites 會提供 widget_id。接著遵循 add-ai-chatbot 技能。
  • 教導代理人:使用 add_knowledge_url 新增頁面、start_crawl 爬取整個網站、add_knowledge_text 新增事實或政策。透過 list_crawls 和 list_knowledge 檢查。
  • 測試回答:ask_ai 以訪客相同的方式向代理人提問。
  • 變更回答方式:get_ai_instructions,接著使用 update_ai_instructions。
  • 變更外觀:get_widget_settings,接著使用 update_widget_settings(名稱、顏色、第一則訊息等)。
  • 查看訪客提問:list_conversations、get_conversation、list_visitor_questions、get_analytics。
  • 找出缺口:list_knowledge_gaps 會列出需要更多知識的真實訪客問題。為它們新增知識,然後使用 ask_ai 測試。
  • 潛在客戶與工單:list_leads、list_tickets。
  • 自行回覆即時訪客:list_active_sessions、take_over_conversation、send_agent_reply,然後 release_conversation。
  • 方案與限制:get_account、list_plans。
  • 功能運作方式:search_asyntai_docs,然後 get_asyntai_doc。

工具名稱是精確的。如果不確定,請列出伺服器的工具。

規則

  • 讀取工具可隨時安全呼叫。
  • 在刪除知識、變更指令、變更小工具設定或在即時網站上回覆訪客之前,請先詢問使用者。
  • 在儲存前,請將新的指令文字顯示給使用者。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能