RAG-powered Conversational Agent — The most advanced AI retrieval system. Containerized, Retrieval-Augmented Generation (RAG) with a RESTful API.

Engage with an intelligent RAG-powered conversational agent for complex information retrieval and analysis.

This advanced endpoint combines retrieval-augmented generation (RAG) with a conversational AI agent to provide detailed, context-aware responses based on your document collection. The agent can:

Maintain conversation context across multiple interactions
Dynamically search and retrieve relevant information from both vector and knowledge graph sources
Break down complex queries into sub-questions for comprehensive answers
Cite sources and provide evidence-based responses
Handle follow-up questions and clarifications
Navigate complex topics with multi-step reasoning

Key Features:

Hybrid search combining vector and knowledge graph approaches
Contextual conversation management with conversation_id tracking
Customizable generation parameters for response style and length
Source document citation with optional title inclusion
Streaming support for real-time responses
Branch management for exploring different conversation paths

Common Use Cases:

Research assistance and literature review
Document analysis and summarization
Technical support and troubleshooting
Educational Q&A and tutoring
Knowledge base exploration

The agent uses both vector search and knowledge graph capabilities to find and synthesize information, providing detailed, factual responses with proper attribution to source documents.

Request

This endpoint expects an object.

messageobjectOptional

Current message to process

search_modeenumOptional

Allowed values: basicadvancedcustom

Default value of custom allows full control over search settings.

Pre-configured search modes: basic: A simple semantic-based search. advanced: A more powerful hybrid search combining semantic and full-text. custom: Full control via search_settings.

If filters or limit are provided alongside basic or advanced, they will override the default settings for that mode.

search_settingsobjectOptional

The search configuration object. If search_mode is custom, these settings are used as-is. For basic or advanced, these settings will override the default mode configuration.

Common overrides include filters to narrow results and limit to control how many results are returned.

rag_generation_configobjectOptional

Configuration for RAG generation

task_prompt_overridestringOptional

Optional custom prompt to override default

include_title_if_availablebooleanOptional

Include document titles in responses when available

conversation_idstringOptional

ID of the conversation

branch_idstringOptional

ID of the conversation branch

messageslist of objectsOptionalDeprecated

List of messages (deprecated, use message instead)

Response

Successful Response

resultsobject

Errors

1 from r2r import R2RClient 2 3 client = R2RClient("http://localhost:7272") 4 # when using auth, do client.login(...) 5 6 response =client.retrieval.agent( 7 message={ 8 "role": "user", 9 "content": "What were the key contributions of Aristotle to logic and how did they influence later philosophers?" 10 }, 11 search_settings={ 12 "use_semantic_search": True, 13 "filters": {"document_id": {"$eq": "3e157b3a-8469-51db-90d9-52e7d896b49b"}}, 14 "limit": 10, 15 chunk_settings={ 16 "limit": 20, # separate limit for chunk vs. graph 17 }, 18 graph_settings={ 19 "enabled": True, 20 }, 21 }, 22 rag_generation_config: { 23 stream: false, 24 temperature: 0.7, 25 max_tokens: 150 26 } 27 include_title_if_available=True, 28 conversation_id="550e8400-e29b-41d4-a716-446655440000" # Optional for conversation continuity 29 )

