acps-sdk 2.1.0

ACPs SDK - Agent Collaboration Protocols SDK

ACPs SDK

Agent Collaboration Protocols（智能体协作协议体系）SDK — ACPs 协议体系的 Python 实现。

目前本SDK包含以下模块：

模块	说明
acps_sdk.acs	Agent Capability Specification 智能体能力描述
acps_sdk.adp	Agent Discovery Protocol 智能体发现协议
acps_sdk.aic	Agent Identity Code 智能体身份码
acps_sdk.aip	Agent Interaction Protocol 智能体交互协议

1. SDK本地开发环境

1.1. 开发环境搭建

建议使用 Python 3.10+，并通过 uv 管理依赖与构建。

# 安装 uv（若尚未安装，推荐使用官方安装脚本）
# macOS / Linux（用户级全局安装）
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell，用户级全局安装)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 克隆仓库
git clone <仓库地址>
cd acps-sdk

# 安装并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 安装SDK项目的依赖
uv sync

1.2. 构建和发布

uv build

生成的 wheel 和 sdist 将位于 dist/ 目录。

发布到 PyPI：

uv publish --token <PyPI_TOKEN>

2. 目标项目中SDK的安装

2.1 使用pip

在需要使用本SDK的Python环境中，可以通过 pip 安装。

从 PyPI（发布后）:

pip install acps-sdk

从本地 wheel 文件:

pip install path/to/acps_sdk-2.0.0-py3-none-any.whl

2.2 使用 uv

在需要使用本SDK的项目，推荐使用 uv 管理依赖。

从 PyPI（发布后）：

uv add acps-sdk

从本地 wheel 文件：

uv add path/to/acps_sdk-2.0.0-py3-none-any.whl

从本地源码：

uv add --editable ../acps-sdk

3. SDK使用示例代码

from acps_sdk.acs import AgentCapabilitySpec
from acps_sdk.aip import AipRpcClient, TaskState
from acps_sdk.aic import validate_aic_format, parse_aic