Skip to main content
Version: 2.0

Tools

Tools represent external or internal capabilities that agents can invoke dynamically. They are defined by:

  • A unique ID (tol_abcd) and name.
  • A description of their function.
  • An input schema describing accepted parameters (in JSON Schema format).
  • Metadata for categorization.
  • Runtime availability (enabled/disabled).

Available tools​

The tech preview of Vectara Agents provides the following tools:

  • corpora_search: Retrieves results from a Vectara corpus or corpora using Retrieval Augmented Generation (RAG). This tool provides summary and relevant search results using the same default parameters as the Multiple Corpora Query.
  • web_search: Retrieves results from the public web.

Tool permissions and security​

Tools follow the same permission model as the rest of Vectara:

  1. API keys: Tools can only access corpora if the API key has access to the corpora.
  2. Metadata filtering: Additional security through metadata filters.
  3. Result limiting: Control how much data tools can retrieve.