使用文档

开始使用

1. 从官网点击免费试用，注册或登录后直接进入产品。团队版 1 席起，个人版不再新购和新试用；购买统一从官网价格页发起，当前空间、试用与订阅状态以实际账户为准。
2. 整理企业介绍、产品、优势和业务偏好。已有资料可继续使用，Agent 生成的企业本体草稿需要审阅后保存。
3. 告诉 Agent 本轮目标，例如“寻找法国储能电池相关企业，先找 10 家”。任务会记录这次的产品、市场和数量。
4. 在客户池查看公司、官网与依据，再安排背调、营销准备和后续跟进。

原个人版用户保留原空间、资料和历史权益，就地兼容升级；团队版从首页协调 Agent 开始，也可进入业务模块直接处理任务。历史回复是当时的结果，最新状态请查看对应客户或任务。

进入工作空间 ↗

团队版与企业定制

团队版不按 Agent 和工作群数量单独收费，执行仍受额度、权限与并发规则约束。倍率增加资源规格，不保证获得固定数量的客户；原个人版历史权益与记录保留。

以上为当前默认成交价格，团队多成员按所选档位单价乘以真人席位数。实际可购买规格、价格与生效权益以购买页和确认订单为准；所示价格不再重复计算折扣。订阅按月手动续费，企业定制不在标准套餐页面自动下单。

免费试用

注册后可在未开通的单人空间领取一次免费试用额度，使用团队版单席试用。它按账号一次发放，历史个人版领取也计入一次性记录，刷新页面、创建或切换空间、跨月均不会再次赠送；已有付费权益和订单不会被试用覆盖。

试用会扣除实际发生的检索、读取、模型等服务成本，执行前的费用预占也会计入可用额度。它不是现金余额，不保证完成固定数量的客户任务，用完后可选择购买套餐；购买后的正式额度与原试用记录分开管理。

免费试用 ↗

查看与使用额度

在用户设置 → 套餐额度查看当前套餐、剩余百分比、预占状态与重置日期。额度依据实际发生的平台服务成本结算，不把一条线索、一个联系人或一封邮件换算成固定次数套餐。执行前会预占预计费用，取得有效回执后结算；结果或费用尚未确认时，预占可能暂时保留。

没有找到匹配客户也可能已经产生检索或资料分析成本。额度不是现金余额，也不等同于保证的工作成果；供应商余额和限制与平台额度分别生效。

¥99 加油包

有效订阅可购买加油包，将当前套餐本月额度恢复至满额，随后重新累计使用。它是重置，不是叠加余额；不增加席位、不切换套餐、不延长订阅或改变下一次重置日期，历史订单和消耗记录保留。团队版作用于当前团队共享额度，由有购买权限的所有者操作。

查看套餐与购买页 ↗

创建与切换空间

在用户设置 → 切换空间查看自己有权限进入的空间，选择后切换。不再提供创建个人空间入口；原有空间继续就地使用，不复制或删除业务数据。

原个人版空间就地兼容升级，保留企业本体、客户、任务、Agent、文件、权限、有效期、额度、订单及历史试用记录。不自动收费或重置权益；套餐购买与试用领取仍须明确提交。

个人空间与团队空间分别管理权限、产品有效期和额度。工作空间是业务数据范围，不等同于购买独立服务器；专属部署属于企业定制的交付选项。

打开切换空间 ↗

团队首页 Agent

团队首页是一个独立的协调 Agent。可以交代目标、读取文件、查询进展，或用 @ 指定当前空间的业务 Agent 接手。它会在你的成员权限和已开通功能范围内工作，涉及发布、删除或对外发送等操作时需要确认。

每天进入默认是新聊天，不自动铺开旧对话。历史对话展示最近七天仍有更新的会话，可以选中后接着工作；超期首页会话按保留规则清理，已经产生的客户、任务和业务记录保留。

输入框可上传文件，单个文件最多 20 MB，每条消息最多 10 个附件，支持常见办公文档、文本和图片。文档解析失败时可调整文件格式或上传页面图片；不保证扫描件、加密文件或所有格式都能读取。

滑块从快速到深度思考调整处理方式；更深的思考可能需要更长时间。长对话会整理较早上下文，并按需检索原文，单次输入和文件读取仍受服务限制。

点击如何使用可跟随实际界面了解输入、上传、@、思考滑块、发送和历史。会话里的业务链接可以打开对应任务或客户记录。

工作群与任务交接

