Type Safe
返回集成目录
官方 SDK已核实可用2026-09-23

TypeSafe Python SDK

严格依据官方公开示例整理的服务端 Python 最小接入,并明确标出生产保护参数仍需核对的部分。

安装

uv add typesafe-sdk

服务端环境变量

TYPESAFE_API_KEY

准备事项

  • 受支持的 Python 环境
  • 保存在源码仓库之外的 TypeSafe API Key
  • 当前版本的 Python SDK 文档

接入步骤

  1. 1安装官方 typesafe-sdk 包。
  2. 2在服务端环境变量中设置 TYPESAFE_API_KEY。
  3. 3在上下文管理器内创建 TypeSafeClient。
  4. 4提交状态数据和命名的 Choice 判断标准。
  5. 5从响应中读取选择结果。
  6. 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 参考文档。

来源

这份指南由 Type Safe 独立整理。使用前请核对提供方的当前文档、版本和条款。