Built-in Tools

This page documents all the built-in tools available in Vertesia Studio for use with Agents.

Core Tools

Fundamental tools for reasoning, planning, and task organization. These are the essential building blocks for complex agent workflows.

Think Tool

Name: think

A tool for deep thinking and analysis of complex problems step by step. Useful for brainstorming and planning.

Plan Tool

Name: plan

Creates structured, executable plans with tracked progress.

Update Plan Tool

Name: update_plan

Updates multiple tasks in your active plan simultaneously with visual progress tracking. Works in conjunction with the plan tool to maintain live status updates.

Parallel Execution Tools

Advanced tools for decomposing complex problems into parallel workstreams. These tools enable sophisticated multi-threaded problem solving by creating dedicated sub-agents.

Execute Parallel Work Streams Tool

Name: execute_parallel_work_streams

Executes multiple parallel work streams to solve complex problems by decomposing them into independent tasks that run concurrently. Perfect for complex problems that can be broken down into separate components that can be solved independently. Each task runs as a dedicated sub-agent with access to the specified tools and will work independently in parallel, dramatically speeding up complex multi-part tasks. Results can be automatically aggregated or returned individually.

Document Management Tools

Tools for managing documents in the Vertesia knowledge base. These tools handle CRUD operations for documents with full metadata support.

Search Documents Tool

Name: search_documents

Searches for documents using various criteria and filters.

Fetch Documents Tool

Name: fetch_documents

Retrieves specific documents from the system by their identifiers.

Create Document Tool

Name: create_document

Creates new documents in the system with specified content, metadata, and properties.

Update Document Tool

Name: update_document

Updates existing documents with new content or properties.

Type Management Tools

Tools for managing object type definitions and schemas. These tools control the structure and validation rules for different types of objects in the system.

Get Object Type Tool

Name: get_object_type

Retrieves details about specific object type definitions.

Create or Update Type Tool

Name: create_or_update_object_type

Creates new or updates existing object type definitions.

Spreadsheet Tools

Specialized tools for working with Excel files using custom JavaScript code. These tools provide full programmatic access to spreadsheet data and manipulation capabilities.

Analyze Spreadsheet Tool

Name: analyze_spreadsheet

Extracts insights from Excel files using custom JavaScript code. This specialized tool processes spreadsheets from the knowledge base and executes your analysis code against the data with multi-sheet support and data processing capabilities.

Update Spreadsheet Tool

Name: update_spreadsheet

Modifies Excel files using custom JavaScript code. This tool processes spreadsheets, executes modification code, and saves the updated spreadsheet with versioning support.

Create Spreadsheet Tool

Name: create_spreadsheet

Creates new Excel files from scratch using custom JavaScript code. Generate spreadsheets based on your code and save them to the knowledge base with multi-sheet support.

Collection Management Tools

Tools for organizing and grouping related documents into collections. Collections provide hierarchical organization and bulk operations on document sets.

Create Collection Tool

Name: create_collection

Creates a new collection for organizing related documents. Collections act as containers that group documents together for easier management and access.

Update Collection Tool

Name: update_collection

Modifies an existing collection's properties, such as name, description, or schema definition. This tool updates collection metadata without affecting the documents contained within it.

Add to Collection Tool

Name: add_to_collection

Places one or more existing documents into a collection for organization and grouping. This tool establishes relationships between documents and collections, without modifying the documents themselves.

Remove from Collection Tool

Name: remove_from_collection

Removes documents from a collection while preserving the documents themselves. This tool only breaks the association between documents and a collection; it does not delete the documents from the system.

Get Collection Tool

Name: get_collection

Accesses detailed information about an existing collection, including its name, description, schema, and member documents. This tool retrieves the full definition of a collection along with metadata about contained documents.

Search Collections Tool

Name: search_collections

Finds collections by searching for partial matches in collection names. This tool searches through all existing collections and returns those whose names contain the specified search term using case-insensitive partial matching.

Web and External Tools

Tools for interacting with external services and executing custom code. These tools extend agent capabilities beyond the core platform functionality.

Web Search Tool

Name: web_search

Searches the web for information using specified queries and options.

This activity requires an API key for serper. Go to Setting in Studio to configure your API key.

Execute Code Tool

Name: execute_code

Runs JavaScript code snippets within the workflow.

Ask User Tool

Name: ask_user

Requests input from users during workflow execution.

Analyze Image Tool

Name: analyze_image

Executes ImageMagick commands on images and PDFs, storing results to cloud storage. Supports standard image formats and PDF documents with command chaining capabilities.