1 { 2 "results": { 3 "messages": [ 4 { 5 "role": "assistant", 6 "function_call": { 7 "arguments": "{\"query\":\"Aristotle biography\"}", 8 "name": "search" 9 } 10 }, 11 { 12 "role": "function", 13 "content": "1. Aristotle[A] (Greek: Ἀριστοτέλης Aristotélēs, pronounced [aristotélɛːs]; 384–322 BC) was an Ancient Greek philosopher and polymath. His writings cover a broad range of subjects spanning the natural sciences, philosophy, linguistics, economics, politics, psychology, and the arts. As the founder of the Peripatetic school of philosophy in the Lyceum in Athens, he began the wider Aristotelian tradition that followed, which set the groundwork for the development of modern science.\n2. Aristotle[A] (Greek: Ἀριστοτέλης Aristotélēs, pronounced [aristotélɛːs]; 384–322 BC) was an Ancient Greek philosopher and polymath. His writings cover a broad range of subjects spanning the natural sciences, philosophy, linguistics, economics, politics, psychology, and the arts. As the founder of the Peripatetic school of philosophy in the Lyceum in Athens, he began the wider Aristotelian tradition that followed, which set the groundwork for the development of modern science.\n3. Aristotle was born in 384 BC[C] in Stagira, Chalcidice,[2] about 55 km (34 miles) east of modern-day Thessaloniki.[3][4] His father, Nicomachus, was the personal physician to King Amyntas of Macedon. While he was young, Aristotle learned about biology and medical information, which was taught by his father.[5] Both of Aristotle's parents died when he was about thirteen, and Proxenus of Atarneus became his guardian.[6] Although little information about Aristotle's childhood has survived, he probably spent\n4. Aristotle was born in 384 BC[C] in Stagira, Chalcidice,[2] about 55 km (34 miles) east of modern-day Thessaloniki.[3][4] His father, Nicomachus, was the personal physician to King Amyntas of Macedon. While he was young, Aristotle learned about biology and medical information, which was taught by his father.[5] Both of Aristotle's parents died when he was about thirteen, and Proxenus of Atarneus became his guardian.[6] Although little information about Aristotle's childhood has survived, he probably spent\n5. Life\nIn general, the details of Aristotle's life are not well-established. The biographies written in ancient times are often speculative and historians only agree on a few salient points.[B]\n", 14 "name": "search" 15 }, 16 { 17 "role": "assistant", 18 "content": "Aristotle (384–322 BC) was an Ancient Greek philosopher and polymath whose contributions have had a profound impact on various fields of knowledge. Here are some key points about his life and work:\n\n1. **Early Life**: Aristotle was born in 384 BC in Stagira, Chalcidice, which is near modern-day Thessaloniki, Greece. His father, Nicomachus, was the personal physician to King Amyntas of Macedon, which exposed Aristotle to medical and biological knowledge from a young age [C].\n\n2. **Education and Career**: After the death of his parents, Aristotle was sent to Athens to study at Plato's Academy, where he remained for about 20 years. After Plato's death, Aristotle left Athens and eventually became the tutor of Alexander the Great [C].\n\n3. **Philosophical Contributions**: Aristotle founded the Lyceum in Athens, where he established the Peripatetic school of philosophy. His works cover a wide range of subjects, including metaphysics, ethics, politics, logic, biology, and aesthetics. His writings laid the groundwork for many modern scientific and philosophical inquiries [A].\n\n4. **Legacy**: Aristotle's influence extends beyond philosophy to the natural sciences, linguistics, economics, and psychology. His method of systematic observation and analysis has been foundational to the development of modern science [A].\n\nAristotle's comprehensive approach to knowledge and his systematic methodology have earned him a lasting legacy as one of the greatest philosophers of all time.\n\nSources:\n- [A] Aristotle's broad range of writings and influence on modern science.\n- [C] Details about Aristotle's early life and education." 19 } 20 ], 21 "conversation_id": "a32b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d" 22 } 23 }

1	from r2r import R2RClient
2
3	client = R2RClient("http://localhost:7272")
4	# when using auth, do client.login(...)
5
6	response =client.retrieval.agent(
7	message={
8	"role": "user",
9	"content": "What were the key contributions of Aristotle to logic and how did they influence later philosophers?"
10	},
11	search_settings={
12	"use_semantic_search": True,
13	"filters": {"document_id": {"$eq": "3e157b3a-8469-51db-90d9-52e7d896b49b"}},
14	"limit": 10,
15	chunk_settings={
16	"limit": 20, # separate limit for chunk vs. graph
17	},
18	graph_settings={
19	"enabled": True,
20	},
21	},
22	rag_generation_config: {
23	stream: false,
24	temperature: 0.7,
25	max_tokens: 150
26	}
27	include_title_if_available=True,
28	conversation_id="550e8400-e29b-41d4-a716-446655440000" # Optional for conversation continuity
29	)

