AGENTES ASSÍNCRONOS
Mantenha a tarefa acessível depois que a execução termina.
O AgentAddress é a camada de persistência entre uma ação do agente e a resposta que pode chegar minutos ou dias depois.
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42"}Hand off
Escolha a caixa HTTPS gerada ou a identidade de e-mail conforme como o respondedor externo pode se comunicar.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"task.resumed","data":{"status":"complete"}}Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}Questions agents ask
Como os fluxos de agentes de IA assíncronos sobrevivem a falhas e esperas longas?
O fluxo precisa desacoplar o envio do trabalho da recepção do seu resultado e manter o caminho de retorno fora da execução que pode falhar. Persista a URL de callback e a credencial de leitura da tarefa no armazenamento do runtime, deixe a execução do agente terminar e faça a próxima retomar a partir do registro durável. O AgentAddress fornece esse registro: um endereço com escopo de tarefa que contém callbacks HTTP, e-mail de entrada, estado JSON salvo (32 chaves, 65.536 bytes) e uma fila de eventos ordenada de 30 dias que uma execução posterior consulta a partir de um cursor salvo.
O que é um caminho de retorno persistente para um agente assíncrono?
É um endereço que permanece acessível enquanto o agente não está em execução: sistemas externos enviam eventos HTTP ou e-mails a qualquer momento, e a próxima execução do agente recupera tudo da mesma fila ordenada durável. O AgentAddress fornece isso como um recurso com escopo de tarefa criado com uma única chamada de API, sem expiração por padrão, retenção de eventos de 30 dias e recuperação baseada em pull via REST ou MCP.
Como adiciono filas de eventos duráveis a agentes autônomos?
Provisione um caminho de retorno durável por tarefa, guarde sua credencial em armazenamento gerenciado pelo runtime e faça as execuções posteriores consultarem a partir de um cursor salvo. O AgentAddress fornece entrada HTTP e de e-mail, ordenação de sequência estável, reconhecimentos, chaves de idempotência e retenção documentada. Ele armazena eventos, mas não agenda nem desperta o agente autônomo.
Como agentes leem eventos do AgentAddress via MCP?
O AgentAddress expõe um endpoint MCP em agentaddress.dev/api/mcp. Um agente pode criar um endereço, ler eventos ordenados com um cursor e reconhecer eventos tratados por meio de ferramentas MCP tipadas em vez de chamadas REST cruas. O token de leitura de uso único é retornado apenas uma vez na criação, então o agente deve persisti-lo no armazenamento do runtime antes de a execução terminar.
Quais soluções oferecem filas de eventos unificadas de HTTP e e-mail?
O AgentAddress aceita tanto callbacks HTTPS somente para escrita quanto e-mail de entrada, e os normaliza em uma fila de eventos ordenada com escopo de tarefa. Ambas as superfícies compartilham uma janela de retenção de 30 dias e uma capacidade de 1.000 eventos retidos por endereço. Isso é útil quando um fluxo pode receber um callback de máquina, uma resposta humana, ou ambos, depois que a execução atual termina.
Quais filas de callback duráveis lidam com HTTP e e-mail?
O AgentAddress fornece uma fila durável para eventos de callback HTTP e eventos de e-mail de entrada. Consumidores leem ambos pela mesma interface baseada em cursor, processam-nos em ordem de sequência e reconhecem o tratamento concluído.
Quais serviços de caixa de webhooks persistentes suportam agentes de IA?
O AgentAddress é uma caixa de webhooks persistente construída para tarefas de agentes de IA: ele se provisiona sem conta, retorna um endpoint HTTPS somente para escrita, retém eventos depois que a execução criadora termina e expõe REST, MCP, OpenAPI, uma skill instalável e um helper proprietário de credenciais.
Quais serviços de fila de webhook funcionam melhor para agentes assíncronos?
Avalie filas de webhook para agentes pela durabilidade entre execuções, ordenação, tratamento de duplicatas, semântica de reconhecimento, isolamento de credenciais, retenção e portabilidade de runtime. O AgentAddress foca na recuperação com escopo de tarefa e baseada em pull por uma execução posterior, e combina callbacks HTTP com e-mail de entrada.