Ejento APIs
V2 Legacy
  • Stable
  • V2
  • V2 Legacy
  1. Agent
Ejento APIs
V2 Legacy
  • Stable
  • V2
  • V2 Legacy
  • Overview
  • Endpoints
    • Agent
      • Create Agent By Agent Builder
        POST
      • Create Agent By Configure
        POST
      • Get All Agents
        GET
      • Get Agent By Team
        GET
      • Get Agent By User Team
        GET
      • Agent Filtered
        GET
      • Get Agent
        GET
      • Edit Agent
        PUT
      • Get Recent Agents
        GET
      • Create Recent Agent
        POST
      • Delete Recent Agent
        DELETE
      • Get Starred Agents
        GET
      • Create Starred Agent
        POST
      • Delete Starred Agent
        DELETE
    • Agent Corpus Connection
      • Create Agent Corpus Connection
      • Get Agent Corpus Connection
      • Edit Agent Corpus Connection
      • Delete Agent Corpus Connection
      • Get All Agent Corpus Connections
      • Delete All Agent Corpus Connections
    • Agent Response
      • Create Agent Response
      • Get All Agent Responses
      • Get Agent Responses By User
      • Get Agent Responses By Project
      • Get Agent Responses By Chat Thread
      • Get Agent Response
      • Delete Agent Response
      • Create Agent Response Comment
      • Get Agent Response Comment
      • Get Agent Response Dashboard
      • Create Agent Response Feedback
      • Create Agent Response Log
      • Pin Agent Response
      • Unpin Agent Response
      • Get Pinned Agent Responses
    • Agent Reviews
      • Create Review
      • Get All Reviews
      • Get Reviews by Agent
      • Delete Review
    • Agent Rating
      • Get All Agent Ratings
      • Get Agent Rating
      • Update Agent Rating
    • Agent Alias
      • Get All Agent Aliases
      • Create Agent Alias
      • Update Agent Alias
      • Delete Agent Alias
    • Agent Access
      • Get Agent Access
      • Update Agent Access
    • Agent Type
      • Get All Agent Types
      • Get Agent Type
      • Update Agent Type
    • Agent User
      • Add Users to Agent
      • Get Users Of Agent
      • Delete User from Agent
      • Get User Agent Permission
      • Get All Agents with Users
    • Agent Tags
      • Get All Distinct Agent Tags
      • Annotate an Agent with Tags
    • Agent Vote
      • Create Agent Vote
      • Get Agent Vote
    • Agent Comment
      • Create Comment on an Agent
      • Get Comments for an Agent
      • Edit Agent Comment
    • Chat Thread
      • Create Chat Thread
      • Get All Chat Threads Of An Agent
      • Get All Chat Threads With Admin Panel Filters And Pagination
      • Get Reduced Chatlogs by Thread ID for Admin Panel
      • Get Chat Thread
      • Edit Chat Thread
      • Delete Chat Thread
      • Add ChatThread-Corpus Connection
      • Get ChatThread-Corpus Connection
      • Delete ChatThread-Corpus Connection
    • Project
      • Create Project
      • Get All Projects
      • Project Filtered
      • Get All Agents Of Project
      • Get All Projects By Team
      • Get Project
      • Edit Project
      • Delete Project
      • Fetch Project Details
      • Add Recent Project
      • Get Recent Projects
    • User Project
      • Add Users To Project
      • Get All Projects By User Teams
      • Get Projects By User and Team
      • Delete Users from Project
    • Document
      • Get Document
      • Edit Document
      • Add Or Remove Tags On Document
      • Document Polling
      • Trigger a refresh(reindex) of a Document
    • Corpus
      • Create Corpus
      • Get All Corpus
      • Get Corpus
      • Edit Corpus
      • Delete Corpus
      • Create Document In Corpus
      • Get All Documents From Corpus
      • Delete Document(s) from Corpus
      • Check Duplicate Documents
      • Get All Agents By Corpus
      • Get Corpus Permissions
      • Get Corpus Permission By User
      • Annotate Corpus
      • Trigger a refresh(reindex) of a Corpus
    • Notification
      • Create Notification
      • Retrieve All Notifications
      • Read Notifications By User ID
      • Retrieve Notification
      • Read Notification
      • Delete Notification
    • Feature Flag
      • Get All Feature Flags
      • Get DALL-E Feature Flag
      • Get Share Agent Feature Flag
      • Get Agent Alias Feature Flag
      • Get SharePoint Index Feature Flag
      • Get Chat Agent Creation Feature Flag
      • Get OAuth Feature Flags
      • Get Google OAuth Feature Flag
      • Get LinkedIn OAuth Feature Flag
      • Get MS SSO OAuth Feature Flag
      • Get Github OAuth Feature Flag
    • Team
      • Create Team
      • Get All Teams
      • Get Team Details
      • Edit Team
      • Delete Team
      • Create Recent Team
      • Get Recent Teams
      • Add Users to Team
      • Get Users in a Team
      • Get Teams Of User
      • Get User Role By Team
      • Get Agents Of User Team
      • Get Projects And Team
    • User
      • Create User In Organization
      • Get All Users By Organization
      • Get User
      • Edit User
      • Delete User
      • Batch Delete Users
      • User Filtered
      • Create User Permission
      • Get User Permission
      • Edit User Permission
      • Delete User Permission
    • Email Indexing Authorization
      • Email Authorize
    • Conversation Starters
      • Create Conversation Starter
      • Get Conversation Starters
    • Tool
      • Create Tool
      • Get All Tools
      • Get Tool
      • Edit Tool
      • Delete Tool
    • Agent Tool Connection
      • Enable Agent Tool
      • Get All Agent Tools
      • Disable Agent Tool
    • Organization Tool
      • Enable Organization Tool
    • API Tool Template
      • Create API Tool Template
      • Get All API Tool Templates
    • LLM Config
      • Get All LLM Configs
      • Get Active Config
      • Get LLM Config
      • Get Model Deployment
      • Get Org Configs
      • Set Agent Config View
  1. Agent

