管理 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/ 免费创建一个。
所有任务都以相同方式开始
- 调用
list_websites。大多数账户只有一个网站,有些有多个。 - 如果有多个网站在修改前询问用户具体是哪一个。修改数据的工具需要传入
website_id,请勿猜测。 - 先读取再修改:修改前先调用
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。
工具名称是精确的。如果不确定,可以列出服务器的所有工具。
规则
- 读取类工具可随时安全调用。
- 在删除知识、修改指令、更改插件设置或在线回复访客之前,请先询问用户。
- 在保存前向用户展示新的指令文本。