Skip to content

Commit c7e4f05

Browse files
committed
docs: expand why each SDK suits its use case (AIT-865)
Address Paddy's review: explain what the Chat SDK covers for human chat, and why agent applications need AI Transport (regeneration and conversation forking beyond message editing, runs and steps as control flow rather than just progress indicators).
1 parent 0ee88bf commit c7e4f05

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

src/pages/docs/platform/products/index.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -300,6 +300,10 @@ AI Transport and the Chat SDK both handle conversations but for different types
300300
| A user conversing with an AI agent: streaming responses, multi-turn, across devices | [AI Transport](/docs/ai-transport) |
301301
| People conversing with each other: support staffed by humans, group chat, livestream chat | [Chat SDK](/docs/chat) |
302302

303+
The Chat SDK provides support for operations that are commonly needed in chat applications: not just publishing and subscribing to messages, but moderation, typing indicators, emoji reactions, and editing and deleting messages.
304+
305+
AI Transport supports interactions with AI agents that go beyond this. It is built for human-to-agent and client-to-agent interactions that support an agentic loop, tool calls, human-in-the-loop, interruption and steering, as well as streamed responses. Simple editing of messages, as supported by the Chat SDK, is not sufficient for agent applications, because of the need to support regeneration of responses and the resultant forking of conversations. Similarly, agentic applications have a much richer need to indicate progress than the simple typing indicators sufficient for human chat, and agentic interactions such as runs and steps are an intrinsic part of the control flow of an agent session, not just a visual indicator.
306+
303307
In support scenarios, if an AI answers the user then reach for AI Transport, even when a human can take over the conversation. If people staff the conversation, reach for the Chat SDK, even when AI moderates or assists behind the scenes.
304308

305309
The two products run on the same Ably platform but are separate today, so you can [combine](#combine-pubsub) either of them with Pub/Sub but not with each other. Closer integration between AI Transport and Chat is coming soon, which will give applications that need both AI-driven and human-to-human messaging a simple implementation path.

0 commit comments

Comments
 (0)