# Dapatkan push notification saat agen selesai.

> Dapatkan push notification saat agen AI atau proses LLM selesai, butuh persetujuan, atau gagal. Pocket Alert menyediakan tool MCP create_message dan HTTP POST biasa ke HP Anda.

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

Terakhir diperbarui: 2026-08-11

Agen LLM yang berjalan lama seharusnya tidak membuat Anda terus mengawasinya. Ponsel Anda bergetar saat tugas selesai, macet menunggu persetujuan, atau rusak, sehingga Anda bisa pergi dan tetap yakin agen akan menghubungi Anda.

## Tiga langkah menuju notifikasi agen tanpa tangan

1. **Pilih MCP atau HTTP** — Buat kunci API, atau tambahkan server MCP Pocket Alert ke klien Anda untuk jalur tanpa kode.
2. **Kirim saat selesai** — Panggil create_message, atau POST title dan message dari callback LangChain atau tool agen.
3. **Tinggalkan mejamu** — Berikan setiap agen aplikasinya sendiri untuk kegagalan dan persetujuan. Sekarang Anda bisa meninggalkan meja selagi agen bekerja.

## Dibuat untuk agen yang berjalan tanpa pengawasan

Dua jalur, hasil yang sama: agen memanggil tool MCP atau melakukan POST sekali, dan ponsel Anda bergetar.

- **Server MCP bawaan** — Klien MCP seperti Claude Code, Claude Desktop, dan Cursor mengirim notifikasi dengan memanggil tool create_message.
- **Cadangan HTTP biasa** — Tidak punya klien MCP? Satu POST terautentikasi ke API messages melakukan hal yang sama dari agen atau skrip mana pun.
- **Siap untuk Stop hook** — Picu notifikasi dari Stop hook sehingga berjalan saat agen selesai, bukan saat Anda ingat untuk mengecek.
- **Status di dalam pesan** — Kirim status agen dan teks hasil langsung di dalam pesan, sehingga "butuh persetujuan" langsung terbaca jelas.
- **Saluran per agen** — Aplikasi terpisah untuk setiap agen atau proyek menjaga bot refactor dan cron job tetap di saluran masing-masing.
- **Pengiriman di bawah satu detik** — Push notification tiba di bawah satu detik, sehingga Anda langsung tahu saat tugas panjang selesai atau macet menunggu input.

## Hubungkan agen ke ponsel Anda

### 1. Dapatkan kunci API

Buat kunci di halaman [API Keys](https://pocketalert.app/id/account/apikeys). Agen mengirimkannya di header `Token`.

### 2. POST dari 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. Atau sebagai tool OpenAI yang dipanggil agen (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" }),
  });
}
```

Jadikan `notifyHuman` sebagai function/tool agar agen memanggilnya saat butuh persetujuan atau mengalami error.

### 4. Atau lewati kode dengan MCP

Jika klien Anda mendukung MCP (Claude Code, Claude Desktop, Cursor), tambahkan server MCP Pocket Alert dan biarkan agen memanggil tool `create_message`. Tanpa kode di sisi Anda.

Panduan di [docs](https://info.pocketalert.app/getting-started.html) membahas penargetan, aplikasi, dan tool MCP lainnya.

## FAQ

### Bagaimana agen mengirim push notification ke saya?

Ada dua cara. Klien MCP seperti Claude Code, Claude Desktop, atau Cursor memanggil tool create_message dan push notification langsung masuk ke ponsel Anda. Selain itu, cukup satu HTTP POST ke API messages. Stop hook di akhir proses adalah pemicu yang paling umum.

### Apa itu jalur MCP tanpa kode?

Tambahkan server MCP Pocket Alert ke klien Anda lalu panggil create_message dengan title dan message. Tanpa kode, tanpa curl. Ada juga create_message_with_attachment jika agen perlu mengirim file atau tangkapan layar.

### Bisakah saya membedakan kegagalan dari penyelesaian sekilas saja?

Berikan setiap agen aplikasinya sendiri agar permintaan "butuh persetujuan" dari bot refactor dan notifikasi "tugas selesai" dari pipeline malam hari masuk ke saluran terpisah. Tulis title agar permintaan persetujuan atau kegagalan langsung terbaca sekilas.

### Bagaimana cara memisahkan agen dari satu proyek yang sama?

Berikan setiap agen atau proyek aplikasinya sendiri. Push notification dari bot refactor dan dari pipeline data malam hari masuk ke saluran terpisah, jadi Anda tahu tugas mana yang berbicara tanpa harus membaca isinya.

### Apakah cukup cepat untuk layak dicek di ponsel?

Pengiriman berlangsung di bawah satu detik. Saat agen pengodean sudah bekerja selama lima belas menit dan Anda sedang membuat kopi, push notification sampai ke Anda sebelum Anda kembali duduk.

### Bagaimana cara menjaga notifikasi penyelesaian tetap senyap tetapi kegagalan tetap terdengar?

Kirim level bersama setiap pesan. Notifikasi "tugas selesai" rutin bisa dikirim dengan level silent, tanpa suara atau getar tetapi tetap tersimpan di riwayat, sedangkan kegagalan atau permintaan persetujuan dikirim dengan level high dan tiba sebagai push notification sensitif waktu yang menembus Fokus iPhone. Tool create_message MCP menerima field level yang sama, sehingga agen dapat memilih volume untuk setiap pesan.
