useInterseptix/interseptix-python
GitHub: useInterseptix/interseptix-python
为 AI Agent 提供零配置 IAM 与策略执行的 Python SDK，通过拦截出站 HTTP 调用实现访问控制、数据脱敏和审计日志记录。
Stars: 0 | Forks: 0
# Interseptix Python SDK
为 AI agent 提供零配置的 IAM 和策略执行。
仅需两行代码。您的 agent 无需修改即可运行。Interseptix 会拦截每一个出站 HTTP 调用——执行策略、脱敏 PII，并使用加密签名记录所有操作。
## 安装
```
pip install interseptix
```
## 快速开始
```
import os
from interseptix import InterseptixClient
sdk = InterseptixClient(api_key=os.environ["INTERSEPTIX_API_KEY"])
sdk.set_agent(agent_id=os.environ["AGENT_ID"])
# 完全像以前一样运行你的 agent —— 无需进行任何其他更改
agent = create_react_agent(llm, tools=[...])
agent.invoke({"messages": [("user", "Process refund for order 123")]})
```
就是这么简单。Scope 和策略都在您的[控制面板](https://interseptix.com)中进行配置，并会在您的 agent 发起的每次调用中自动执行。
## 幕后原理
您的 agent 发起的每一个 HTTP 调用在执行前都会被拦截：
- **超出 scope** → 拦截，触发 `PermissionError`
- **匹配拒绝规则** → 拦截
- **超过速率限制** → 拦截
- **需要人工审批** → 在队列中暂存
- **包含 PII** → 记录日志前进行脱敏
- **所有操作** → 使用加密签名进行记录
## 环境变量
| 变量 | 描述 |
|---|---|
| `INTERSEPTIX_API_KEY` | 来自控制面板的组织 API key |
| `AGENT_ID` | 注册时签发的 agent ID |
| `INTERSEPTIX_BASE_URL` | 覆盖 API URL（默认：`https://interseptix.com/v1`） |
## 环境要求
- Python 3.9+
- `httpx`（自动安装）
## 链接
- 控制面板：[interseptix.com](https://interseptix.com)
- 问题反馈：[github.com/useInterseptix/interseptix-python/issues](https://github.com/useInterseptix/interseptix-python/issues)
标签：AI智能体, Python SDK, Streamlit, 人工智能, 数据脱敏, 用户模式Hook绕过, 知识图谱, 访问控制, 身份认证与管理, 运行时操纵, 逆向工具