Available Tools - Complete List

Javapackage: com.etendoerp.copilot.toolpack

Overview

This document provides a comprehensive list of all available tools in the Etendo Copilot ecosystem. Each tool is designed to extend the capabilities of the Copilot assistant, enabling it to perform specific tasks and interact with various systems and services.

Info

To be able to include most of these functionalities, the Copilot Extensions Bundle must be installed. To do that, follow the instructions from the marketplace: Copilot Extensions Bundle. For more information about the available versions, core compatibility and new features, visit Copilot Extensions - Release notes.

Tools Categories

🔧 System Integration Tools

Tool Name	Description	Key Features
API Call Tool	Execute HTTP API calls to external services	REST API integration, authentication support
Client Init Tool	Initialize client configurations	Client setup, configuration management
Docker Tool	Manage Docker containers and images	Container lifecycle, image management
Load OAuth Token Tool	Securely fetch and manage OAuth tokens	Token management, secure authentication
Org Init Tool	Initialize organization settings	Organization setup, configuration

📁 File Management Tools

Tool Name	Description	Key Features
Attach File Tool	Attach files to conversations or processes	File attachment, metadata handling
File Copy Tool	Copy files between locations	File operations, path management
File Downloader Tool	Download files from URLs	HTTP downloads, file saving
Print Directory Tool	List and display directory contents	Directory navigation, file listing
Read File Tool	Read contents of text files	File reading, content extraction
Uncompress Tool	Extract compressed files and archives	Archive extraction, multiple formats
Write File Tool	Write and edit text files	File creation, content writing, backups

🧠 AI & Data Processing Tools

Tool Name	Description	Key Features
Audio Tool	Process and analyze audio files	Audio processing, speech recognition
Memory Tool	Manage persistent memories using vector database	CRUD operations, semantic search, user isolation
OCR Tool	Optical Character Recognition for images	Text extraction, image processing
PDF to Images Tool	Convert PDF pages to image formats	PDF processing, image conversion
Tavily Tool	Perform web searches using Tavily search engine	Internet search, information retrieval

📊 Document & Spreadsheet Tools

Tool Name	Description	Key Features
Etendo SQL to CSV Tool	Execute SQL queries in Etendo and export results to CSV	Database queries, CSV export, security validation
Google Drive Tool	Interact with Google Drive services	Cloud storage, file management
Google Spreadsheet Tool	Manage Google Sheets documents	Spreadsheet operations, data manipulation
Template Tool	Generate documents from templates	Template processing, document generation
XLS Tool	Handle Excel spreadsheet files	Excel processing, data extraction

📧 Communication Tools

Tool Name	Description	Key Features
Send Email Tool	Send emails through configured services	Email delivery, attachment support

🏗️ Development & Testing Tools

Tool Name	Description	Key Features
Codbar Tool	Generate and process barcodes	Barcode generation, various formats
Process Definition Jasper Tool	Handle Jasper report definitions	Report processing, definition management
Task Creator Tool	Create and define new tasks	Task creation, workflow management
Task Management Tool	Manage existing tasks and workflows	Task operations, status management
Test Run Tool	Execute tests and validation procedures	Test execution, result reporting

🌐 Translation & Localization Tools

Tool Name	Description	Key Features
XML Translation Tool	Translate XML content and structure	XML processing, translation services

Tool Selection Guidelines

When to Use Each Tool

For File Operations

Use Read File Tool when you need to examine file contents
Use Write File Tool when creating or modifying files
Use File Copy Tool for duplicating files
Use File Downloader Tool for fetching remote files

For Data Processing

Use Memory Tool for persistent information storage across conversations
Use OCR Tool for extracting text from images
Use Audio Tool for speech and audio analysis
Use Tavily Tool for web search and information gathering
Use Etendo SQL to CSV Tool for database queries and data export from Etendo

For Integration

Use API Call Tool for REST API interactions
Use Google Drive Tool and Google Spreadsheet Tool for Google Workspace integration
Use Send Email Tool for notifications and communication
Use Load OAuth Token Tool for secure authentication

For Development

Use Task Creator Tool and Task Management Tool for workflow automation
Use Test Run Tool for validation and testing
Use Docker Tool for containerized environments

Best Practices

Security Considerations

Always validate input parameters before using tools
Use appropriate authentication mechanisms (OAuth tokens, API keys)
Ensure user permissions are respected for file operations
Sanitize file paths and URLs to prevent security vulnerabilities

Performance Optimization

Cache frequently accessed data using the Memory Tool
Use batch operations when possible (e.g., multiple file operations)
Consider file size limitations for processing tools
Optimize search queries for better performance

Error Handling

Always check tool responses for error conditions
Implement fallback mechanisms for critical operations
Log errors appropriately for debugging
Provide meaningful error messages to users

Configuration Requirements

Most tools require specific configuration settings:

Environment Variables

API keys for external services (Tavily, Google APIs)
Authentication tokens and credentials
File system permissions (COPILOT_WRITE_RULE)
Service endpoints and URLs

Dependencies

Chroma vector database for Memory Tool
Docker runtime for Docker Tool
Python libraries for various processing tools
Network access for API and download tools

Support and Troubleshooting

For issues with specific tools:

Check the individual tool documentation for configuration requirements
Verify all required environment variables are set
Ensure proper permissions for file system operations
Validate network connectivity for external service tools
Review error logs for detailed debugging information

For additional support, refer to the Etendo Copilot Documentation or contact the development team.