Skip to content

A programming framework for agentic AI

Specify well known topic types for direct agent channel (#4390)

Jack Gerritsa6ccb6f70430
diff --git a/docs/design/02 - Topics.md b/docs/design/02 - Topics.md
index 7d7149c37..bf3ed8d9d 100644
--- a/docs/design/02 - Topics.md
+++ b/docs/design/02 - Topics.md
@@ -51,3 +51,16 @@ Agents are able to handle certain types of messages. This is an internal detail
> [!NOTE]
> This might be revisited based on scaling and performance considerations.
+
+## Well known topic types
+
+Agents should subscribe via a prefix subscription to the `{AgentType}:` topic as a direct message channel for the agent type.
+
+For this subscription source should map directly to agent key.
+
+This subscription will therefore receive all events for the following well known topics:
+
+- `{AgentType}:` - General purpose direct messages. These should be routed to the approriate message handler.
+- `{AgentType}:rpc_request` - RPC request messages. These should be routed to the approriate RPC handler.
+- `{AgentType}:rpc_response={RequestId}` - RPC response messages. These should be routed back to the response future of the caller.
+- `{AgentType}:error={RequestId}` - Error message that corresponds to the given request.