Type Safe
返回集成目录
社区示例需要复核可用2026-09-28

Pydantic AI Gateway 与 Jev

在同一套 Python 应用中，把 Pydantic AI Gateway 用于其支持的生成式提供商，并通过 Pydantic AI 原生 TypeSafe 模型支持单独使用 Jev。

安装

pip install "pydantic-ai-slim[openai,typesafe]"

服务端环境变量

PYDANTIC_AI_GATEWAY_API_KEY, TYPESAFE_API_KEY

准备事项

  • Python 3.10 或更高版本
  • 用于受支持网关提供商的 Pydantic AI Gateway 凭证
  • 用于独立 Jev 模型路径的服务端 TypeSafe API Key
  • 有文档说明的人工复核降级流程

接入步骤

  1. 1安装 Pydantic AI slim 包，同时安装 OpenAI 与 TypeSafe 可选依赖。
  2. 2在服务端环境中设置网关和 TypeSafe 凭证。
  3. 3仅为网关文档当前列出的提供商配置网关 Agent。
  4. 4为 Jev 单独创建 TypeSafeModel 提供商路径。
  5. 5执行操作前校验结构化决策字段和置信度。
  6. 6将不确定或低置信度决策交给人工复核。
服务端示例
from pydantic_ai import Agent
from pydantic_ai.models.typesafe import TypeSafeModel

gateway_agent = Agent("gateway/openai:gpt-5")
jev_model = TypeSafeModel("jev-1.13.0")

# These are separate provider paths in one application architecture.
# Current Pydantic AI Gateway docs do not list TypeSafe as a gateway upstream.

生产检查

  • 两条提供商路径的凭证都只保存在服务端。
  • 除非网关文档更新，否则不要把 TypeSafe 描述为网关上游。
  • 分别为两条提供商路径设置并核实超时和有限重试。
  • 固定依赖版本，上线前在本地评估完整工作流。
  • 不要记录敏感输入、凭证或完整决策数据。

限制与核实说明

当前 Pydantic AI Gateway 文档列出的提供商包括 OpenAI、Anthropic、Google Cloud、Groq 和 AWS Bedrock。TypeSafe 目前未列为网关上游，因此本页展示两条独立的提供商路径，不通过网关路由 Jev。

来源

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