团队版可建立 Agent 工作群，选择成员并指定负责人。群的作用是围绕一个业务目标安排分工，由负责人统筹、成员接手并在原群汇报实际结果；也可以把消息交给指定成员。

例如“找法国储能客户，背调后准备开发方案”，在你明确授权连续工作后，负责人可安排获客、背调和营销准备。看到“这批客户”时，优先承接当前群已经保存的业务批次；发送安排仍由你在营销任务中核对并启动。

暂停协作会停止后续交接，已提交的子任务需要在原任务页管理。团队页的工作交接默认查看当天更新，完整记录仍可从对应群和任务查阅。只有真实完成的交接和回报会显示，不把演示数据当成实际工作。

点击 Agent 头像可以选择造型与颜色，预览后保存；改名和切换职责不会重新生成头像。团队成员权限、共享资料和企业连接由管理员在企业设置中管理。

企业资料与业务本体

业务本体包括企业介绍、产品线、优势、目标市场、合作对象与业务偏好。它为 Agent 提供背景，你可以直接整理资料，也可以让 Agent 生成草稿后审阅保存。

当前空间继续使用原企业本体与资料；团队成员依权限共享。管理员更新后，新任务使用已确认的最新资料，已经提交的任务保留当时的配置。

本体提供判断背景，不要求候选企业满足其中每一个身份和描述。每轮任务的产品与国家由该轮目标确定，匹配依据会保留在客户记录中。

获客与客户池

客户发现先核对可复用的企业资料，再围绕产品关键词寻找新的公司官网。新建获客任务优先确认公司名称、独立企业官网、目标国家和产品或上下游业务关联，再读取官网资料进行判断。

进口商、分销商、批发商、集成商等是优先角色，用于匹配评分，不作为新轮次的入池硬门槛。同业制造商、供应商、零售商或其他业务相关企业，也可能成为合作对象。匹配得越充分，开发优先级可以越高。

缺少公司、国家或业务证据的线索会保留待核实；目录、社区等页面本身不能当作企业官网。网站语言、域名后缀或向某国销售，不等同于确认公司位于该国。旧运行保留提交时的配置和策略。

• 运行记录：每轮分别展示发现线索、企业候选、已完成核查及入池客户；线索条数不等于公司家数。
• 本轮目标：是期望数量，不是结果承诺。网站访问、证据、额度或外部服务状态都可能影响实际结果。
• 中断与继续：已确认入池的客户保留；再次执行可承接已保存的进度。
• 客户池：用统一筛选条筛选状态、国家和业务标签，支持搜索、排序、全选与批量操作。公司标题旁可快速预览，更多操作集中在菜单中。
• 当前状态：新发现、已背调、已营销、已触达和已丢弃用于安排下一步工作；匹配分不代表已经确认采购意向。

背调与联系方式补全

从客户池选择公司，可以单独或批量发起背调，也可以让 Agent 安排。背调整理公司业务、产品与渠道、相关依据、关键岗位和可用联系渠道，帮助判断下一步。

联系人补全使用当前已配置的数据来源，有效结果会尽量复用。公开程度和数据源覆盖不同，不能保证每家公司都有联系人、邮箱或电话。普通电话不等于已核实的 WhatsApp。

公司资料、联系人和来源依据在客户记录中查看；需要补证的情况会保留，避免把没有读到资料直接当成业务不相关。

营销、附件与消息

1. 在用户设置 → 业务邮箱连接自己的发件邮箱。需要接收回复时，再配置收件服务并同步。
2. 建立营销策略，选择语言、写作要求和跟进轮次。策略附件可与内容一起审阅。
3. 从客户池选择公司创建营销任务，核对收件人、策略、草稿、附件与发送安排。
4. 确认后在产品中启动任务。后续轮次按已确认策略、收件人状态与任务规则执行。

邮件和 A2A 商务来信从消息查看；Agent 私聊和工作群从原会话进入。A2A 问答与询盘不会被当作内部业务指令，询价需要继续核实。

邮件显示“已发送”表示发件服务受理，不表示已送达、已阅读或客户认可。发送前使用有权处理的联系资料，尊重拒收与退订。外部 API / MCP 可以准备内容和任务，不能直接启动营销发送。

A2A 业务身份与公开接待

基础 A2A 身份与公开商务接待可由已开通外贸产品的个人或团队空间使用。它与企业版定制的 Agent Web 是不同范围；公开模型接待消耗当前空间使用额度。

在用户设置的「A2A 身份」中创建身份 Agent。它和其他 Agent 一样占用当前套餐的 Agent 名额，可以整理公开介绍、保存身份草稿，并读取商务来信。

