Requests & TicketsAI Employee Agents

createAiAgent

View as Markdown

Create an AI Employee agent.

Creates a new AI Employee agent with an initial DRAFT version. Lifecycle:

  1. Call publishAiAgent(agentId) after creation or draft updates

Parameters

NameTypeRequiredDescription
agent_typeobjectNo
agent_subtypeobjectNo
namestringYes
descriptionstringNo
prompt_configobjectNo
toolsAgentToolDto[]No
skill_idsinteger[]No
skills_inlineInlineSkillDto[]NoAgent-owned inline skills. Full-array replacement semantics.
capabilitiesstringYesFree-form description of what the agent can do; seeds future identity/goal generation. Versioned. Required and non-empty
adapter_typeobjectNo
adapter_config_templateobjectNoPer-adapter free-form configuration template. Snapshotted into each AA run’s adapter_config
max_concurrent_runsintegerNoPer-agent concurrency cap. Omitted or explicit-null → leave the column NULL; the drainer
workspace_idsinteger[]NoWorkspaces to add the agent’s shadow user to. Live-write to workspace_members in the same
manager_user_idintegerNoReporting manager for the agent’s shadow user. Live-write to User.manager. Null →
iconobjectNo