# Create a new AI agent for an account

Creates a new AI agent with specified instructions and behavior for the account

Endpoint: POST /accounts/{accountId}/agents
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `accountId` (string, required)
    Short account ID with scd- prefix
    Example: "scd-k2j8n4m1"

## Request fields (application/json):

  - `name` (string, required)
    Name of the agent
    Example: "Document Categorization Agent"

  - `description` (string, required)
    Description of the agent's purpose
    Example: "Categorizes incoming documents according to the dataspace ontology"

  - `instructions` (string, required)
    Text instructions that act as a system prompt describing the agent's general behavior across all tasks
    Example: "You are a document categorization agent. Analyze incoming documents and categorize them according to the provided ontology. Always provide clear reasoning for your categorization decisions."

  - `defaultContext` (object,null)
    Optional default context configuration that will be pre-selected when using this agent

  - `defaultContext.libraries` (array)
    Array of library IDs to include in search context
    Example: ["01234567-89ab-cdef-0123-456789abcdef"]

  - `defaultContext.includeWebSearchResults` (boolean)
    Whether to include web search results in addition to local document search. Default is false.

## Response 201 fields (application/json):

  - `agentId` (string, required)
    The UUID of the agent
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `accountId` (string, required)
    Short account ID with scd- prefix
    Example: "scd-k2j8n4m1"

  - `name` (string, required)
    Name of the agent
    Example: "Document Categorization Agent"

  - `description` (string, required)
    Description of the agent's purpose
    Example: "Categorizes incoming documents according to the dataspace ontology"

  - `instructions` (string, required)
    Text instructions that act as a system prompt describing the agent's general behavior across all tasks
    Example: "You are a document categorization agent. Analyze incoming documents and categorize them according to the provided ontology."

  - `defaultContext` (object,null)
    Optional default context configuration that will be pre-selected when using this agent

  - `defaultContext.libraries` (array)
    Array of library IDs to include in search context
    Example: ["01234567-89ab-cdef-0123-456789abcdef"]

  - `defaultContext.includeWebSearchResults` (boolean)
    Whether to include web search results in addition to local document search. Default is false.

  - `createdBy` (string, required)
    ID of the user that created the agent
    Example: "123e4567-e89b-12d3-a456-426614174001"

  - `createdAt` (string, required)
    Example: "2024-01-15T10:30:00Z"

  - `lastUpdatedAt` (string,null, required)
    Example: "2024-01-15T14:30:00Z"


## Response 400 fields

## Response 404 fields