Agents

Step-by-step guide to configure ATG agents: name, instructions, tools, knowledge categories, and testing in the Playground.

2 min read

ATG Embedded agents are intelligent assistants tailored to your exact needs. This guide walks you through configuring these agents to perfectly align with your vision.

✨ Creating a New Agent

From the Admin Console, navigate to "Agents" and create a new agent with:

  • 🏷️ Agent Name: A clear, descriptive name for easy identification
  • 📝 Description (Optional): A brief summary of the agent's purpose
  • 🎯 Specific Instructions (Important): This is where you define your agent's personality and behavior. Specify what the agent should do and not do, how it should guide users, its tone, and its operational guidelines. These instructions are crucial for creating a truly effective agent

🔧 Configuring an Agent

Select an agent from "Your Agents" to access its configuration tabs.

⚙️ Configuration Tab

Manage core settings and operational status:

  • Agent Name & Description: Update identity and purpose
  • Specific Instructions (Key Setting): This is the most important configuration for your agent. Define precisely what your agent should and shouldn't do, how it guides users, its personality, tone, and behavioral rules. Well-crafted instructions are essential for an effective agent
  • AI Policy: see AI Policy for more information
  • Active: Toggle to activate or deactivate your agent

Configuration tab in Agents Admin ConsoleConfiguration tab in Agents Admin Console

Configuration tab in Agents Admin Console

📚 Knowledge Tab

Link your agent to relevant knowledge categories. Select which knowledge categories your agent can access to provide accurate, contextually relevant answers. See Knowledge for more information about this crucial step.

Knowledge tab in Agents Admin ConsoleKnowledge tab in Agents Admin Console

Knowledge tab in Agents Admin Console

📚 Managing Sources Visibility

The Sources tab lets you control where your agent can retrieve information from.

Sources tab in Agents Admin ConsoleSources tab in Agents Admin Console

Sources tab in Agents Admin Console

What you can manage

  • You can check which sources are enabled for the agent (documents, connectors, websites, databases, etc.).
  • You can configure how sources are shown to end users
    • For each source, choose whether references are shown or hidden.

Helpful tools in this tab

  • Search & filters to quickly find a source (by type or connector).
  • Web sources: URLs are normalized/mapped so links point to the right live pages.

🛠️ Tools Tab

Enable tools to transform your agent into a dynamic problem-solver. Available tools include web search, knowledge base search, document retrieval, image generation, and more. Select the tools your agent needs to perform its role effectively. See Tools and MCP for more information.

Tools tab in Agents Admin ConsoleTools tab in Agents Admin Console

Tools tab in Agents Admin Console

🔒 Security Tab

Control access and ensure secure operation:

  • JWT Authentication: Require signed JWTs for each chat session
  • Domain Whitelist: Specify approved domains for embedding (comma-separated)
  • JWT Keys: Manage public keys for JWT verification

Security tab in Agents Admin ConsoleSecurity tab in Agents Admin Console

Security tab in Agents Admin Console

💻 Embed Code Tab

Access the code snippets to integrate your agent into your website or application. The tab provides:

  • Agent UID: Your unique agent identifier
  • JS Code: Implementation code with or without JWT authentication, including all necessary steps to load and configure the widget

See Integrate in your webapp for the integration process of ATG in your webapp.