QnA

Как лучше изучить фреймворк?

Вопрос: Насколько нормально, что сложно разобраться во всём репозитории? Что самое главное стоит изучить, чтобы понять, как изнутри всё работает?

Ответ: Это абсолютно нормально — в репозитории действительно много кода и абстракций, особенно когда дело касается кода библиотеки. Рекомендуемый порядок изучения:

1. Основы

• sgr_agent_core — ядро фреймворка, не очень много кода, но достаточно сложные вещи. Понять его — и всё остальное станет ясно
• base_agent, base_tool — достаточно простые и понятные классы

2. Модели и организация

• models — сложится картинка, как организован агент, контекст и работа с web источниками

3. Конкретные реализации

• agents/ и tools/ — конкретные реализации агентов и тулов

4. Обвязка и инфраструктура

• AgentDefinition и AgentConfig — в документации уже готово, для чего оно так сложно
• services/registry + agent_factory — окончательно сложится картинка, как всё работает

5. Оставшиеся темы

• mcp и stream — на финалочку

После этого можно изучить sgr_deep_research — там буквально API-шка к агентам фреймворка.

Итог: Поздравляю, вы как минимум на уровне контрибьютора