ai:platformy:agenti-a-orchestrace:agentmail

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

ai:platformy:agenti-a-orchestrace:agentmail [16.05.2026 08:16] – Vytvořen článek o AgentMailu Petr Nosekai:platformy:agenti-a-orchestrace:agentmail [02.06.2026 20:09] (aktuální) – Doplnění sekce o AgentMail webhooky Petr Nosek
Řádek 79: Řádek 79:
  
 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. 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.
 +
 +==== Webhooky ==== 
 +
 +Podle [[https://docs.agentmail.to/webhooks-overview|Webhooks Overview]] jsou webhooky hlavní mechanismus pro event-driven zpracování e-mailů v reálném čase. AgentMail tím nenahrazuje vlastní aplikační logiku ani „nespouští agenta“ přímo. Při události pošle HTTP ''POST'' na zaregistrovanou URL a teprve endpoint v aplikaci rozhodne, co se má stát dál.
 +
 +Typický tok pro příchozí e-mail:
 +
 +<code>
 +příchozí e-mail
 +  ↓
 +AgentMail vytvoří event message.received
 +  ↓
 +AgentMail pošle HTTP POST na webhook endpoint
 +  ↓
 +aplikace rychle vrátí 200 OK
 +  ↓
 +background job předá e-mail agentovi
 +  ↓
 +agent zprávu zpracuje, odpoví, označí nebo eskaluje
 +</code>
 +
 +Pro běžný příjem nových zpráv se používá event ''message.received''. Při vytvoření webhooku lze explicitně určit, které typy eventů má endpoint dostávat:
 +
 +<code python>
 +client.webhooks.create(
 +    url="https://example.com/webhooks/agentmail",
 +    event_types=["message.received", "message.sent"],
 +)
 +</code>
 +
 +Stejné nastavení přes CLI:
 +
 +<code bash>
 +agentmail webhooks create \
 +  --url https://example.com/webhooks/agentmail \
 +  --event-type message.received \
 +  --event-type message.sent
 +</code>
 +
 +Webhook endpoint musí být dostupný z internetu. Lokální adresa typu ''localhost'' pro produkční webhook nestačí, protože AgentMail se na ni ze svého serveru nedostane. Pro lokální vývoj je potřeba tunel typu ngrok nebo Cloudflare Tunnel. Pokud aplikace nemá mít veřejnou URL, dokumentace doporučuje místo webhooků použít WebSockets.
 +
 +Praktické poznámky:
 +
 +  * Endpoint by měl odpovědět rychle ''200 OK'' a vlastní zpracování přesunout do background jobu, aby webhook netimeoutoval.
 +  * Payload obsahuje ''event_type'', ''event_id'' a objekt podle typu události, u ''message.received'' tedy hlavně objekt ''message''.
 +  * ''event_id'' je vhodné ukládat kvůli idempotenci, aby se stejný webhook nezpracoval dvakrát.
 +  * Payload webhooku má limit 1 MB. Pokud je zpráva větší, AgentMail může vynechat pole ''text'' a ''html''; plný obsah je pak potřeba stáhnout přes API podle ''inbox_id'' a ''message_id''.
 +  * Přílohy jsou v payloadu jen jako metadata. Samotný obsah příloh se stahuje zvlášť přes API.
 +  * Spam, blocked a unauthenticated zprávy nejsou ve výchozím režimu posílané jako běžný ''message.received''. Pokud jsou potřeba, musí se explicitně přihlásit eventy ''message.received.spam'', ''message.received.blocked'' nebo ''message.received.unauthenticated''.
 +  * Endpoint má ověřovat podpis webhooku. AgentMail v dokumentaci zmiňuje Svix a ''webhook.secret''.
 +
 +Z pohledu agentního workflow je webhook jen spouštěč. Vlastní agent může běžet jako worker, serverless funkce, queue consumer nebo jiný proces, který z payloadu dostane identifikaci zprávy, načte případně plný obsah a provede doménovou akci.
  
 ===== Idempotence a bezpečné retry ===== ===== Idempotence a bezpečné retry =====
Řádek 132: Řádek 184:
   * [[https://docs.agentmail.to/api-reference/inboxes/create|Create Inbox API reference]]   * [[https://docs.agentmail.to/api-reference/inboxes/create|Create Inbox API reference]]
   * [[https://docs.agentmail.to/webhook-setup|Webhook setup]]   * [[https://docs.agentmail.to/webhook-setup|Webhook setup]]
 +  * [[https://docs.agentmail.to/webhooks-overview|Webhooks Overview]]
   * [[https://docs.agentmail.to/websockets|WebSockets]]   * [[https://docs.agentmail.to/websockets|WebSockets]]
   * [[https://docs.agentmail.to/idempotency|Idempotent Requests]]   * [[https://docs.agentmail.to/idempotency|Idempotent Requests]]
   * [[https://docs.agentmail.to/knowledge-base/mx-record-conflicts|MX record conflicts]]   * [[https://docs.agentmail.to/knowledge-base/mx-record-conflicts|MX record conflicts]]
   * [[https://www.agentmail.to/pricing|AgentMail pricing]]   * [[https://www.agentmail.to/pricing|AgentMail pricing]]
  • ai/platformy/agenti-a-orchestrace/agentmail.txt
  • Poslední úprava: 02.06.2026 20:09
  • autor: Petr Nosek