AutoGen — фреймворк Microsoft для мультиагентных систем: агенты обмениваются сообщениями, вызывают инструменты и работают командой. Модели он вызывает через клиент OpenAI Chat Completions, поэтому Heli подключается заменой base_url и ключа. Ключ sk-heli- создаётся во вкладке «Ключи» после регистрации на getheli.ru.
Установка и клиент модели
Пример для актуальной ветки AutoGen 0.4+ (пакеты autogen-agentchat и autogen-ext). Для моделей с именем не из списка OpenAI AutoGen требует параметр model_info — описание возможностей модели. Без него клиент выдаст ошибку о неизвестной модели, а при неполном model_info — ошибку про поле family.
pip install -U "autogen-agentchat" "autogen-ext[openai]"
import asyncio, os
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
client = OpenAIChatCompletionClient(
model="openai/gpt-5.4-mini",
base_url="https://getheli.ru/v1",
api_key=os.environ["HELI_API_KEY"],
model_info={
"vision": False,
"function_calling": True,
"json_output": True,
"family": "unknown",
"structured_output": True,
},
)
agent = AssistantAgent("assistant", model_client=client,
system_message="Отвечай по-русски, кратко.")
async def main():
result = await agent.run(task="Объясни, что такое RAG, в трёх предложениях.")
print(result.messages[-1].content)
await client.close()
asyncio.run(main())Что указать в model_info
- function_calling: True — если агенту нужны инструменты; выбирайте модель с поддержкой tool calling.
- json_output и structured_output — включайте только для моделей, которые поддерживают JSON-ответ и схемы.
- vision: True — только если модель принимает изображения и вы их передаёте.
- family: "unknown" подходит для моделей, которых AutoGen не знает по имени.
Команды агентов
Для нескольких агентов используйте команды из autogen_agentchat.teams, например RoundRobinGroupChat, и условия остановки TextMentionTermination или MaxMessageTermination. Каждый агент может получить свой клиент: планировщику — сильную модель, исполнителям — лёгкую. Обязательно ограничивайте число сообщений: без условия остановки команда может долго обмениваться репликами и расходовать баланс.
Claude Sonnet 5 — для планирования и сложных шагов.
GPT-5.4 mini — быстрые шаги с инструментами.
DeepSeek V4 Flash — недорогие черновые шаги.
Классический config_list и статус проекта
В AutoGen 0.2 и его форке AG2 модель задаётся списком config_list в llm_config: в элементе указываются model, api_key и base_url="https://getheli.ru/v1". Схема та же — меняются только адрес и ключ.
Microsoft перевела AutoGen в режим поддержки: проект получает исправления ошибок и безопасности, но не новые функции. Для новых проектов Microsoft рекомендует Microsoft Agent Framework. Существующие проекты на AutoGen продолжают работать с Heli без изменений.
Инструменты агента
В AgentChat инструментом может быть обычная Python-функция с аннотациями типов и docstring: передайте её в AssistantAgent через параметр tools, и AutoGen сам опишет её модели как функцию. Модель вернёт tool call, агент выполнит функцию и, если включён reflect_on_tool_use, попросит модель сформулировать ответ по результату. Проверяйте аргументы внутри функции: модель может передать неожиданные значения.
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.