用途:通过 Profound REST API 获取组织在 AI 答案引擎中的品牌与竞品可见度、引用、情感、fanout、prompt、category 与 agent 数据,并可用于查询 Agent Analytics 的机器人或引荐流量报告。
主要能力:列出分类、资产、模型、区域等组织元数据;查询 visibility、citations、sentiment 报告;列出并运行 Profound Agents 并查询运行状态;获取 Agent Analytics 报告。
使用方式:先在 app.vm0.ai/connectors 连接 Profound 连接器,连接器会注入 PROFOUND_API_KEY 并通过 X-API-Key 头认证。REST 基础地址为 https://api.tryprofound.com。多数报告端点需要 category_id,先用 curl -s "https://api.tryprofound.com/v1/org/categories" --header "X-API-Key: $PROFOUND_API_KEY" 获取。查询报告使用 POST,将请求体写入 JSON 文件后以 -d @文件 发送,例如 /v1/reports/visibility、/v1/reports/citations、/v1/reports/sentiment。列 Agent 用 GET /v1/agents,运行用 POST /v1/agents/<agent-id>/runs,查询运行状态用 GET /v1/agents/<agent-id>/runs/<agent-run-id>。
适用场景:跨 AI 答案引擎分析品牌或竞品可见度,拉取引用、情感、fanout、可见度报告,发现分类、资产、区域、模型、persona 与 prompt,列出或运行 Agents,获取 Agent Analytics 流量报告。
限制:Profound API 访问仅限 Enterprise 且目前处于 beta;若 API Keys 页面不可用需向 Profound 支持申请访问。报告端点必须显式传入 start_date 与 end_date,日期支持 YYYY-MM-DD、YYYY-MM-DD HH:MM 及完整 ISO 时间戳。默认限速为每 API Key 每小时 600 次请求,需遵守 X-RateLimit-* 与 Retry-After 头。beta 期间端点与响应结构可能变化。排障可运行 zero doctor check-connector --env-name PROFOUND_API_KEY 或 zero doctor check-connector --url https://api.tryprofound.com/v1/org/categories --method GET。