Sign in

v10

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-0582185581.9 KB
Agents

Create agent

Create a new custom AI agent.

Overview: Agents are specialized AI assistants configured for specific tasks. They can have custom system prompts, access to specific tools, and be limited to certain knowledge bases.

Agent Configuration:

  • System prompt: Instructions that define agent behavior
  • Tools: Capabilities like web search, code execution, etc.
  • Knowledge bases: Data sources the agent can access
  • Model config: AI model settings (temperature, max tokens)

Use Cases:

  • Customer support bot with product knowledge
  • Code review assistant with repository access
  • HR assistant with policy documents
post/agents/create

Request body

namestring required

Agent display name

descriptionstring

What the agent does

startMessagestring

Initial greeting shown when conversation starts

systemPromptstring

System instructions for the agent

instructionsstring

Additional agent execution instructions

tagsstring[]
shareWithOrgboolean

Share agent with the organization

isServiceAccountboolean

Create the agent as a service-account agent

Example request

{
  "name": "Product Support Agent"
}

Response

Agent created

status'success' | 'partial_success' required
messagestring required