# Ricevi una notifica push quando l'agente termina.

> Ricevi una notifica push quando un agente AI o un'esecuzione LLM termina, richiede approvazione o fallisce. Pocket Alert offre un tool MCP create_message e una semplice HTTP POST verso il tuo telefono.

<!-- source: https://pocketalert.app/it/use-cases/ai-agent-alerts -->

Ultimo aggiornamento: 2026-08-11

Un agente LLM di lunga durata non dovrebbe richiedere che tu lo tenga d'occhio. Il telefono vibra quando il lavoro è finito, quando è bloccato in attesa di approvazione o quando si rompe, così puoi allontanarti con la certezza che ti raggiungerà.

## Tre passi per avvisi dagli agenti senza supervisione

1. **Scegli MCP o HTTP** — Crea una chiave API oppure aggiungi il server MCP di Pocket Alert al tuo client per la via senza codice.
2. **Invia al termine** — Chiama create_message, oppure invia una POST con titolo e messaggio da un callback LangChain o da un tool dell'agente.
3. **Allontanati** — Assegna a ogni agente la propria applicazione per errori e approvazioni. Ora puoi lasciare la scrivania mentre lavora.

## Pensato per agenti che lavorano senza supervisione

Due strade, stesso risultato: l'agente chiama uno strumento MCP o esegue una POST, e il tuo telefono vibra.

- **Server MCP integrato** — I client MCP come Claude Code, Claude Desktop e Cursor inviano una notifica push chiamando lo strumento create_message.
- **Fallback HTTP semplice** — Non hai un client MCP? Una singola richiesta POST autenticata all'API dei messaggi fa lo stesso lavoro da qualsiasi agente o script.
- **Pronto per gli hook Stop** — Invia l'avviso da un hook Stop, così parte quando l'agente termina e non quando ti ricordi di controllare.
- **Stato nel messaggio** — Inserisci lo stato dell'agente e il testo del risultato direttamente nel messaggio, così "approvazione necessaria" si legge chiaramente.
- **Canali dedicati per agente** — Un'applicazione separata per ogni agente o progetto tiene il bot di refactoring e il cron job su canali distinti.
- **Consegna in meno di un secondo** — Le notifiche arrivano in meno di un secondo, così sai subito quando un lavoro lungo termina o si blocca in attesa di input.

## Collega un agente al tuo telefono

### 1. Ottieni una chiave API

Crea una chiave nella pagina [Chiavi API](https://pocketalert.app/it/account/apikeys). L'agente la invia nell'header `Token`.

### 2. Invia una POST da un callback LangChain (Python)

```
import requests
from langchain.callbacks.base import BaseCallbackHandler

class PocketAlert(BaseCallbackHandler):
    def on_agent_finish(self, finish, **kwargs):
        requests.post(
            "https://api.pocketalert.app/v1/messages",
            headers={"Token": "YOUR_API_KEY"},
            json={"title": "Agent finished", "message": finish.return_values["output"][:200]},
        )

agent.invoke({"input": task}, config={"callbacks": [PocketAlert()]})
```

### 3. Oppure come tool OpenAI che l'agente chiama (Node)

```
async function notifyHuman({ title, message }) {
  await fetch("https://api.pocketalert.app/v1/messages", {
    method: "POST",
    headers: { Token: "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ title, message, level: "high" }),
  });
}
```

Esponi `notifyHuman` come funzione/tool, così l'agente la chiama quando richiede un'approvazione o si verifica un errore.

### 4. Oppure niente codice con MCP

Se il tuo client supporta MCP (Claude Code, Claude Desktop, Cursor), aggiungi il server MCP di Pocket Alert e lascia che l'agente chiami lo strumento `create_message`. Nessun codice da parte tua.

La [documentazione](https://info.pocketalert.app/getting-started.html) copre targeting, applicazioni e gli altri strumenti MCP.

## FAQ

### Come invia un agente una notifica push?

In due modi. I client MCP come Claude Code, Claude Desktop o Cursor chiamano lo strumento create_message e la notifica push arriva sul telefono. Qualsiasi altro sistema esegue una singola richiesta HTTP POST all'API dei messaggi. Un hook Stop a fine esecuzione è il trigger più comune.

### Cos'è il percorso MCP senza codice?

Aggiungi il server MCP di Pocket Alert al tuo client e chiama create_message con un titolo e un messaggio. Nessun codice, nessun curl. C'è anche create_message_with_attachment, se l'agente deve inviare un file o uno screenshot.

### Posso distinguere a colpo d'occhio gli errori dai completamenti?

Assegna a ogni agente la propria applicazione, così una richiesta di "approvazione necessaria" dal tuo bot di refactoring e un "attività completata" dalla pipeline notturna arrivano su canali separati. Formula il titolo in modo che una richiesta di approvazione o un errore siano chiari a colpo d'occhio.

### Come tengo separati gli agenti di un progetto?

Assegna a ogni agente o progetto la propria applicazione. Una notifica dal tuo bot di refactoring e una dalla pipeline dati notturna arrivano su canali separati, così sai quale processo ti ha scritto senza leggere il corpo del messaggio.

### È abbastanza veloce da valere la pena controllare il telefono?

La consegna avviene in meno di un secondo. Quando un agente di coding ha lavorato per quindici minuti e tu sei andato a prendere un caffè, la notifica ti raggiunge prima che tu torni a sederti.

### Come faccio a tenere silenziosi i completamenti e ben udibili gli errori?

Invia un livello con ogni messaggio. Un normale avviso "attività completata" può avere priorità silenziosa, senza suono né vibrazione ma comunque presente nella cronologia, mentre un errore o una richiesta di approvazione ha priorità alta e arriva come notifica push urgente che supera la Full immersion di iPhone. Lo strumento MCP create_message accetta lo stesso campo level, quindi l'agente sceglie il volume per ogni messaggio.
