Agent Configuration

The Agent Configuration defines the core behavior, capabilities, and operational mode of an AI agent. It specifies which LLM model powers the agent and what business services are enabled.

Schema: AgentConfigurationSchema Source: src/core/service-configuration/agent-config.schema.ts

---

Attributes

Attribute	Type	Required	Default	Description
id	string	—	—	Unique identifier for the agent configuration
name	string	Yes	—	Personal name for the agent (max 30 characters, e.g., 'Sarah', 'James')
description	string	No	—	Description of the agent's purpose and capabilities
modelId	string	Yes	—	WIIL Platform model ID from the support registry
operationalMode	enum	No	AUTONOMOUS	How the agent operates. One of AUTONOMOUS, ASSISTED, or HYBRID.
capabilities	array<enum>	No	[]	Platform services enabled for this agent. Values: APPOINTMENT_BOOKING, ORDER_MANAGEMENT, CUSTOMER_LOOKUP, PAYMENT_PROCESSING.
call_transfer_config	array<CallTransferConfig>	No	[]	Call transfer rules for escalation
temperature	number	No	0.7	LLM temperature (0.0-2.0) for response variability
max_tokens	number	No	4096	Maximum tokens in agent responses
metadata	object	No	—	Additional custom metadata
createdAt	number	—	—	Unix timestamp when created
updatedAt	number	—	—	Unix timestamp when last updated

---

Example

{
  "id": "agent_abc123",
  "name": "Sarah",
  "description": "Customer support agent for sales inquiries",
  "modelId": "YUSI21217J1",
  "operationalMode": "AUTONOMOUS",
  "capabilities": ["APPOINTMENT_BOOKING", "CUSTOMER_LOOKUP"],
  "call_transfer_config": [
    {
      "transfer_number": "+15551234567",
      "transfer_type": "warm",
      "transfer_conditions": ["speak to manager", "escalate"]
    }
  ],
  "temperature": 0.7,
  "max_tokens": 4096,
  "createdAt": 1709856000000,
  "updatedAt": 1709856000000
}

---

Create / Update Schemas

Schema	Description	Omits
CreateAgentConfigurationSchema	For creating agents	id, createdAt, updatedAt
UpdateAgentConfigurationSchema	For partial updates	All fields optional except id

---

Related

• Instruction Configuration - Behavioral guidelines for agents
• Deployment Configuration - Uses agent configuration for deployments
• Support LLM - Model registry referenced by modelId