CRM 与 ERP 等企业系统如果仅依靠人工点击按钮或临时编写脚本，其效率提升空间非常有限。Manus API 要解决的核心痛点，正是让这些系统能够自主拆解复杂任务、调用数据库、甚至自动生成报告——相当于为系统装上了“智能大脑”，同时所有控制权依然保留在你手中。它不提供聊天界面，而是提供更底层的自动化引擎能力，非常适合需要深度集成的场景。
获取 API 密钥与基础凭证
登录 Manus 控制台后，进入「开发者中心」→「API 密钥管理」页面，点击「新建密钥」。
填写应用名称，例如 "CRM-integration"，然后选择权限范围。至少需要勾选 【Task.Submit】 和 【Session.Create】，其他权限根据实际业务需求添加。这里有一个重要提醒：不要为了方便直接勾选“全权限”，密钥一旦泄露，权限范围越小越安全，建议遵循最小权限原则。
确认后页面会显示 client_id 和 secret_key。注意：这是唯一一次完整展示 secret_key，请立即复制保存，刷新后便无法再次查看。
同时记录下 API endpoint 地址，默认为 https://api.manus.ai/v3，企业版用户可能会被分配独立域名，请以控制台实际显示为准。
Python 环境初始化与 SDK 安装
Python 版本至少需要 3.9，建议直接使用 3.12 或更高版本，以避免后续兼容性问题。
安装最新版 Manus SDK 非常简便，只需一行命令：
pip install manus-sdk --extra-index-url https://pypi.manus.ai/simple/
接着创建配置文件 .env，将凭证存入其中——永远不要将敏感信息硬编码在源码中：
MANUS_CLIENT_ID=your_client_id_here MANUS_SECRET_KEY=your_secret_key_here MANUS_API_ENDPOINT=https://api.manus.ai/v3
初始化客户端实例时，三个参数缺一不可：
from manus import Client
import os
client = Client(
client_id=os.getenv("MANUS_CLIENT_ID"),
secret_key=os.getenv("MANUS_SECRET_KEY"),
endpoint=os.getenv("MANUS_API_ENDPOINT")
)
创建会话并提交首个任务
第一步总是创建会话（Session），它相当于一个状态容器，后续所有任务都会绑定在这个上下文环境中：
session = client.sessions.create(name="crm-lead-analysis")
会话创建成功后，获取 session.id，然后可以提交一个结构化任务：
task = client.tasks.submit(
session_id=session.id,
description="分析ID为LEAD-2026-7891的客户线索，提取行业、预算区间、决策链角色，并判断是否需触发销售跟进流程",
metadata={"source": "crm", "lead_id": "LEAD-2026-7891"}
)
这里有一个常见的易错点：metadata 字段必须是 dict 类型，不能是字符串或 None，否则 API 会直接返回 400 错误。
提交后立即返回 task 对象，其中包含 task.id 和 status="pending"——此时任务只是进入队列，尚未开始执行。
轮询任务状态并获取结果
Manus 默认采用异步执行模型，因此不能阻塞等待。需要通过轮询来获取任务进展：
① 调用 client.tasks.get(task_id=task.id) 获取当前状态；
② 检查返回对象中的 status 字段：如果是 "completed"，则读取 result 字段；如果是 "failed"，检查 error 内容；如果是 "running" 或 "pending"，等待 2 秒后重试；
③ 设置最大重试次数为 30 次（大约 60 秒），超时后主动中断并记录告警。注意：Manus 单任务默认最长执行 45 秒，超过此时间会被判定为异常挂起。
示例代码中，result 是一个 JSON 序列化的字典，其结构由任务语义自动推导。例如可能返回如下内容：{"industry": "SaaS", "budget_range": "50k-100k", "decision_makers": ["CTO", "Procurement Manager"], "needs_followup": true}。
整个集成流程搭建完成后，你的系统就能自主完成线索分析、报告生成等工作，无需人工轮询和手动填写数据。这才是真正将 Manus API 落地应用的正确方式，能够显著提升 CRM、ERP 等系统的自动化水平和工作效率。