Communitygithub.com

asyntai/agent-skills

通过 Asyntai MCP 服务器设置并管理 AI 客服机器人(网站聊天插件)——添加知识库、编辑指令、调整外观、查看对话、线索和分析,发现需要补充的知识点,并实时回复访客。在用户需要训练、配置、审查或运行 Asyntai 聊天机器人,或 Asyntai MCP 服务器需要连接时使用。

agent-skills 是什么?

该技能通过 Asyntai MCP 服务器,让 AI 智能体(如 Claude Code、Cursor、Codex 等)能够完整管理 Asyntai 网站 AI 客服机器人。它支持一次性的远程 MCP 服务器连接(无需 API 密钥),之后即可调用一系列工具完成从知识库管理、指令编辑、外观定制到实时对话回复的所有操作。核心工作流程包括先列出网站、读取当前配置、再进行修改,确保操作安全可控。技能还涵盖数据分析(如查看知识缺口和对话记录)、线索和工单管理,以及通过 `ask_ai` 模拟访客提问来测试回答质量。总之,它为开发者提供了一个无需离开智能体环境就能全方位运维 AI 客服机器人的高效方案。

兼容平台✓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,并点击认证。

  • 其他支持远程 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. 先读取再修改:修改前先调用 get_ai_instructions 再调用 update_ai_instructions,先调用 list_knowledge 再添加或删除知识,先调用 get_widget_settings 再调用 update_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.

相关技能