Сборка инструментов
Инструменты в GigaAgent появляются из нескольких источников: базовый агент, активные модули, провайдеры выполнения, изолированные среды и MCP-инструменты из состояния диалога.
Определение инструмента
Чаще всего инструмент — это функция с декоратором @tool из langchain_core.tools. Но одного декоратора недостаточно: функция должна попасть в список инструментов, который собирает агент.
Типичный модуль:
class MyModule(BaseModule):
id = "my_module"
label = "My module"
async def _get_tools(self, user, agent, *, config=None, **kwargs):
return [my_tool]
Сборка списка инструментов
BaseAgent.get_tools()собирает базовые инструменты и инструменты модулей.- Обёртка модуля помечает пользовательские инструменты через
module_id. graph_factory.pyдобавляет служебные инструменты, напримерthinkиmulti_tool_use, если они доступны.- Провайдеры выполнения могут добавить свои инструменты.
- MCP-инструменты из состояния диалога преобразуются и добавляются отдельно.
- Итоговый список передаётся выбранной языковой модели.
Условная доступность
Документация должна описывать условия, а не обещать постоянную доступность.
Примеры:
get_documentsтребует настройки RAG и векторных представлений;- генерация изображений требует провайдера изображений;
analyze_imageтребует модель с поддержкой изображений;python,shell,await_shellзависят от изолированной среды;- GitHub, VK, погода и субагенты зависят от соответствующих секретов;
- MCP-инструменты доступны только если интерфейс передал их в состояние диалога.
Отключённые модули
BaseAgent читает отключённые модули из:
config.configurable.disabled_modules;user.settings.disabledModules.
Служебные модули без label не помечают свои инструменты как отключаемые пользователем.