Skip to main content
Version: 2.0

Agent Management APIs

The Agent Management APIs enable you to create, configure, and manage Vectara agents. Agents are AI assistants that can use tools, follow instructions, and maintain conversation context.

  • Create agents with custom tools, instructions, and model configurations
  • List agents to view all agents in your account
  • Get agent details to retrieve configuration and metadata
  • Update agent settings to modify tools, instructions, or other properties
  • Delete agents when no longer needed

Agent configuration

  • Name and description: Human-readable identification
  • Tool configurations: Define what tools the agent can use (web search, corpora search, MCP tools)
  • Instructions: Provide personality, behavior guidelines, and task-specific guidance
  • Model settings: Configure which LLM to use and its parameters
  • First step: Define the agent's entry point and initial behavior

Agent tools

Agents can be configured with various tools:

  • Web search: Search the internet for current information via Tavily
  • Corpora search: Query your Vectara corpora for relevant content
  • MCP tools: External tools from Model Context Protocol servers

Available endpoints

EndpointMethodPurpose
Create AgentPOSTCreate a new agent with specified configuration
List AgentsGETRetrieve all agents in your account
Get AgentGETGet detailed configuration of a specific agent
Update AgentPATCHModify existing agent properties
Replace AgentPUTCompletely replace an agent's configuration
Delete AgentDELETERemove an agent permanently