Documentation Index
Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
MongoDB tool allows you to query and manage MongoDB NoSQL databases directly from your AI agents.
Installation
pip install "praisonai[tools]"
Environment Variables
export MONGODB_URI=mongodb://localhost:27017
export MONGODB_DATABASE=mydb
Quick Start
from praisonai_tools import MongoDBTool
# Initialize
mongo = MongoDBTool(
uri="mongodb://localhost:27017",
database="mydb"
)
# Query
results = mongo.find("users", {"active": True})
print(results)
Usage with Agent
from praisonaiagents import Agent
from praisonai_tools import MongoDBTool
mongo = MongoDBTool(uri="mongodb://localhost:27017", database="mydb")
agent = Agent(
name="DataAnalyst",
instructions="You are a data analyst. Use MongoDB to query documents.",
tools=[mongo]
)
response = agent.chat("Find all active users")
print(response)
Available Methods
find(collection, query, limit=10)
Find documents matching a query.
from praisonai_tools import MongoDBTool
mongo = MongoDBTool(uri="mongodb://localhost:27017", database="mydb")
results = mongo.find("users", {"status": "active"}, limit=5)
insert(collection, document)
Insert a document.
mongo.insert("users", {"name": "Alice", "email": "alice@example.com"})
update(collection, query, update)
Update documents.
mongo.update("users", {"name": "Alice"}, {"$set": {"status": "inactive"}})
delete(collection, query)
Delete documents.
mongo.delete("users", {"status": "inactive"})
list_collections()
List all collections.
collections = mongo.list_collections()
Docker Setup
docker run -d --name mongodb \
-p 27017:27017 \
mongo:7
Common Errors
| Error | Cause | Solution |
|---|
pymongo not installed | Missing dependency | Run pip install pymongo |
Connection refused | MongoDB not running | Start MongoDB server |
Authentication failed | Wrong credentials | Check connection string |
