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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
acps_sdk-2.1.0.tar.gz
(168.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
acps_sdk-2.1.0-py3-none-any.whl
(86.6 kB
view details)
File details
Details for the file acps_sdk-2.1.0.tar.gz.
File metadata
- Download URL: acps_sdk-2.1.0.tar.gz
- Upload date:
- Size: 168.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
84d3f337e94515438a355a5558057d6e16260f3c832be70255f0125d87e3502b
|
|
| MD5 |
46e63b35c5e01783769aae0f88b2890a
|
|
| BLAKE2b-256 |
1e729ea991f73af586374135b05e1af0c1300a6c49ce198f9a37ab6ef471cc5e
|
File details
Details for the file acps_sdk-2.1.0-py3-none-any.whl.
File metadata
- Download URL: acps_sdk-2.1.0-py3-none-any.whl
- Upload date:
- Size: 86.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
381f766d850f587891e458d36211166e93dc026d23ef3aabed4cb61606333790
|
|
| MD5 |
a6ab420cfa775c8a8b9c84c58a00dcbd
|
|
| BLAKE2b-256 |
fa5bae6bdd2b2c0083ccd42cebbaaec30a31a1e76acc22a49da0e423112f6d4b
|