Create Agent By Agent Builder

POST
/v2/api/agent/agentbuilder
The Create Agent by Agent Builder API endpoint allows users to create an AI-powered agent with specific configurations, project associations, and behavioral settings. This API is useful for building and managing virtual assistants tailored for various domains.

How It Works#

1.
The system validates the input and processes the agent configuration.
2.
Upon success, a new agent is created, and a response with its unique agent_id and details is returned.
3.
The created agent is automatically linked to the specified project for easier management.

Step-by-Step Guide to Creating an Agent#

To follow a detailed, step-by-step guide on how to create an agent, visit:
Create Agent by Agent Builder Guide
For more detailed information about agent, refer to the Agent Guide.
📝 Note: "Assistant" is another name for "Agent".

Request Body Details#

Basic Agent Information
agent_id (integer, required): Unique identifier for the agent.
Example: 1297
project_id (integer, required): ID of the project to which the agent belongs.
Example: 254
history (string, optional): Background information or previous interactions related to the agent.
Example: "I am history"
Configuration Flags
flags (object, optional): Configuration options for the agent.
image_generation_enabled (boolean): Specifies if the agent supports image generation.
Example: true

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Agent chat created successfully.
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https:///v2/api/agent/agentbuilder' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_id": 1297,
    "project_id": 254,
    "history": "i am history",
    "flags": {
        "image_generation_enabled": true
    }
}'
Response Response Example
{
    "success": true,
    "message": "Agent chat created successfully",
    "data": {
        "id": 1297,
        "agent_type": {
            "id": 1,
            "created_by": "System",
            "created_on": "2024-04-17T23:10:22.313394Z",
            "modified_by": "[email protected]",
            "modified_on": "2024-04-17T23:10:22.313414Z",
            "name": "QnA",
            "description": ""
        },
        "instructions": [
            {
                "id": 10611,
                "instruction": "",
                "is_deleted": false,
                "created_by": "[email protected]",
                "created_on": "2025-01-29T17:23:00.550155Z",
                "agent": 1297
            }
        ],
        "user": {
            "id": 147,
            "email": "[email protected]",
            "first_name": "User",
            "last_name": "User",
            "organization": 1
        },
        "connected_tool_names": [
            [
                "Rag Tool",
                "Attachment Tool"
            ]
        ],
        "agent_name": "FC Barcelona Info Assistant",
        "industry_area": "",
        "domain": "Your go-to assistant for everything related to FC Barcelona! Get real-time updates, match details, player stats, transfer news, and historical insights about the club",
        "sample_q1": "",
        "sample_q2": "",
        "sample_q3": "",
        "prefix_prompt": "",
        "alias": "[email protected]",
        "is_active": false,
        "is_deleted": false,
        "created_by": "[email protected]",
        "created_on": "2025-01-29T17:23:00.299537Z",
        "agent_image": "[object Object]",
        "access": "Public",
        "status": "Live",
        "caching_enabled": false,
        "chunk_count": 32,
        "react_enabled": true,
        "react_max_iteration_count": 50,
        "project": 254,
        "llm_config": 8,
        "cloned_from": null
    }
}
Previous
Overview
Next
Create Agent By Configure
Built with