> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation Request Protocol • AI Agent SDK

> ConversationRequestProtocol: Protocol for agent-facing cross-conversation request/reply.

# ConversationRequestProtocol

> Defined in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

AI Agent

Protocol for agent-facing cross-conversation request/reply.

A concrete implementation is provided by the running gateway/bot (in the
praisonai wrapper) and registered into the per-turn context so the built-in
`ask_conversation` tool can resolve it. It sends the prompt via the same
delivery stack `send_message` uses, then correlates the *next inbound
reply* from that target (via the existing `correlation_id`) with a bounded
timeout, returning a typed :class:`ConversationReply`.

Example usage (implementation in praisonai\_bot.gateway)::

requester = BotConversationRequester(router, origin=origin)
token = register\_conversation\_requester(requester)
try:
...  # agent runs; ask\_conversation tool resolves the requester
finally:
clear\_conversation\_requester(token)

## Methods

> [card] [ask()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/ConversationRequestProtocol-ask.md)
>
> Send `text` to `target` and await the next correlated reply.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L3780)
>
> `praisonaiagents/gateway/protocols.py` at line 3780


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.