core/engine/src/agents/analyst.py - main - alexefan136/flowstack

core/engine/src/agents/analyst.py
69 строк3 KB
Alexander Efanov
Обновление репозитория
15 июл 2026, 12:19
15 июл 2026, 12:1976704c6
# src/agents/analyst.py
"""Агент-аналитик для анализа данных и выявления паттернов.

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

Примеры использования:

    # Аналитик с дефолтными параметрами
    agent = AnalystAgent()
    result = await agent.run({"topic": "Продажи за Q3 2024"})

    # Аналитик с кастомным именем
    agent = AnalystAgent(name="Financial Analyst")

    # Аналитик с кастомным system prompt
    agent = AnalystAgent(
        name="Market Analyst",
        system_prompt="Ты — эксперт по анализу рынков..."
    )
"""
from __future__ import annotations

from .base import LLMAgent


class AnalystAgent(LLMAgent):
    """Агент для анализа данных и выявления инсайтов.
    
    Специализируется на:
    - Глубоком анализе предоставленных данных
    - Выявлении паттернов, трендов и аномалий
    - Формировании выводов на основе доказательств
    - Предоставлении практических рекомендаций
    
    Отличается от других агентов акцентом на количественное
    обоснование и структурированную подачу результатов.
    """

    DEFAULT_SYSTEM_PROMPT = """You are a data analyst. Your task is to:
1. Analyze the provided data thoroughly
2. Identify key patterns, trends, and anomalies
3. Draw meaningful conclusions from the data
4. Provide actionable insights and recommendations
5. Support your analysis with specific evidence from the data

Be objective and data-driven. Use quantitative reasoning where possible.
Present your findings in a clear, structured format."""

    def __init__(
        self,
        name: str = "Analyst",
        system_prompt: str | None = None,
    ):
        """Инициализация агента-аналитика.
        
        Args:
            name: Имя агента (по умолчанию "Analyst")
            system_prompt: Кастомный system prompt.
                Если None, используется DEFAULT_SYSTEM_PROMPT.
        """
        super().__init__(
            name=name,
            system_prompt=system_prompt or self.DEFAULT_SYSTEM_PROMPT,
        )


__all__ = ["AnalystAgent"]