Python SDKTypeSafe Python SDK

在 GitHub 上浏览 Python SDK 源码。

面向 TypeSafe API 的异步与同步 Python 客户端。在这里了解如何使用 TypeSafe。

快速开始

  1. 安装 SDK:

    sh
    uv add typesafe-sdk
    
    sh
    pip install typesafe-sdk
    
  2. 在环境中设置 TYPESAFE_API_KEY(可在此处创建)

  3. 调用 System One API:

    使用 AsyncTypeSafeClient:

    python
    from typesafe_sdk import AsyncTypeSafeClient, Choice, Noul, Score
    
    
    async def main() -> None:
        async with AsyncTypeSafeClient() as client:
            response = await client.system_one(
                state={"document": "I was charged twice. Please fix this ASAP."},
                questions={
                    "billing": Noul(instructions="Is this ticket about billing?"),
                    "tone": Choice(
                        instructions="What is the customer's tone?",
                        criteria={"calm": None, "frustrated": None, "angry": None},
                    ),
                    "urgency": Score(
                        instructions="How urgent is this ticket?",
                        criteria=["can wait", "this week", "today"],
                    ),
                },
            )
    
        print(response.nouls["billing"].noul)
        print(response.choices["tone"].choice)
        print(response.scores["urgency"].score)
    

    使用 TypeSafeClient:

    python
    from typesafe_sdk import Choice, Noul, Score, TypeSafeClient
    
    with TypeSafeClient() as client:
        response = client.system_one(
            state={"document": "I was charged twice. Please fix this ASAP."},
            questions={
                "billing": Noul(instructions="Is this ticket about billing?"),
                "tone": Choice(
                    instructions="What is the customer's tone?",
                    criteria={"calm": None, "frustrated": None, "angry": None},
                ),
                "urgency": Score(
                    instructions="How urgent is this ticket?",
                    criteria=["can wait", "this week", "today"],
                ),
            },
        )
    
    print(response.nouls["billing"].noul)
    print(response.choices["tone"].choice)
    print(response.scores["urgency"].score)
    

用法

在用法指南中了解更多。