​
工具使用原则

正文给客户的回答应使用业务语义，例如“查看品牌列表”“刷新数据”“查找负面帖子”。工具 ID 主要供实施、QA 和排障对照。

采集类工具返回 jobId 后，后续应通过 get_refresh_progress 轮询到 completed 再读取数据；不要在采集中重复创建或刷新。

AI 深度追问有同步和异步两条链路：同步 report_follow_up_analysis 直接返回报告（30–100 秒）；若客户端或链路有硬性响应超时（如经过 Cloudflare ~60 秒边缘网关），改用异步 report_follow_up_analysis_async 发起后，通过 wait_for_analysis 轮询到 done 再取报告。两条链路结果和计费完全一致（成功扣 600 积点）。

用户询问“用户是谁、为什么购买或不购买”时，先免费读取 get_persona_voc 总览，再按 availableSections 用 get_persona_section 下钻。只有没有画像报告，或用户明确要求重生并确认费用后，才调用异步 generate_persona_voc；之后用 get_persona_generation_progress 查进度，不要重复发起。

​
37 个工具速查

分组工具 ID业务含义计费类型
上下文和规则social_capabilitiesMCP 能力自省免费
上下文和规则get_context获取账号、billingMode、品牌列表、支持平台免费
上下文和规则get_billing_rules查看积点计费规则免费
上下文和规则suggest_next_actions推荐下一步免费
上下文和规则explain_error解释错误码和下一步免费
知识空间prepare_space生成采集计划和费用预估免费
知识空间create_space创建知识空间并首采采集计费
品牌管理list_brands查看已有品牌/空间免费
品牌管理get_brand查看品牌配置和数据状态免费
品牌管理prepare_brand_onboarding生成完整品牌接入建议免费
品牌管理setup_brand完整品牌接入采集计费
品牌管理update_brand修改品牌配置免费
采集diagnose_brand检查数据是否就绪免费
采集refresh_brand刷新已有品牌数据采集计费
采集get_refresh_progress查看采集进度免费
采集wait_for_refresh短等采集完成免费
分析get_analysis_progress查看异步 AI 深度追问进度完成时计费
分析wait_for_analysis短等异步 AI 深度追问完成完成时计费
数据读取get_brand_metrics核心指标和平台分布免费
数据读取search_brand_posts按条件查帖子免费
数据读取find_posts_about语义搜索帖子免费
数据读取get_brand_sentiment情感分布和驱动因素免费
数据读取get_voice_share声量份额免费
数据读取compare_competitors多维竞品对比免费
数据读取get_risk_alerts风险预警免费
报告 / 分析get_social_voc_report_kit免费社媒 VOC 报告套件（出报告默认首选，本地装配 HTML）免费
报告 / 分析report_follow_up_analysisAI 深度追问（同步，直接返回报告）AI 深度追问计费
报告 / 分析report_follow_up_analysis_asyncAI 深度追问（异步发起，躲边缘超时；配合 wait_for_analysis 轮询）发起免费，完成时计费
报告 / 分析get_brand_summary快速品牌摘要免费
用户画像get_persona_voc读取 persona 总览免费
用户画像get_persona_section按需读取画像模块和分页数据免费
用户画像generate_persona_voc异步生成/重生用户画像99 credits = 59400 积点
用户画像get_persona_generation_progress查看画像生成进度免费
用户画像list_persona_questions查看各人群建议问题免费
用户画像ask_persona询问单个人群或使用分析师模式1 credit = 600 积点/次
用户画像ask_all_personas向所有人群询问同一问题1 credit = 600 积点/次请求，不按人群数乘
用户画像get_persona_interview_summary总结第一人称画像访谈免费

​
计费工具

工具计费规则
create_space创建知识空间并启动首轮采集；采集受理成功后按预估积点计费
setup_brand完整品牌接入并启动采集；采集受理成功后按预估积点计费
refresh_brand刷新已有品牌数据；采集受理成功后按预估积点计费
report_follow_up_analysisAI 深度追问（同步）；成功返回回复后计费 600 积点
report_follow_up_analysis_async + wait_for_analysis / get_analysis_progressAI 深度追问（异步）；发起不计费，轮询到 done 那一刻计费 600 积点。同一作业重复轮询不重复计费
generate_persona_voc异步生成用户画像，受理后按 99 credits（59400 积点）计费；先检查总览/进度，活动中的生成不要重复发起
ask_persona单个人群访谈或分析师问答，成功调用计费 1 credit（600 积点）
ask_all_personas一次广播问答计费 1 credit（600 积点），不按人群数量重复计费

采集积点公式见 VOC Insight MCP 计费。