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.
List Available Built-in Tools
Add to TEMPLATE.yaml
# TEMPLATE.yaml
name: my-template
version: "1.0.0"
requires:
tools:
- internet_search
- shell_tool
- file_read_tool
Assign to Agents
# agents.yaml
roles:
researcher:
role: Research Agent
tools:
- internet_search
executor:
role: Executor Agent
tools:
- shell_tool
- file_read_tool
Create tools.py
# tools.py
def analyze_data(data: str) -> dict:
"""Analyze input data.
Args:
data: Data to analyze
Returns:
Analysis results
"""
return {"analysis": "complete", "data": data}
Assign to Agent
# agents.yaml
roles:
analyst:
role: Data Analyst
tools:
- analyze_data
tasks:
analyze:
description: "Analyze the provided data"
Run Template
praisonai templates run ./my-template
Add tools_sources
# TEMPLATE.yaml
requires:
tools_sources:
- praisonai_tools.video
- ./extra_tools.py
Assign External Tools
# agents.yaml
roles:
video_editor:
role: Video Editor
tools:
- shell_tool
tasks:
edit:
description: |
Use python -m praisonai_tools.video to edit videos
Load Template
from praisonai.templates.loader import TemplateLoader
loader = TemplateLoader()
template = loader.load_template("my-template")
Create Custom Tools
def custom_tool(input: str) -> str:
"""Custom processing tool."""
return f"Processed: {input}"
Run with Additional Tools
result = template.run(
task="Process data",
additional_tools=[custom_tool]
)
| Practice | Description |
|---|
| Minimal tools | Only assign tools each agent needs |
| Clear naming | Use descriptive tool names |
| Document tools | Include docstrings with Args |
| Test tools | Verify tools work before assigning |
| Group related | Keep related tools together |