Metadata-Version: 2.4
Name: acps-sdk
Version: 2.1.0
Summary: ACPs SDK - Agent Collaboration Protocols SDK
Author-email: Team <team@ioa.pub>
License-Expression: MulanPSL-2.0
License-File: LICENSE
Requires-Python: <4.0,>=3.10
Requires-Dist: aio-pika>=9.0.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# 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 管理依赖与构建。

```bash
# 安装 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. 构建和发布

```bash
uv build
```

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

发布到 PyPI：

```bash
uv publish --token <PyPI_TOKEN>
```

## 2. 目标项目中SDK的安装

### 2.1 使用pip

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

从 PyPI（发布后）:

```bash
pip install acps-sdk
```

从本地 wheel 文件:

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

### 2.2 使用 uv

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

从 PyPI（发布后）：

```bash
uv add acps-sdk
```

从本地 wheel 文件：

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

从本地源码：

```bash
uv add --editable ../acps-sdk
```

## 3. SDK使用示例代码

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