官方 SDK已核实可用2026-09-23
TypeSafe Python SDK
严格依据官方公开示例整理的服务端 Python 最小接入,并明确标出生产保护参数仍需核对的部分。
安装
uv add typesafe-sdk服务端环境变量
TYPESAFE_API_KEY准备事项
- 受支持的 Python 环境
- 保存在源码仓库之外的 TypeSafe API Key
- 当前版本的 Python SDK 文档
接入步骤
- 1安装官方 typesafe-sdk 包。
- 2在服务端环境变量中设置 TYPESAFE_API_KEY。
- 3在上下文管理器内创建 TypeSafeClient。
- 4提交状态数据和命名的 Choice 判断标准。
- 5从响应中读取选择结果。
- 6用于生产环境前,根据当前 SDK 文档补上经过核对的超时、重试、校验和人工复核机制。
服务端示例
import os
from typesafe_sdk import Choice, TypeSafeClient
api_key = os.environ.get("TYPESAFE_API_KEY")
if not api_key:
raise RuntimeError("TYPESAFE_API_KEY is required")
with TypeSafeClient(api_key=api_key) as client:
response = client.system_one(
state={"ticket": "I was charged twice. Please fix this ASAP."},
questions={
"route": Choice(
instructions="Choose the support queue.",
criteria={
"billing": "Payments, invoices, refunds, or duplicate charges",
"technical": "Product behavior, errors, or integrations",
"other": "Everything else",
},
)
},
)
print({"route": response.choices["route"].choice})生产检查
- 把凭证保存在密钥管理服务或服务端环境变量中。
- 触发自动操作前校验响应字段。
- 根据安装的 SDK 版本核对并设置有限超时与重试策略。
- 模糊或高影响决策需要人工复核。
限制与核实说明
截至 2026-09-23,本目录在公开 README 中没有核实到超时与重试构造参数,因此示例没有虚构这些参数。用于生产环境前需查阅当前 SDK 参考文档。
来源
- TypeSafe AI Python SDKTypeSafe AI · 2026-09-23打开来源
- TypeSafe API referenceTypeSafe AI · 2026-09-23打开来源
这份指南由 Type Safe 独立整理。使用前请核对提供方的当前文档、版本和条款。