Refactoring post PRs (#61)
* - File configs.yaml.example impostato con modelli ollama piccoli di default (come in fasi iniziali progetto). Eliminati altri provider con chiavi a pagamento. Eliminato GPT-OSS poiché modello problematico e incompatibile con metodi standard ollama. Gemini 2.5 sembra funzionare ma è sempre intasato e non ne abbiamo assoluta conferma. - Eliminati documenti inutili e datati * doc esame reintrodotto * configs.yaml.example riaggiunto dati completi * fix * Add ReasoningTools for enhanced decision-making and analysis processes --------- Co-authored-by: Berack96 <giacomobertolazzi7@gmail.com>
This commit was merged in pull request #61.
This commit is contained in:
Simo
@@ -1,113 +0,0 @@
|
||||
# Stato Attuale: Architettura e Flussi (upo-appAI)
|
||||
|
||||
Sintesi dell’architettura attuale e del flusso runtime dell’app, con diagrammi compatti e riferimenti ai componenti principali.
|
||||
|
||||
## Panorama Componenti
|
||||
|
||||
- `src/app/__main__.py`: Entrypoint. Avvia interfaccia Gradio (`ChatManager`) e bot Telegram (`TelegramApp`).
|
||||
- `interface/chat.py`: UI Gradio. Gestisce storico chat, chiama `Pipeline.interact()`.
|
||||
- `interface/telegram_app.py`: Bot Telegram. Gestisce conversazione, configura modelli/strategia, esegue `Pipeline.interact_async()` e genera PDF.
|
||||
- `agents/core.py`: Definisce `PipelineInputs`, agenti (`Team`, `Query Check`, `Report Generator`) e strumenti (Market/News/Social).
|
||||
- `agents/pipeline.py`: Orchestrazione via `agno.workflow`. Steps: Query Check → Gate → Info Recovery (Team) → Report Generation.
|
||||
- `agents/prompts/…`: Istruzioni per Team Leader, Market/News/Social agents, Query Check e Report Generation.
|
||||
- `api/tools/*.py`: Toolkits aggregati (MarketAPIsTool, NewsAPIsTool, SocialAPIsTool) basati su `WrapperHandler`.
|
||||
- `api/*`: Wrappers per provider esterni (Binance, Coinbase, CryptoCompare, YFinance, NewsAPI, GoogleNews, CryptoPanic, Reddit, X, 4chan).
|
||||
- `api/wrapper_handler.py`: Fallback con retry e try_all sui wrappers.
|
||||
- `configs.py`: Config app, modelli, strategie, API e caricamento da `configs.yaml`/env.
|
||||
|
||||
## Architettura (Overview)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
U[User] --> I{Interfacce}
|
||||
I -->|Gradio| CM[ChatManager]
|
||||
I -->|Telegram| TG[TelegramApp]
|
||||
CM --> PL[Pipeline]
|
||||
TG --> PL
|
||||
PL --> WF[Workflow\nQuery Check → Gate → Info Recovery → Report Generation]
|
||||
WF --> TM[Team Leader + Members]
|
||||
TM --> T[Tools\nMarket or News or Social]
|
||||
T --> W[Wrappers]
|
||||
W --> EX[External APIs]
|
||||
WF --> OUT[Report]
|
||||
TG --> PDF[MarkdownPdf\ninvio documento]
|
||||
CM --> OUT
|
||||
```
|
||||
|
||||
## Sequenza (Telegram)
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant U as User
|
||||
participant TG as TelegramBot
|
||||
participant PL as Pipeline
|
||||
participant WF as Workflow
|
||||
participant TL as TeamLeader
|
||||
participant MK as MarketTool
|
||||
participant NW as NewsTool
|
||||
participant SC as SocialTool
|
||||
participant API as External APIs
|
||||
|
||||
U->>TG: /start + messaggio
|
||||
TG->>PL: PipelineInputs(query, modelli, strategia)
|
||||
PL->>WF: build_workflow()
|
||||
WF->>WF: Step: Query Check
|
||||
alt is_crypto == true
|
||||
WF->>TL: Step: Info Recovery
|
||||
TL->>MK: get_products / get_historical_prices
|
||||
MK->>API: Binance/Coinbase/CryptoCompare/YFinance
|
||||
TL->>NW: get_latest_news / get_top_headlines
|
||||
NW->>API: NewsAPI/GoogleNews/CryptoPanic/DuckDuckGo
|
||||
TL->>SC: get_top_crypto_posts
|
||||
SC->>API: Reddit/X/4chan
|
||||
WF->>TL: Step: Report Generation
|
||||
else
|
||||
WF-->>PL: Stop workflow (non-crypto)
|
||||
end
|
||||
PL-->>TG: Report (Markdown)
|
||||
TG->>TG: Genera PDF e invia
|
||||
```
|
||||
|
||||
## Workflow & Agenti
|
||||
|
||||
- Step 1: `Query Check` (Agent) — valida la natura crypto della richiesta, output schema `QueryOutputs` (`response`, `is_crypto`).
|
||||
- Step 2: Gate — interrompe se `is_crypto == false`.
|
||||
- Step 3: `Info Recovery` (Team) — TeamLeader orchestration con `PlanMemoryTool` e Reasoning, dispatch agli agenti Market/News/Social.
|
||||
- Step 4: `Report Generation` (Agent) — sintetizza i risultati nel report finale (stringa Markdown).
|
||||
|
||||
## Tools & Wrappers
|
||||
|
||||
- MarketAPIsTool → `BinanceWrapper`, `YFinanceWrapper`, `CoinBaseWrapper`, `CryptoCompareWrapper`.
|
||||
- NewsAPIsTool → `GoogleNewsWrapper`, `DuckDuckGoWrapper`, `NewsApiWrapper`, `CryptoPanicWrapper`.
|
||||
- SocialAPIsTool → `RedditWrapper`, `XWrapper`, `ChanWrapper`.
|
||||
- `WrapperHandler`:
|
||||
- `try_call` con retry per wrapper corrente, fallback sequenziale.
|
||||
- `try_call_all` per aggregare risultati multipli.
|
||||
- Configurabile via `set_retries(attempts, delay_seconds)`.
|
||||
|
||||
## Configurazione & Modelli
|
||||
|
||||
- Modelli (default): `gemini-2.0-flash` per Team, Team Leader, Query Analyzer, Report Generator.
|
||||
- Strategie: es. `Conservative` (descrizione testuale). Selezionabili da UI.
|
||||
- `configs.yaml` e variabili env determinano modelli, porta server (`AppConfig.port`) e opzioni sharing Gradio.
|
||||
|
||||
## Variabili d’Ambiente (usate dai wrappers)
|
||||
|
||||
- `TELEGRAM_BOT_TOKEN` — Bot Telegram.
|
||||
- `COINBASE_API_KEY`, `COINBASE_API_SECRET` — Coinbase Advanced Trade.
|
||||
- `CRYPTOCOMPARE_API_KEY` — CryptoCompare.
|
||||
- `NEWS_API_KEY` — NewsAPI.
|
||||
- `CRYPTOPANIC_API_KEY` (+ opzionale `CRYPTOPANIC_API_PLAN`) — CryptoPanic.
|
||||
- `REDDIT_API_CLIENT_ID`, `REDDIT_API_CLIENT_SECRET` — Reddit (PRAW).
|
||||
- `X_API_KEY` — rettiwt API key (CLI richiesto).
|
||||
|
||||
## Note di Implementazione
|
||||
|
||||
- I wrappers sono prevalentemente sincroni; la Pipeline usa esecuzione asincrona per il workflow (`interact_async`), con stream di eventi dai `agno.workflow` steps.
|
||||
- Il Team Leader segue prompt comportamentale: ciclo di pianificazione/esecuzione/aggiornamento task con `PlanMemoryTool`.
|
||||
- L’output Telegram allega un PDF generato da `markdown_pdf`. La UI Gradio restituisce testo formattato.
|
||||
|
||||
## Test & Copertura (repo)
|
||||
|
||||
- Test unitari/integrati in `tests/` per wrappers (Market/News/Social), tools e handler.
|
||||
- Esecuzione consigliata: `pytest -q` con variabili d’ambiente correttamente impostate (alcuni test richiedono API keys).
|
||||
@@ -1,51 +0,0 @@
|
||||
# Report Obsolescenza Documenti (docs/)
|
||||
|
||||
Valutazione dei documenti esistenti rispetto allo stato attuale del codice.
|
||||
|
||||
## Valutazione Documenti
|
||||
|
||||
- `App_Architecture_Diagrams.md`
|
||||
- Stato: parzialmente aggiornato.
|
||||
- Criticità: contiene sezioni su "Signers Architecture" (src/app/signers/…) che non esistono nel repo attuale; riferimenti a auto-detection provider non presenti esplicitamente nei wrappers (l’attuale gestione usa `WrapperHandler` e assert su env). Alcuni numeri/esempi sono illustrativi.
|
||||
- Azioni: mantenere i diagrammi generali; rimuovere/aggiornare la sezione Signers; allineare provider e flusso al workflow `Query Check → Info Recovery → Report Generation`.
|
||||
|
||||
- `Async_Implementation_Detail.md`
|
||||
- Stato: aspirazionale/roadmap tecnica.
|
||||
- Criticità: la Pipeline è già asincrona per il workflow (`interact_async`), ma i singoli wrappers sono sincroni; il documento descrive dettagli di async su MarketAgent che non esiste come classe separata, e prevede parallelizzazione sui provider non implementata nei wrappers.
|
||||
- Azioni: mantenere come proposta di miglioramento; etichettare come "future work"; evitare di confondere con stato attuale.
|
||||
|
||||
- `Market_Data_Implementation_Plan.md`
|
||||
- Stato: piano di lavoro (utile).
|
||||
- Criticità: parla di Binance mock/signers; nel codice attuale esiste `BinanceWrapper` reale (autenticato) e non ci sono signers; la sezione aggregazione JSON è coerente come obiettivo ma non implementata nativamente dai tools (aggregazione base è gestita da `WrapperHandler.try_call_all`).
|
||||
- Azioni: aggiornare riferimenti a `BinanceWrapper` reale; chiarire che l’aggregazione avanzata è un obiettivo; mantenere come guida.
|
||||
|
||||
- `Piano di Sviluppo.md`
|
||||
- Stato: generico e parzialmente disallineato.
|
||||
- Criticità: fa riferimento a stack (LangChain/LlamaIndex) non presente; ruoli degli agenti con naming differente; database/persistenza non esiste nel codice.
|
||||
- Azioni: etichettare come documento legacy; mantenerlo solo se serve come ispirazione; altrimenti spostarlo in `docs/legacy/`.
|
||||
|
||||
- `Progetto Esame.md`
|
||||
- Stato: descrizione obiettivo.
|
||||
- Criticità: allineata come visione; non problematica.
|
||||
- Azioni: mantenere.
|
||||
|
||||
## Raccomandazioni
|
||||
|
||||
- Aggiornare `App_Architecture_Diagrams.md` rimuovendo la sezione "Signers Architecture" e allineando i diagrammi al workflow reale (`agents/pipeline.py`).
|
||||
- Aggiungere `Current_Architecture.md` (presente) come riferimento principale per lo stato attuale.
|
||||
- Spostare `Piano di Sviluppo.md` in `docs/legacy/` o eliminarlo se non utile.
|
||||
- Annotare `Async_Implementation_Detail.md` e `Market_Data_Implementation_Plan.md` come "proposals"/"future work".
|
||||
|
||||
## Elenco Documenti Obsoleti o Parzialmente Obsoleti
|
||||
|
||||
- Parzialmente Obsoleti:
|
||||
- `App_Architecture_Diagrams.md` (sezione Signers, parti di provider detection)
|
||||
- `Async_Implementation_Detail.md` (dettagli Async MarketAgent non implementati)
|
||||
- `Market_Data_Implementation_Plan.md` (Binance mock/signers)
|
||||
|
||||
- Legacy/Non allineato:
|
||||
- `Piano di Sviluppo.md` (stack e ruoli non corrispondenti al codice)
|
||||
|
||||
## Nota
|
||||
|
||||
Queste raccomandazioni non rimuovono immediatamente file: il mantenimento storico può essere utile. Se desideri, posso eseguire ora lo spostamento in `docs/legacy/` o la cancellazione mirata dei documenti non necessari.
|
||||
@@ -1,80 +0,0 @@
|
||||
# Diagrammi di Flusso e Sequenza (Sintesi)
|
||||
|
||||
Documentazione breve con blocchi testuali e mermaid per flussi principali.
|
||||
|
||||
## Flusso Gradio Chat
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
U[User] --> CH(ChatInterface)
|
||||
CH --> RESP[gradio_respond]
|
||||
RESP --> PL(Pipeline.interact)
|
||||
PL --> WF(Workflow run)
|
||||
WF --> OUT(Report)
|
||||
CH --> HIST[history update]
|
||||
```
|
||||
|
||||
## Flusso Telegram Bot
|
||||
|
||||
```
|
||||
/start
|
||||
│
|
||||
├─> CONFIGS state
|
||||
│ ├─ Model Team ↔ choose_team(index)
|
||||
│ ├─ Model Output ↔ choose_team_leader(index)
|
||||
│ └─ Strategy ↔ choose_strategy(index)
|
||||
│
|
||||
└─> Text message → __start_team
|
||||
└─ run team → Pipeline.interact_async
|
||||
├─ build_workflow
|
||||
├─ stream events (Query Check → Gate → Info Recovery → Report)
|
||||
└─ send PDF (markdown_pdf)
|
||||
```
|
||||
|
||||
## Pipeline Steps (Workflow)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[QueryInputs] --> B[Query Check Agent]
|
||||
B -->|is_crypto true| C[Team Info Recovery]
|
||||
B -->|is_crypto false| STOP((Stop))
|
||||
C --> D[Report Generation Agent]
|
||||
D --> OUT[Markdown Report]
|
||||
```
|
||||
|
||||
## Team Leader Loop (PlanMemoryTool)
|
||||
|
||||
```
|
||||
Initialize Plan with tasks
|
||||
Loop until no pending tasks:
|
||||
- Get next pending task
|
||||
- Dispatch to specific Agent (Market/News/Social)
|
||||
- Update task status (completed/failed)
|
||||
- If failed & scope comprehensive → add retry task
|
||||
After loop:
|
||||
- List all tasks & results
|
||||
- Synthesize final report
|
||||
```
|
||||
|
||||
## Tools Aggregazione
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
TL[Team Leader] --> MT[MarketAPIsTool]
|
||||
TL --> NT[NewsAPIsTool]
|
||||
TL --> ST[SocialAPIsTool]
|
||||
MT --> WH(WrapperHandler)
|
||||
NT --> WH
|
||||
ST --> WH
|
||||
WH --> W1[Binance]
|
||||
WH --> W2[Coinbase]
|
||||
WH --> W3[CryptoCompare]
|
||||
WH --> W4[YFinance]
|
||||
WH --> N1[NewsAPI]
|
||||
WH --> N2[GoogleNews]
|
||||
WH --> N3[CryptoPanic]
|
||||
WH --> N4[DuckDuckGo]
|
||||
WH --> S1[Reddit]
|
||||
WH --> S2[X]
|
||||
WH --> S3[4chan]
|
||||
```
|
||||
Reference in New Issue
Block a user