﻿---
title: "11. Stock Research Agent: данные и аналитический вывод"
description: LangChain-агент получает фундаментальные показатели через Yahoo Finance и формирует аналитический текст.
---

Агент соединяет инструмент с рыночными данными и модель, которая эти данные
интерпретирует. Пример того, как отделить факты от вывода — и как этого не сделать.

## Задача

По тикеру получить фундаментальные показатели и сформулировать аналитический
вывод. Граница: агент не даёт инвестиционных рекомендаций и не прогнозирует цену —
хотя текст может выглядеть как рекомендация.

## Архитектура

```mermaid
flowchart LR
  K["Тикер"] --> F["Yahoo Finance"]
  F -->|"котировки, мультипликаторы"| M["Модель"]
  M --> A["Аналитический текст"]
```

Один инструмент, один вызов модели для интерпретации. Состояния нет.

## Поток

1. Тикер передаётся аргументом.
2. Инструмент забирает данные: цена, капитализация, мультипликаторы, диапазон.
3. Модель получает числа и пишет разбор.

## Чему учит

- **Числа приходят из инструмента, а не из модели.** Это базовое правило домена.
- **Один инструмент может закрыть задачу.** Агентная конструкция здесь минимальна.
- **Бесплатный источник без ключа** снижает барьер входа и повышает
  воспроизводимость.

## Где сломается

- **Данные устаревают.** Котировка с задержкой, а текст звучит как актуальный.
- **Нет времени снимка.** Непонятно, на какой момент верны числа.
- **Нет допущений.** Вывод без списка допущений невозможно проверить.
- **Уверенный тон.** Формулировки вида «компания недооценена» — это инвестиционное
  суждение, а не факт.
- **Нет раскрытия.** Читатель не знает, что текст сгенерирован.

## Как улучшить

- Печатать время снимка и источник рядом с числами.
- Явно перечислять допущения.
- Добавить дисклеймер: информационный материал, не рекомендация.
- Сравнивать показатели с сектором, а не только с историей тикера.

## Связь с другими разделами

- [Финансы](https://wpcraft.ru/aia/use-cases/finance.md) — режимы риска и требования.
- [Структурированный вывод](https://wpcraft.ru/aia/patterns/structured-output.md) — как отделить числа
  от текста.
- [Наблюдаемость](https://wpcraft.ru/aia/production/observability.md) — фиксация источника и времени.

## Материалы и источники

- [yfinance](https://github.com/ranaroussi/yfinance) — библиотека доступа к Yahoo Finance.