1	{
2	"results": {
3	"messages": [
4	{
5	"role": "assistant",
6	"function_call": {
7	"arguments": "{\"query\":\"Aristotle biography\"}",
8	"name": "search"
9	}
10	},
11	{
12	"role": "function",
13	"content": "1. Aristotle[A] (Greek: Ἀριστοτέλης Aristotélēs, pronounced [aristotélɛːs]; 384–322 BC) was an Ancient Greek philosopher and polymath. His writings cover a broad range of subjects spanning the natural sciences, philosophy, linguistics, economics, politics, psychology, and the arts. As the founder of the Peripatetic school of philosophy in the Lyceum in Athens, he began the wider Aristotelian tradition that followed, which set the groundwork for the development of modern science.\n2. Aristotle[A] (Greek: Ἀριστοτέλης Aristotélēs, pronounced [aristotélɛːs]; 384–322 BC) was an Ancient Greek philosopher and polymath. His writings cover a broad range of subjects spanning the natural sciences, philosophy, linguistics, economics, politics, psychology, and the arts. As the founder of the Peripatetic school of philosophy in the Lyceum in Athens, he began the wider Aristotelian tradition that followed, which set the groundwork for the development of modern science.\n3. Aristotle was born in 384 BC[C] in Stagira, Chalcidice,[2] about 55 km (34 miles) east of modern-day Thessaloniki.[3][4] His father, Nicomachus, was the personal physician to King Amyntas of Macedon. While he was young, Aristotle learned about biology and medical information, which was taught by his father.[5] Both of Aristotle's parents died when he was about thirteen, and Proxenus of Atarneus became his guardian.[6] Although little information about Aristotle's childhood has survived, he probably spent\n4. Aristotle was born in 384 BC[C] in Stagira, Chalcidice,[2] about 55 km (34 miles) east of modern-day Thessaloniki.[3][4] His father, Nicomachus, was the personal physician to King Amyntas of Macedon. While he was young, Aristotle learned about biology and medical information, which was taught by his father.[5] Both of Aristotle's parents died when he was about thirteen, and Proxenus of Atarneus became his guardian.[6] Although little information about Aristotle's childhood has survived, he probably spent\n5. Life\nIn general, the details of Aristotle's life are not well-established. The biographies written in ancient times are often speculative and historians only agree on a few salient points.[B]\n",
14	"name": "search"
15	},
16	{
17	"role": "assistant",
18	"content": "Aristotle (384–322 BC) was an Ancient Greek philosopher and polymath whose contributions have had a profound impact on various fields of knowledge. Here are some key points about his life and work:\n\n1. Early Life: Aristotle was born in 384 BC in Stagira, Chalcidice, which is near modern-day Thessaloniki, Greece. His father, Nicomachus, was the personal physician to King Amyntas of Macedon, which exposed Aristotle to medical and biological knowledge from a young age [C].\n\n2. Education and Career: After the death of his parents, Aristotle was sent to Athens to study at Plato's Academy, where he remained for about 20 years. After Plato's death, Aristotle left Athens and eventually became the tutor of Alexander the Great [C].\n\n3. Philosophical Contributions: Aristotle founded the Lyceum in Athens, where he established the Peripatetic school of philosophy. His works cover a wide range of subjects, including metaphysics, ethics, politics, logic, biology, and aesthetics. His writings laid the groundwork for many modern scientific and philosophical inquiries [A].\n\n4. Legacy: Aristotle's influence extends beyond philosophy to the natural sciences, linguistics, economics, and psychology. His method of systematic observation and analysis has been foundational to the development of modern science [A].\n\nAristotle's comprehensive approach to knowledge and his systematic methodology have earned him a lasting legacy as one of the greatest philosophers of all time.\n\nSources:\n- [A] Aristotle's broad range of writings and influence on modern science.\n- [C] Details about Aristotle's early life and education."
19	}
20	],
21	"conversation_id": "a32b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d"
22	}
23	}