Pydantic AI
Подключение Hubris к Pydantic AI — агентному фреймворку от авторов Pydantic с типизированными инструментами и структурированным выводом.
Pydantic AI — агентный фреймворк от команды Pydantic: типизированные инструменты, структурированный вывод через модели Pydantic, встроенная валидация ответов. Hubris подключается как OpenAI-совместимый провайдер: любая модель каталога работает через OpenAIChatModel.
Требования
Установка
pip install -U "pydantic-ai-slim[openai]"
export HUBRIS_API_KEY="sk-gw-ваш-ключ"Подключение
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider
model = OpenAIChatModel(
"anthropic/claude-sonnet-5",
provider=OpenAIProvider(
base_url="https://api.hubris.pw/v1",
api_key=os.environ["HUBRIS_API_KEY"],
),
)
agent = Agent(model)
result = agent.run_sync("Какая столица у Франции?")
print(result.output)ID модели — из каталога, целиком, с вендором перед косой чертой.
Инструменты и структурированный вывод
Работают штатно, потому что Hubris передаёт tools и response_format в формате OpenAI:
from pydantic import BaseModel
class City(BaseModel):
name: str
country: str
agent = Agent(model, output_type=City)
@agent.tool_plain
def population(city: str) -> int:
"""Население города."""
return 12_600_000 if city == "Москва" else 0
result = agent.run_sync("Самый большой город России?")
print(result.output)Какие параметры поддерживает конкретная модель, видно в поле supported_parameters ответа GET /v1/models.
Рекомендуемые модели
| ID | Когда подходит |
|---|---|
anthropic/claude-sonnet-5 | агенты с инструментами, сложные задачи |
openai/gpt-5.6-luna | структурированный вывод, быстрые ответы |
google/gemini-3.7-flash | длинный контекст, дешёвые агентные циклы |
Решение проблем
401 Unauthorized
Ключ не передан или отозван. Проверьте переменную HUBRIS_API_KEY; полный ключ виден только при создании в разделе «Ключи».
Модель не найдена
ID должен совпадать с каталогом символ в символ. Короткие имена без вендора Hubris не принимает.
Проверено на Pydantic AI 2.41.0, 9 сентября 2026.Что дальше
- Каталог моделей — ID для подключения
- Structured output — как устроен стабильный JSON-вывод в Hubris
- Расходы — детализация по запросам
Обновлено: