Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.restate.dev/llms.txt

Use this file to discover all available pages before exploring further.

Let users subscribe to notifications for long-running agent tasks instead of waiting. With Restate’s durable promises, you can coordinate between agent execution and notification handlers, no extra infrastructure needed.

​
How does Restate help?

Building this yourself requires message queues, databases, and polling workers. Restate replaces all that with a few lines of code:
  • Durable promises: Create promises that survive failures and restarts
  • Zero infrastructure: No queues, databases, or polling workers needed
  • No race conditions: Late subscribers immediately receive already-resolved results
  • Serverless-friendly: Handlers suspend while waiting - pay only for active compute
  • Works with any LLM SDK and any language supported by Restate

​
Example

The pattern works in two steps: Step 1: The agent handler processes the request and resolves a durable promise with the result. Step 2: The notification handler awaits that promise and sends the notification when it resolves. Check out the SDK documentation for more details on the durable promises API (TS / Python).
This pattern is implementable with any of our SDKs and any AI SDK. If you need help with a specific SDK, please reach out to us via Discord or Slack.
1

Requirements

  • AI SDK of your choice (e.g., OpenAI, LangChain, Pydantic AI, LiteLLM, etc.) to make LLM calls.
  • API key for your model provider.
2

Download the example

Python
git clone https://github.com/restatedev/ai-examples.git &&
cd ai-examples/openai-agents/examples/notify_when_ready
3

Start the Restate Server

restate-server
4

Start the Service

Export the API key of your model provider as an environment variable and then start the agent. For example, for OpenAI:
Python
export OPENAI_API_KEY=your_openai_api_key
uv run .
5

Register the services

Service Registration
6

Send a request

In the UI (http://localhost:9070), click on the run handler of the AsyncNotificationsAgent to open the playground and send a request to the run handler and then the on_notify handler.Or send requests via the terminal.First, start the agent asynchronously by adding /send to the end of the URL:
curl localhost:8080/AsyncNotificationsAgent/msg-123/run/send \
  --json '"Write a 1000-word description of Durable Execution"'
Then, asynchronously call the on_notify handler to send the agent response via email once it’s ready:
curl localhost:8080/AsyncNotificationsAgent/msg-123/on_notify/send \
  --json '"[email protected]"'
Notice that the key msg-123 is identical for both requests, to send them to the same workflow instance.
7

Check the Restate UI

In the Restate UI, you see how the notify handler waited on the agent response and then sent the email.