Chat With Agent
Send a text message to an agent and get a response.
This endpoint allows REST API-based interactions with agents, useful for:
- Web chat interfaces
- API integrations
- Testing agent behavior
- Non-voice applications
Example:
{
"query": "What is your refund policy?",
"conversation_id": "conv-123", // Optional, for follow-up
"top_k": 5
}
Response:
{
"response": "Our refund policy allows...",
"payload": null,
"selected_tool": null,
"conversation_id": "conv-123",
"trace_id": "trace-abc",
"execution_time_ms": 850,
"versions": {"kb_v": "1.0", "policy_v": "1.0", "tools_v": "1.0"}
}
Documentation Index
Fetch the complete documentation index at: https://docs.mrassistant.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Request to chat with an agent via text.
User's message/query
1 - 2000Existing conversation ID to continue
Additional context for this query
Number of knowledge chunks to retrieve
1 <= x <= 20Response
Successful Response
Response from agent chat.
Agent's text response
Conversation ID for follow-up messages
Trace ID for debugging
Execution time in milliseconds
Version information (kb, policy, tools)
Tool output payload if applicable
Tool that was executed
Outcome classification