LinkSoul AgentSDK for Python v1.4.0
LinkSoul AgentSDK for Python v1.4.0
⚠️ 验签方式标准化（不兼容 v1.3.0 及更早版本）/ Breaking auth change
v1.4.0 已遵循灵心开放平台规范，对 SDK 的鉴权（验签）方式做了标准化改造，v1.3.0 及更早版本无法直接平滑升级：
项目 v1.3.0 及更早 v1.4.0 网关 URL wss://agentsdk.agibot.com/v1/agentsdkwss://open.agibot.com/api/V1/open-portal/app/wss/agent-sdk凭证来源 灵心平台「二开智能体模板」 灵心开放平台「应用」（新增 app_key）创建方法 AgentSdk.create(url, app_id, app_secret)AgentSdk.create(url, app_id, app_key, app_secret)鉴权机制 JWT（ AGIBOT_AUTHORIZATION请求头）HMAC-SHA256（5 个请求头： X-App-Id/X-App-Key/X-Timestamp/X-Nonce/X-Signature）回调类型 JWT payload 独立请求头 X-Callback-Types（JSON 数组字符串）升级路径见 zh/CHANGELOG.md / en/CHANGELOG.md。
v1.4.0 standardises the AgentSDK signing scheme to match the LinkSoul open-platform spec and is NOT backward compatible with v1.3.0 or earlier. JWT auth is replaced by HMAC-SHA256 with five signed request headers (
X-App-Id/X-App-Key/X-Timestamp/X-Nonce/X-Signature);AgentSdk.create()now takes an extraapp_keyparameter, credentials are issued by an application on the open platform, and the gateway URL has changed. See the CHANGELOGs above for the migration path.
选择语种 / Choose locale
| 语种 / Locale | 入口 |
|---|---|
| 简体中文 | zh/index.md |
| English | en/index.md |
章节速览 / Section quick-links
| Section | 中文 | English |
|---|---|---|
| Home / 首页 | zh/index.md | en/index.md |
| Quick Start / 快速开始 | zh/guide/quickstart.md | en/guide/quickstart.md |
| Architecture / 架构 | zh/guide/architecture.md | en/guide/architecture.md |
| Passive guide / 被动交互 | zh/guide/passive_callbacks.md | en/guide/passive_callbacks.md |
| Active guide / 主动交互 | zh/guide/active_operations.md | en/guide/active_operations.md |
| Task-flow payload / 任务流协议 | zh/guide/taskflow_payload.md | en/guide/taskflow_payload.md |
| Semantic skills / 语义技能 | zh/guide/skills.md | en/guide/skills.md |
| AgentSdk API | zh/api/agent_sdk.md | en/api/agent_sdk.md |
| Passive callbacks API | zh/api/passive_callbacks.md | en/api/passive_callbacks.md |
| Active requests API | zh/api/active_requests.md | en/api/active_requests.md |
| Enums | zh/api/enums.md | en/api/enums.md |
| Examples / 示例 | zh/examples/ | en/examples/ |
| Glossary / 名词解释 | zh/glossary.md | en/glossary.md |
| Changelog | zh/CHANGELOG.md | en/CHANGELOG.md |
与 Java SDK 的关系 / Relationship to the Java SDK
同版本的 Java SDK v1.4.0 文档 是配套实现， API 面与协议都等价；本套文档仅做以下 Python 化：
- 模块路径：
com.agibot.aiem.sdk.*→linksoul_agentsdk.* - 命名：
camelCase→snake_case（onRequest→on_request、registerAudio2Llm→register_audio2_llm…） - 异步原语：Java 用 Netty，本 SDK 用
websocket-client+threading（同步阻塞）
The Java SDK v1.4.0 docs describe the sibling implementation. The
public surface and wire protocol are equivalent; the Python build only differs in naming
(camelCase → snake_case) and threading primitives (websocket-client + threading).