Avvisi e cron

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

get_user_alerts

Cosa fa. Elenca gli allarmi di prezzo esistenti per un ticker o per tutti. Restituisce gli ID necessari per modifica/eliminazione/attivazione.

Quando/come lo usa l’AI. Prima di modificare o eliminare un alert (servono gli ID).

Parametri. ticker opzionale.

Restituisce. Lista degli alert con ID.

Possibili errori / stati.

• No user session… / requires a linked account — elencare gli alert richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to list alerts (+ dettaglio).

create_user_alert

Cosa fa. Crea un allarme di prezzo per un’azione. Supporta condizioni prezzo sopra/sotto e movimento % giornaliero.

Quando/come lo usa l’AI. Quando vuoi essere avvisato a un livello di prezzo.

Parametri. ticker, condizione, soglia, label/nota.

Restituisce. Conferma dell’alert creato.

Possibili errori / stati.

• No user session… / requires a linked account — creare alert richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to create alert for … (+ dettaglio).

update_user_alert

Cosa fa. Aggiorna soglia, etichetta o nota di un alert esistente.

Quando/come lo usa l’AI. Per ritoccare un allarme senza ricrearlo.

Parametri. alert_id, campi da aggiornare.

Restituisce. Conferma dell’aggiornamento.

Possibili errori / stati.

• No user session… / requires a linked account — aggiornare alert richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to update alert #id (+ dettaglio).

toggle_user_alert

Cosa fa. Attiva o disattiva un alert senza eliminarlo.

Quando/come lo usa l’AI. Per sospendere temporaneamente un allarme.

Parametri. alert_id.

Restituisce. Nuovo stato dell’alert.

Possibili errori / stati.

• No user session… / requires a linked account — attivare/disattivare alert richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to toggle alert #id (+ dettaglio).

delete_user_alert

Cosa fa. Elimina definitivamente un alert tramite ID.

Quando/come lo usa l’AI. Per rimuovere un allarme che non serve più.

Parametri. alert_id.

Restituisce. Conferma dell’eliminazione.

Possibili errori / stati.

• No user session… / requires a linked account — eliminare alert richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to delete alert #id (+ dettaglio).

get_user_notifications

Cosa fa. Legge le notifiche degli alert scattati: ticker, condizione e messaggio.

Quando/come lo usa l’AI. Per rivedere cosa è scattato.

Parametri. Filtri opzionali.

Restituisce. Notifiche degli alert.

Possibili errori / stati.

• No user session… / requires a linked account — leggere le notifiche richiede un account Telegram collegato alla sessione; senza, il tool si rifiuta.
• Failed to read notifications (+ dettaglio).

cron

Cosa fa. Gestisce i job pianificati: creazione, elenco, aggiornamento, eliminazione.

Quando/come lo usa l’AI. Per automatizzare controlli e riepiloghi ricorrenti.

Parametri. Azione + parametri del job (schedulazione, prompt, modello).

Restituisce. Esito dell’operazione sul job.