Skip to main content
Version: 8.3

Develop Creatio.ai Agent

Level: beginner

This article explains how to create a new AI Agent in Creatio step by step.

Example

Create an agent that manages product catalog data.

Step 1. Fill out the main agent information

  1. Click btn_system_designer.png to Open the System Designer.

  2. Go to the System setup block → Creatio.ai agents.

  3. Click New. This opens a page.

  4. Fill out the main agent information.

    Field

    Field value

    Name

    Human-readable name for your agent. We recommend using short and clear names that reflect the main goal of the agent. For example, "Product Catalog Agent."

    Code

    Technical code used by Creatio and the LLM (large language model). Must start with the "Usr" prefix, for example, "UsrCatalogAgent."

    Description

    Detailed plain text description of what the agent does, when to use it, and how it behaves. The LLM uses this description to invoke the agent correctly, so make sure it is complete and precise. For example, "Manage the product catalog: add descriptions, update information, analyze sales data by products, and ensure relevance."

    Status

    Whether the agent is active. Available values:

    • Active: the agent is active and available to all users.
    • In development: the agent is in development and available only to users that have the CanDevelopAISkills operation permission. The permission must be added to Creatio manually.
    • Deactivated: the agent is disabled and not used by Creatio.

    Role

    Role of the agent in Creatio. Also mention any knowledge the agent has in a particular area. For example, "Act as skilled AI Agent specialized in product management. Have a high level of understanding the catalog structure, business rules, and sales logic."

    Agent instructions

    Key interaction rules, response style (formal, informal), and core principles of the agent. If the agent follows a specific flow or logic, describe it here. For example,

    "Your responsibilities include:

    • Creating and updating product descriptions Trigger this task when a user adds a new product or requests changes to an existing product. Ensure the description is accurate, relevant, and reflects updated functionality or positioning. Always write in a clear, engaging style.

    • Deactivating products Offer to deactivate a product if it is discontinued, permanently out of stock, outdated, or consistently underperforming with no improvement forecast. Confirm the user’s intention before proceeding.

    • Analyzing product sales When asked, retrieve and analyze sales data for specific products over a given timeframe. Summarize trends and suggest actionable insights, for example, promote bestsellers, revise pricing on low-performers.

    • Structuring product data Assist in categorizing, tagging, and organizing product attributes to improve searchability and reporting accuracy. Identify and flag missing or inconsistent fields.

    Maintain a consistent and structured tone throughout your outputs. Ask clarifying questions when needed and never assume intent without user confirmation."

    Limitations and restrictions

    Define what the agent must not do, which behaviors to avoid, and whether it has any constraints on actions or topics. For example, "Always use polite, helpful, and professional language. All product descriptions and content must be tailored to a tech-savvy audience aged 25–45, interested in innovation and modern digital experiences. Follow the brand’s tone of voice: friendly, knowledgeable, concise."

  5. Click Save.

As a result, Creatio will add a new AI agent. Process to step 2.

Step 2. Add AI Skills to the agent

Specify which skills the agent can use in the AI Skills expanded list. You can create a new AI Skill directly from this section or add an existing skill by selecting it from the list. Learn more about developing AI Skills: Develop Creatio.ai Skill.

Step 3. Add AI Actions to the agent

Define the actions available to this agent in the AI Actions expanded list. Actions determine the specific operations the agent can perform in response to user requests. You can create a new action directly from the agent page if needed or select from existing actions. The agent can use system actions that are available for any agent or skill but cannot be added to skills or agents manually. Learn more: Creatio.ai system actions.

Step 4. Add attachments to the agent

AI Agent can read the context and content of attached files. It can use this information to generate more accurate responses to user questions. Specify which file types the agent can work with in the Attachments expanded list. Supported file extensions: txt, docx, pdf, htm, css, scss, json, xhtml, md, tex, csv, tsv, log, sql, cs, ts, yaml, yml.


See also

Creatio.ai overview

Creatio.ai architecture

Creatio.ai system actions

Introduction to AI Agents

AI Agent list

Data privacy in Creatio.ai

Creatio AI (developer documentation)