Skip to main content
This guide explains how to create and manage agents in Veratrace.

​
Prerequisites

  • Access to a Veratrace instance
  • Appropriate permissions to manage agents
Source: Feature Inventory - UI Flows (Agents)

​
Create an Agent

Navigate to /agents/create to create a new agent. Source: Feature Inventory - UI Flows (Agents)

​
Agent Configuration

​
Basic Information

  • Name - Agent name
  • Type - AI or HUMAN
  • Active - Whether the agent is active
Source: Feature Inventory - Core Objects (Agent)

​
AI Agent Configuration

For AI agents, configure:
  • Model - AI model identifier (e.g., “gpt-4”, “gpt-3.5-turbo”, “claude-3”)
  • Capabilities - AI-specific capabilities
Source: Feature Inventory - Core Objects (Agent)

​
Human Agent Configuration

For human agents, configure:
  • Capabilities - Human-specific capabilities
Source: Feature Inventory - Core Objects (Agent)

​
Priority

Set agent priority level:
  • high - High priority
  • medium - Medium priority
  • low - Low priority
Source: Feature Inventory - Core Objects (Agent)

​
Create via API

API: POST /instances/:instanceId/agents Request body: 
{
  "name": "Agent Name",
  "type": "AI",
  "active": true,
  "capabilities": ["text_generation", "code_generation"],
  "model": "gpt-4",
  "priority": "high",
  "metadata": {}
}
Source: Feature Inventory - API Surface (Agents API)

​
Update an Agent

Navigate to /agents/:agentId/edit or use the API. API: PUT /instances/:instanceId/agents/:agentId Source: Feature Inventory - API Surface (Agents API)

​
List Agents

View all agents at /agents or use the API. API: GET /instances/:instanceId/agents Query parameters:
  • type - Filter by type (AI, HUMAN)
  • active - Filter by active status
  • name - Search by name
  • page, size, sort - Pagination and sorting
Source: Feature Inventory - API Surface (Agents API)

​
Delete an Agent

API: DELETE /instances/:instanceId/agents/:agentId Source: Feature Inventory - API Surface (Agents API)