Obsah

AgentMail

Vytvořeno: 16.5.2026 | Aktualizováno: 16.05.2026 08:16

AgentMail je API-first e-mailová platforma pro AI agenty. Cílem není přidat AI do existujícího e-mailového klienta, ale dát agentům vlastní e-mailové schránky, přes které mohou posílat, přijímat, číst a zpracovávat e-maily programově.

Proč je to zajímavé

AgentMail řeší praktický problém agentních workflow: mnoho reálných služeb stále komunikuje přes e-mail. Agent tak často potřebuje vlastní adresu, umět přijmout potvrzovací kód, přečíst odpověď, pracovat s vláknem nebo odeslat navazující zprávu.

Z webu a dokumentace jsou zajímavé hlavně tyto body:

Quickstart

Quickstart dokumentace popisuje dva režimy: použití přes konzoli pro vývojáře a programatický sign-up pro agenta. Agentí sign-up je zajímavý tím, že první registrace může proběhnout bez dashboardu: agent pošle lidský e-mail a username, dostane API key, inbox ID a organization ID, a člověku přijde OTP kód.

Zjednodušený příklad registrace agenta přes cURL: 

curl -X POST https://api.agentmail.to/agent/sign-up \
  -H "Content-Type: application/json" \
  -d '{
    "human_email": "you@example.com",
    "username": "my-agent"
  }'

Ověření OTP: 

export AGENTMAIL_API_KEY="am_..."
 
curl -X POST https://api.agentmail.to/agent/verify \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "otp_code": "123456" }'

Vytvoření inboxu

Podle API reference pro vytvoření inboxu se schránka vytváří přes endpoint POST /v0/inboxes. Parametry username a domain jsou volitelné; pokud domain není uvedená, používá se výchozí doména agentmail.to. Pro opakovatelné agenty je důležitý parametr client_id, protože umožňuje bezpečné retry bez vytvoření duplicitní schránky. 

curl -X POST https://api.agentmail.to/v0/inboxes \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "support-agent",
    "domain": "agentmail.to",
    "client_id": "support-agent-inbox-v1"
  }'

Stejný princip je v SDK: 

from agentmail import AgentMail
 
client = AgentMail(api_key="am_...")
inbox = client.inboxes.create(client_id="support-agent-inbox-v1")

Příjem a zpracování e-mailů

AgentMail nabízí několik způsobů, jak dostat příchozí e-mail do agenta:

U webhooků je potřeba počítat s běžnými produkčními pravidly: rychle vrátit 200 OK, zpracování dělat na pozadí, logovat neúspěšné doručení a ověřovat podpis webhooků. AgentMail v dokumentaci uvádí podpisy přes Svix. U agentů je zároveň nutné filtrovat vlastní odchozí zprávy, jinak může vzniknout smyčka, kdy agent odpovídá sám sobě.

Pro práci s odpověďmi je zajímavé, že zprávy mohou obsahovat pole extracted_text a extracted_html. Ta mají obsahovat novou část odpovědi bez citované historie vlákna, což je pro LLM agenty praktičtější než zpracovávat celý e-mailový thread.

Idempotence a bezpečné retry

Idempotentní požadavky jsou důležité hlavně u agentů, kteří mohou opakovat request po timeoutu nebo chybě sítě. AgentMail podporuje client_id u create operací, například při vytváření inboxů, webhooků, pods nebo draftů.

Důležité omezení: client_id se podle dokumentace používá pro vytváření resource, ne jako univerzální ochrana proti duplicitnímu odeslání e-mailu. U kritických zpráv je vhodnější vytvořit draft s deterministickým client_id, ověřit stav a teprve potom draft odeslat.

Vlastní domény a deliverability

Pro testování stačí výchozí doména agentmail.to. Pro produkci dává větší smysl vlastní doména nebo subdoména, protože sdílená doména má sdílenou reputaci. Pokud už firma používá Gmail, Outlook nebo jiného poskytovatele na hlavní doméně, dokumentace k MX record conflicts doporučuje použít samostatnou subdoménu, například agents.example.com.

Typický model:

Při plném příjmu e-mailů na root doméně by bylo nutné změnit MX záznamy tak, aby příchozí pošta šla do AgentMailu. To by ovlivnilo veškerý inbound mail pro danou doménu, takže je to vhodné jen ve specifických scénářích.

Ceny a limity

Pricing stránka v době rešerše uváděla tyto základní tarify:

Tarif Cena Inboxy E-maily za měsíc Úložiště Vlastní domény
Free $0 / měsíc 3 3 000 3 GB ne
Developer $20 / měsíc 10 10 000 10 GB 10
Startup $200 / měsíc 150 150 000 150 GB 150
Enterprise individuální vlastní vlastní vlastní vlastní

Pricing stránka také uvádí, že Free tarif nevyžaduje platební kartu. Ve srovnávací tabulce jsou jako dostupné funkce napříč tarify uvedené například threads, labels, attachments, drafts, schedule send, SDKs a MCP Server. Vyšší tarify přidávají více inboxů, domén, webhook endpointů, týmových členů a enterprise funkce.

Kdy to dává smysl

AgentMail vypadá nejzajímavěji pro situace, kde AI agent potřebuje samostatnou e-mailovou identitu a obousměrnou komunikaci:

Naopak pro jednoduché transactional e-maily typu „pošli notifikaci z aplikace“ může být zbytečně specializovaný. Hlavní hodnota je v tom, že agent dostane vlastní inbox, může držet kontext vláken a reagovat na příchozí komunikaci.

Poznámky k ověření

Tento zápis vychází z veřejného webu, pricing stránky a dokumentace. Nebyl proveden praktický test s reálným API klíčem, doménou ani doručitelností. Před produkčním nasazením je potřeba ověřit hlavně DNS nastavení, chování webhooků/WebSockets a reálnou deliverability na cílových doménách.

Zdroje