以当前空间企业已授权的真实业务本体和知识资料为来源。示例图谱和神经网络展示不作为真实业务资料，文件向量知识尚未接入。只有经管理员审阅发布的介绍、产品、市场和联系页面进入公开接待范围。

1. 选择管理 Agent，整理并核对业务名片，保存草稿。
2. 确认发布，开放公开商务接待。回答使用本空间模型额度，并受频率、会话及预算限制；修改草稿不会自动覆盖已公开内容。
3. 复制 Agent Card 或 A2A 对话地址，交给其他 Agent 即可开始首次咨询，无需提前获取连接凭证。

POST https://ai.atoai.si/api/v1/public/{identityId}/a2a
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": "business-request-1",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "business-message-1",
      "role": "ROLE_USER",
      "parts": [{"text": "请介绍你们公开的产品，是否适合欧洲渠道合作？"}]
    }
  }
}

POST https://ai.atoai.si/api/v1/public/{identityId}/a2a
Content-Type: application/json
A2A-Version: 1.0
X-TOAI-Guest-Session: <GUEST_SESSION_TOKEN_FROM_FIRST_RESPONSE>

{
  "jsonrpc": "2.0",
  "id": "business-request-2",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "business-message-2",
      "contextId": "CONTEXT_ID_FROM_FIRST_RESPONSE",
      "role": "ROLE_USER",
      "parts": [{"text": "我们正在评估渠道合作，请说明需要补充哪些需求信息。"}]
    }
  }
}

询价与合作方凭证

访客可提交询价需求。RFQ 仅保存为待核验记录，产品、数量、市场与联系方式均为提交方声明，不表示身份已确认、价格已批准或订单已成立。管理员可在右上角「消息 → A2A」查看真实问答及询价内容，再决定后续处理。询价保留「待核验」状态，不会因查看消息自动报价或创建任务。

提交结构化 RFQ 时，在同一个 params 中加入 metadata.toaiRfq；product 必填，所有字段均为字符串：

"metadata": {
  "toaiRfq": {
    "product": "储能逆变器",
    "quantity": "100",
    "unit": "台",
    "market": "德国",
    "requirements": "希望了解公开产品的合作方式",
    "contact": "可用于商务跟进的联系方式"
  }
}

询价入口不会返回私有价格，不自动生成内部报价或订单。请只提供有权用于商务联系的信息，不要提交账户密码、支付资料或身份证件。

合作方访问凭证用于已发布公开资料的受控访问，不是首次咨询的前提，也不是内部 API 权限或企业资质认证。为合作方分别签发、设置有效期并妥善保存；明文只显示一次，服务端保存验证摘要。撤销对应凭证会阻止其后续访问，停止公开会关闭公开身份与商务接待；已被第三方保存的副本无法自动收回。

toai 内部 API 与 MCP 继续使用独立密钥和原有权限。公开商务接待不提供私有报价、订单访问、自动下达付费任务或自动营销发送；这些业务需要另外的明确授权和后续流程。

管理 A2A 身份 ↗

企业知识与自有连接

企业总台可以查看当前空间已保存的本体与工作关系，也提供知识图谱和工作网络示例。示例与真实资料分开显示；10 GB 文件空间是规划说明，不代表已经分配存储、完成文件解析或建立了向量知识库。

团队版可配置受支持的 DeepSeek、OpenAI 模型 API。自有模型处理的推理由对应供应商计费，其他平台服务按实际发生的成本结算；模型余额、频率和可用性仍由供应商决定。首页及公开接待有各自的模型配置范围，并非所有场景都能使用任意自有模型。

团队的外部企业数据库连接支持经过平台地址登记和字段映射的 PostgreSQL 只读公司资料查询。它是受控接入，不提供任意 SQL、写回或所有企业系统的自动同步。

资料管理目前汇总企业资料、工作记录等已有入口；企业总台的示例文件不等于可上传管理的通用文档库。

企业版定制

需要更多沟通渠道或专属业务系统时，可按企业需求确认定制范围、权限、接入条件和交付内容。

这些页面介绍企业定制方向，不表示标准订阅已自动连接相应账号、生成网站或安装插件。基础 A2A 身份与 API / MCP 继续按当前产品权益使用。

了解企业定制 ↗

连接你的 AI

进入用户设置 → API 与 MCP，创建一个有明确用途的访问密钥。默认只勾选读取权限；需要创建任务或生成内容时，再勾选对应操作权限。

远程 MCP

