vk_chat_bot/ai/tool.py
Kirill Kirilenko 4b265b5405 Устранено дублирование кода в AiAgent.
Добавлена возможность пересылки сообщений в личных чатах.
Обновлены зависимости.
Добавлен requirements.txt.
Исправлены предупреждения PyCharm 2026.1.
2026-04-07 01:01:34 +03:00

66 lines
2.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

from abc import ABC, abstractmethod
from dataclasses import dataclass
from typing import Any, Dict, List, Optional
from openrouter.components import ChatToolMessageContentTypedDict, ChatFunctionToolFunctionTypedDict
class Tool(ABC):
"""Интерфейс функции"""
@property
@abstractmethod
def name(self) -> str:
"""Имя функции (snake_case)"""
pass
@property
@abstractmethod
def description(self) -> str:
"""Текстовое описание функции"""
pass
@property
@abstractmethod
def parameters(self) -> Dict[str, Any]:
"""Описание параметров функции"""
pass
def to_dict(self) -> ChatFunctionToolFunctionTypedDict:
"""JSON-представление инструмента для OpenRouter"""
return {
"type": "function",
"function": {
"name": self.name,
"description": self.description,
"parameters": self.parameters
}
}
@abstractmethod
async def execute(self, args: Dict[str, Any], artifacts: Dict[str, Any]) -> List[ChatToolMessageContentTypedDict]:
"""Вызов функции.
:param args: Параметры из JSON
:param artifacts: Словарь для хранения артефактов
:return: Содержимое JSON-ответа на вызов функции
"""
pass
@dataclass
class ToolSet:
"""Набор логически объединенных функций"""
functions: List[Tool]
"""Список функций, входящих в набор"""
system_prompt: str
"""Дополнение к системному запросу, описывающее, как пользоваться функциями"""
def get_function_by_name(self, name: str) -> Optional[Tool]:
"""Поиск инструмента по имени"""
return next((t for t in self.functions if t.name == name), None)
def get_all_tools_description(self) -> List[ChatFunctionToolFunctionTypedDict]:
"""Получить JSON-описание всех инструментов"""
return [tool.to_dict() for tool in self.functions]