Riferimento — Strumenti (tools)

Quando rispondi, dietro le quinte l’agente Dexter usa degli strumenti (tools) per recuperare dati reali ed eseguire azioni. Non devi invocarli a mano: li sceglie l’AI in base alla tua richiesta e alle istruzioni dei comandi. Qui trovi cosa fa ogni strumento, quando l’AI lo chiama, i parametri principali, cosa restituisce e i possibili errori.

Categorie

Dati di mercato

Prezzi, performance, profili e liste degli strumenti tracciati nel database locale (azioni, ETF, futures, forex, fondi, indici). Sono le chiamate più frequenti: veloci, lette dal DB, senza routing LLM.

get_stock_price, get_stock_prices, get_stock_prices_intraday, get_stock_performance, get_company_news, get_company_info, get_dividends, get_stock_splits, get_etf_profile, get_all_etfs, list_futures, get_future_profile, list_funds, get_fund_profile, list_forex_assets, list_indices

Fondamentali e SEC

Bilanci, indici fondamentali, utili, stime e fonti ufficiali SEC EDGAR (filing, XBRL storico, Form 4, 13F). La base per analisi e valutazioni.

get_income_statements, get_balance_sheets, get_cash_flow_statements, get_all_financial_statements, get_key_ratios, get_historical_key_ratios, get_earnings, get_analyst_estimates, get_sec_filings, get_sec_financials, get_sec_document, get_sec_form4, get_insider_trades, get_institutional_holdings

Indicatori tecnici

Indicatori di momentum e trend calcolati sui prezzi storici.

get_technical_indicators

Crypto

Dati di mercato, indicatori, profili e screening per le criptovalute tracciate.

get_crypto_market_data, get_crypto_snapshot, get_crypto_prices, get_crypto_prices_intraday, get_crypto_technical_indicators, get_crypto_metadata, list_cryptos, preset_crypto_screener, add_crypto

Macro

Contesto macroeconomico: indicatori FRED, tassi, materie prime, settori, sentiment e calendario.

get_macro_indicators, get_macro_history, get_treasury_yields, get_yield_curve, get_commodity_prices, get_sector_performance, get_market_sentiment, get_forex_rates, get_economic_calendar

Screening e ticker

Filtra i mercati per criteri o profilo di rischio, risolvi nomi in ticker e aggiungi nuovi strumenti al monitoraggio.

stock_screener, preset_screener, preset_etf_screener, list_database_tickers, get_available_stock_tickers, resolve_ticker, add_ticker, add_future, add_fund, add_forex

Avvisi e cron

Crea e gestisci allarmi di prezzo, leggi le notifiche scattate e pianifica job automatici. Richiedono un account collegato.

get_user_alerts, create_user_alert, update_user_alert, toggle_user_alert, delete_user_alert, get_user_notifications, cron

Portafoglio

Leggi e modifica il portafoglio dell’utente: posizioni, strategia, limiti di rischio e regole.

portfolio_get, portfolio_update

Ricerca web

Recupera informazioni dal web quando non sono nel database: ricerca, estrazione pagine, browser e X/Twitter.

web_search, web_fetch, browser, x_search

Elementi visivi resi nel terminale: pulsanti di dettaglio, barra del fair value e grafico annotato.

show_ticker_link, render_value_range, render_price_chart

Sistema e agente

Memoria persistente, sub-agenti, skill, file e checklist operativa dell’agente.

dispatch_agent, skill, memory_search, memory_get, memory_update, heartbeat, read_file, write_file, edit_file

Come leggere gli errori

Gli strumenti non “falliscono” come un programma classico: restituiscono un risultato che l’AI interpreta e gestisce. I casi ricorrenti:

Dati vuoti. Se un ticker non è tracciato o non ci sono dati nel periodo, la risposta è vuota (nessun errore). L’AI può aggiungere lo strumento con add_ticker / add_crypto / add_future / add_fund / add_forex e riprovare.
Stati di sincronizzazione. Gli add_* rispondono con sync_complete, sync_in_progress, sync_error o already_tracked: indicano se i dati sono pronti, in arrivo o se qualcosa è andato storto.
Account non collegato. Gli strumenti su alert, notifiche e portafoglio richiedono un account Telegram collegato: senza, rispondono No user session… / requires a linked account.
Avvisi sui dati (data_warning). I dati SEC XBRL storici possono essere vecchi se la società ha cambiato la codifica XBRL: l’AI te lo segnala.
Profilo sconosciuto. Gli screener per profilo accettano solo low, mid o high (Unknown profile).