用途：Opper Python SDK（包名 opperai）用于以声明式方式构建 AI 应用，覆盖任务补全、结构化输出、知识库语义搜索和追踪可观测性。
安装与认证：pip install opperai；设置 API key 环境变量 export OPPER_HTTP_BEARER="your-api-key"，key 来自 platform.opper.ai。SDK 需显式传入：opper = Opper(http_bearer=os.environ["OPPER_HTTP_BEARER"])。
核心用法：opper.call() 是主要接口，用 name、instructions、input 声明任务。无 output_schema 时读取 response.message（str）；传入 output_schema 时读取 response.json_payload（dict 或 list）。output_schema 使用 JSON Schema 字典定义。可用 model 参数指定模型，或用列表构成回退链；支持 examples 少样本示例。
可观测性：用 opper.spans.create 创建 span，调用时传 parent_span_id 形成层级；用 opper.span_metrics.create_metric 记录指标；opper.traces.list() 列出追踪。
知识库：opper.knowledge.create 创建知识库，add 添加文档，query 做语义检索并返回内容与分数。
响应字段：span_id、message、json_payload、cached、usage、cost。
限制与注意：每次调用需要唯一 name 以便追踪；大文档应分块并改用知识库；未正确区分 message 与 json_payload 会取不到结果。函数 CRUD、RAG、流式等更多内容见仓库 references 文档。相关技能有 opper-python-agents、opper-node-sdk。资料未提供具体收费与价格信息。