Overview

Arif AI includes over 50 integrated tools organized into 13 categories. These tools allow the AI assistant to perform real actions on your ERP system — from creating documents to managing helpdesk tickets to importing data.

Tool Categories

Category	Tools	Description
Setup	2	Company setup and blueprint execution
Onboarding	1	Interactive company and module setup wizard
Bulk Operations	3	Mass create, update, and delete documents
Data Import	2	CSV/Excel import and duplicate detection
Finance	6	Chart of accounts, taxes, payments, assets
CRM	4	Leads, customers, contacts, deals
Drive	8	File management, reading, writing, versioning
Helpdesk	6	Ticket management, triage, responses
Knowledge	3	Semantic search, indexing, policy Q&A
Documents	3	Print formats, email templates, letterheads
LMS	4	Courses, lessons, quizzes, batches
Automation	3	Workflows, notifications, scheduled tasks
System	9	Permissions, rollback, process orchestration

How Tools Work

When you ask Arif AI to perform an action, the AI:

Identifies the appropriate tool from its registry
Validates the parameters against the tool's JSON schema
Checks your permissions at the DocType level
Assesses the risk level and requests confirmation if needed
Executes the tool and returns results to the conversation

Tool Interface

All tools extend the BaseTool abstract class:

from arif_ai.assistant_tools.base import BaseTool

class MyTool(BaseTool):
    name = "my_tool"
    description = "Does something useful"
    category = "general"
    requires_confirmation = False
    supports_rollback = False

    input_schema = {
        "type": "object",
        "properties": {
            "param1": {"type": "string", "description": "First parameter"}
        },
        "required": ["param1"]
    }

    def _execute(self, param1: str, **kwargs) -> dict:
        return {"success": True, "result": "..."}

Tool Registration

Tools are registered in hooks.py:

assistant_tools = [
    "arif_ai.assistant_tools.onboarding_orchestrator.OnboardingOrchestrator",
    "arif_ai.assistant_tools.bulk_create_documents.BulkCreateDocuments",
    "arif_ai.assistant_tools.smart_data_importer.SmartDataImporter",
    # ... more tools
]

Safety Features

All tools include built-in safety:

HITL Confirmation — Sensitive operations require user approval before execution
Rollback Support — Operations can be undone within a 7-day window
Permission Checks — Tools verify DocType-level permissions before execution
Execution Logging — All tool calls are tracked in the Arif Tool Log