营销增长
用 Exa Agent 按 ICP…
当需要根据理想客户画像(ICP)批量发现目标公司、生成外呼潜客名单并输出结构化 CSV 时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
用 Exa Agent 按 ICP 生成特定
解决思路
- 确认 ICP:若用户已描述则直接确认;否则先跑一次低成本的 agent_run 研究该公司卖什么、现有客户是谁、理想客户画像是什么,输出 company_description、icp_description、sub_verticals、useful_enrichments 四个字段。
- 向用户确认 ICP 描述是否准确、要排除哪些公司(竞争对手、现有客户)、需要多少条线索(默认 200)、以及关心哪些富化列。
- 设计 outputSchema:用一个有界的 companies 数组,保持 schema 小而扁平且明确,数组必须用 maxItems 限定;核心字段固定包含 company_name、website、product_description(描述里注明 12 词以内)、icp_fit_score(1-10 整数)、icp_fit_reasoning(描述里注明 20 词以内的一句话),再按活动需要添加融资阶段、员工规模、总部、招聘信号等富化字段,字符串字段都给出长度提示以保证 CSV 干净。
- 调用 agent_run 时用各输入项替代手工流程:query 描述名单(ICP、地域、阶段、想要多少家);outputSchema 定义返回结构并用 maxItems 限定;systemPrompt 写评分规则、来源偏好、去重与排除要求;input.exclusion 列出要避开的公司(竞争对手、现有客户、之前跑过的结果);effort 默认 low,大名单或难名单用 auto、high 或 xhigh。
- 若 agent_run 返回 status: "running" 并带有 agent_run_... ID,保存该 ID 并仅用 runId 继续调用 agent_run,直到 outputReady 为 true 或进入 failed/cancelled 终态。
- 从结果中读取 output.structured 里的公司列表、output.grounding 里的引用来源,以及 costDollars 里的运行成本;不要把完整原始输出贴进对话,直接进入 CSV 环节。
- 把 output.structured.companies 写入 {target_company}_leads_{YYYY-MM-DD}.csv,按 icp_fit_score 降序排序,数组字段用 " | " 连接;用 Bash 调 Python 的 csv.writer(可正确处理引号转义),小列表可直接用 Write 写。
- 打印汇总:总线索数、ICP 分数分布(8-10 / 5-7 / 1-4 各多少)、Run ID、成本、输出文件名。
- 需要更多线索时,用 previousRunId 指向已完成 run 的 ID 新建后续 run 请求更多公司,并把已收集的公司记录放进 input.exclusion 避免重复,然后把新结果追加到 CSV 并按归一化公司名(去掉 Inc/Ltd 等、忽略大小写)重新去重。
- 名单达到数百条时,改为顺序跑多个小 run 而不是一个巨型 run,并先与用户确认范围(例如“这需要约 {N} 次 Agent run,是否继续?”)。
- 处理失败:run 失败时读取错误信息,调整 query 或 schema 后用不同措辞重试一次;需要客户端取消时中止进行中的 agent_run 调用;若结果持续少于请求数量,把 ICP 拆成 2-3 个子垂直领域分别跑,而不是一个宽泛的 run。
- 配置 Exa MCP:需要 Exa API key(在 https://dashboard.exa.ai/api-keys 获取),MCP 服务器用 http 类型、URL 为 https://mcp.exa.ai/mcp?tools=agent_tools、请求头带 x-api-key。
- 工具限制:只用 agent_run 加上 Write 和 Bash(用于 CSV 输出),不要用通用网页搜索来生成名单本身;若 Agent 工具不可用,告知用户需安装带 Agent 工具的 Exa MCP 服务器并提供 API key(说明见 https://docs.exa.ai/reference/exa-mcp),然后停止。
适用边界 · 注意事项
- 需要极大规模或持续维护、且要求逐条验证的名单时,应改用 Exa Websets(https://docs.exa.ai/websets/api/overview)。
- 未安装带 Agent 工具的 Exa MCP 服务器或没有 Exa API key 时无法使用。
- 不要用通用网页搜索来生成名单本身,必须走 agent_run。