Documentation
Core Concept

Agents

Configuring personas, behavior guidelines, and tracing decisions.

System instructions#

System instructions serve as the primary set of rules governing your agent's behavior. They define:

  • Persona & Tone: Instructing the agent to speak professionally, concisely, or with a helpful customer support demeanor.
  • Scope & Boundaries: Setting guidelines on what topics the agent is authorized to speak on, and how to handle off-topic inquiries.
  • Workflow Guidelines: Providing specific procedures, such as verifying order details before discussing refund options.

Starter suggestions#

Starter suggestions guide users to launch conversations. These appear as clickable prompt chips in the web widget when users first open it. Examples include:

  • "How do I rotate API keys?"
  • "What is your return policy?"
  • "Track my order"

Suggestions reduce friction and guide users to common, automated answers.

Playground testing#

Playground testing allows simulating customer questions and verifying responses in a test environment. During testing, you can:

  • Verify which sources were retrieved and referenced for the answers.
  • Refine guidelines and instructions based on real-time feedback.
  • Inspect agent decisions step-by-step.

Conversation trace#

To understand how your agent operates and verify accuracy, trained.chat provides a detailed conversation trace. For every message processed, you can inspect:

  • User Question: The query analyzed by the agent to understand intent.
  • Knowledge Sources Used: The exact fragments of documents and pages retrieved from the knowledge base.
  • Actions Executed: The APIs triggered, parameters parsed, and responses returned.
  • Response Time: The latency profile of each step in the agent's decision loop.