在支持 Streamable HTTP 与自定义 Authorization 请求头的客户端添加：

MCP URL: https://ai.atoai.si/api/mcp/
Authorization: Bearer <你的 TOAI 访问密钥>

地址末尾保留斜杠。密钥放入客户端的凭据设置，不要作为提示词或聊天内容发送。

{
  "mcpServers": {
    "toai": {
      "url": "https://ai.atoai.si/api/mcp/",
      "headers": {"Authorization": "Bearer <TOAI_API_KEY>"}
    }
  }
}

上面是常见配置结构，实际字段以客户端为准。当前使用访问密钥鉴权，尚未提供 OAuth 登录授权；只支持 OAuth 的远程连接入口暂不能直接接入。

仅支持本地 stdio 的客户端

发布包提供 toai-mcp-stdio.py。在本地 Python 3.12 环境安装 mcp==2.3.0，通过 TOAI_API_KEY_FILE 指向仅本人可读的密钥文件，并将脚本配置为客户端的 MCP 启动命令。脚本仅转发 toai 的授权操作，不会启动搜索或自动发送邮件。

连接后可以这样说

• “先读取我的业务本体，告诉我当前客户池和任务情况。”
• “按我的产品方向，创建一个找德国进口商的任务，先保存让我确认。”
• “查看这个任务最新进度，把符合条件的客户列出来。”
• “对我选中的公司做背调，再准备一封首次开发信，先不要发。”

由你使用的大模型理解对话、选择工具；toai 验证权限、执行程序并返回真实结果。外部模型读取到的数据也会交由该模型服务处理，请选择你信任且适合业务数据要求的客户端。

调用 API

基础地址：https://ai.atoai.si/api/open/v1。查询能力清单使用 GET，业务操作统一使用 POST JSON。API 与 MCP 使用同一份操作、权限及额度。

打开 OpenAPI 规范 ↗

GET /api/open/v1/capabilities
Authorization: Bearer <TOAI_API_KEY>

POST /api/open/v1/actions/list_customers
Authorization: Bearer <TOAI_API_KEY>
Content-Type: application/json

{"stage":"unmarketed","limit":20}

成功返回 {"data": ...}；错误返回 {"error":{"code":...,"message":...},"meta":{"requestId":...}}。保留错误码及请求标识便于排查，不要转发密钥。

保存一个获客任务

POST /api/open/v1/actions/create_task

{
  "requestId": "my-task-20261021-001",
  "product": "industrial valves",
  "buyerType": "importer",
  "marketCodes": ["DE"],
  "quantity": 10,
  "notes": "",
  "intent": "save"
}

save 只保存，execute 会尝试进入执行队列。执行成功返回已接受的任务，不表示搜索已经完成。使用 get_task 查询状态，建议至少间隔 5 秒。

重复请求与分页

每次独立写操作提供 8–120 位 requestId，仅包含字母、数字、下划线或短横线。网络超时后重试要保留同一密钥、同一 requestId、同一参数；不要自动换新 ID。更换密钥后不能依靠原回执去重，应先查状态。

修改已有记录时先读取最新 revision，通过 expectedRevision 提交；遇到 409 重新读取再决定。分页使用返回的 nextCursor，不要拼接或猜测；一页记录数不代表全部数量。请求正文上限为 256 KiB。

开放能力

连接后只显示该密钥授权的工具。完整参数以 OpenAPI 或 MCP 返回的 inputSchema 为准。

control_marketing_activity 仅支持暂停与停止。开放接口不提供直接发送、启动或恢复营销任务、管理发件凭据、管理用户或管理员权限的操作。附件在 toai 的营销策略页面管理。

权限、额度与数据

密钥只操作创建时所属的工作空间，不能通过传入 workspaceId 切换用户。产品到期、功能被暂停、密钥到期或撤销后，相应请求会被拒绝。

每空间最多 20 个有效密钥；单密钥每分钟最多 60 次请求，同空间全部密钥合计每分钟最多 120 次。打开接口不额外赠送额度；实际执行仍受套餐、成本预算、单轮及供应商限制。

读取已有数据通常不会触发付费采集；执行获客、背调补全和生成营销内容使用已有服务与额度规则。任务可能因额度或服务状态暂时停止，不能绕过页面限制。

密钥只在创建后展示一次，服务端保存验证摘要。撤销阻止后续请求，但不自动停止已提交的后台工作；如需停止，先在任务中操作。调用记录保留操作名、时间、状态和请求标识，不记录密钥或完整请求正文。

常见问题