AgentResponse

Data returned for Agent. Required fields are id, name, category, description, item.

idId (string)필수

Server-assigned unique identifier

nameName (string)필수

Resource name

alias object

Display name shown to users.

하나 이상(anyOf)

• string
• null

string

categoryCategory (string)필수

Resource type tag

type object

Subtype within category

하나 이상(anyOf)

• string
• null

string

collection_id object

Parent collection ID

하나 이상(anyOf)

• string
• null

string

folder_id object

Identifier of the containing folder.

하나 이상(anyOf)

• string
• null

string

tags object

Classification labels

하나 이상(anyOf)

• string[]
• null

Array [

string

]

descriptionDescription (string)필수

markingsstring[]

Mandatory marking ids this resource requires; read-only — set via the marking guard endpoints, not Create/PATCH.

기본값: []

created_at object

Creation timestamp (Unix ms)

하나 이상(anyOf)

• integer
• null

integer

updated_at object

Last update timestamp (Unix ms)

하나 이상(anyOf)

• integer
• null

integer

owners object[]

Users and groups that own the resource.

Array [

idId (string)필수

"user." | "group." | "public.all"

typeType (string)필수

Possible values: [user, group, public]

display_nameDisplay Name (string)필수

avatar_url object

하나 이상(anyOf)

• string
• null

string

avatar_config object

하나 이상(anyOf)

• object
• null

object

email object

하나 이상(anyOf)

• string<email>
• null

string<email>

]

my_share_scope object

How the current caller received access to the resource.

하나 이상(anyOf)

• string
• null

string

Possible values: [owner, grant, admin]

input_modeInput Mode (string)

Possible values: [chat, event]

기본값: chat

modeMode (string)

Possible values: [react, workflow]

기본값: react

agent object

하나 이상(anyOf)

• AgentNodeConfig
• null

instructionsInstructions (string)필수

Agent system instructions

prompts object[]

Reusable Prompt references. Rendered in list order and joined with '\n\n' as the system prefix; inline instructions is appended as a suffix. Empty = inline instructions only.

Array [

prompt_idPrompt Id (string)필수

variables object

{{var}} bindings for the referenced Prompt

하나 이상(anyOf)

• object
• null

object

]

model_providerModel Provider (string)필수

LLM provider name

modelModel (string)필수

LLM model name

tools object[]

Available tools

Array [

하나 이상(anyOf)

• string
• AgentResourceRef
• AgentToolConfig
• object

string

]

actors object[]

Array [

하나 이상(anyOf)

• string
• AgentResourceRef
• AgentActorConfig
• object

string

]

roles object[]

Array [

하나 이상(anyOf)

• string
• AgentResourceRef
• object

string

]

outputs object

하나 이상(anyOf)

• object
• null

object

max_iterationsMax Iterations (integer)

Maximum iteration count

기본값: 50

max_input_tokens object

Maximum input-token budget for the system prompt and conversation history before each model call. The effective limit cannot exceed the selected model's context_window; null uses the D.Hub default.

하나 이상(anyOf)

• integer
• null

integer

Possible values: >= 1

compaction object

Optional per-agent conversation compaction settings. Omit this field to use D.Hub defaults.

하나 이상(anyOf)

• AgentCompaction
• null

enabled object

Whether conversation compaction is enabled for the agent.

하나 이상(anyOf)

• boolean
• null

boolean

trigger_ratio object

Fraction of the input-token budget that triggers compaction.

하나 이상(anyOf)

• number
• null

number

Possible values: > 0 and < 1

target_ratio object

Fraction of the input-token budget targeted after compaction. It must be lower than trigger_ratio.

하나 이상(anyOf)

• number
• null

number

Possible values: > 0 and < 1

summary_max_tokens object

Maximum number of tokens allowed in the generated compaction summary.

하나 이상(anyOf)

• integer
• null

integer

Possible values: >= 128 and <= 8192

options object

하나 이상(anyOf)

• object
• null

object

reasoning_effort object

Default reasoning effort for this agent. A value supplied with an individual request takes precedence; null uses the selected model's default.

하나 이상(anyOf)

• string
• null

string

Possible values: [none, minimal, low, medium, high, xhigh, max]

nodes object[]

Array [

다음 중 하나(oneOf)

• StartWorkflowNode
• EndWorkflowNode
• LLMWorkflowNode
• ToolCallWorkflowNode
• ActorCallWorkflowNode
• IfElseWorkflowNode
• LoopWorkflowNode
• ParallelWorkflowNode
• HumanInputWorkflowNode
• ErrorHandlerWorkflowNode
• CodeWorkflowNode
• TemplateWorkflowNode
• VariableWorkflowNode

idId (string)필수

Unique node ID

typeType (string)필수

Node type

상수 값: start

config object필수

Type-specific node configuration

variables object[]

Array [

nameName (string)필수

typeType (string)필수

Possible values: [string, number, boolean, object, array]

requiredRequired (boolean)

기본값: true

defaultDefault

descriptionDescription (string)

기본값:

]

metadata object

property name*any

기본값: {}

]

edges object[]

Array [

sourceSource (string)필수

Source node ID

targetTarget (string)필수

Target node ID

condition object

Condition expression (unconditional if omitted)

하나 이상(anyOf)

• string
• null

string

]

tablesstring[]

기본값: []

templatesstring[]

기본값: []

ontologiesstring[]

기본값: []

conversations object[]

Array [

nameName (string)필수

typeType (string)필수

Possible values: [string, number, boolean, array, object]

descriptionDescription (string)필수

defaultDefault

]

options object

하나 이상(anyOf)

• object
• null

object

is_builtinIs Builtin (boolean)

Whether this is a platform-shipped built-in agent

기본값: false

itemItem (string)필수사용 중단

AgentResponse

{
  "id": "string",
  "name": "string",
  "alias": "string",
  "category": "string",
  "type": "string",
  "collection_id": "string",
  "folder_id": "string",
  "tags": [
    "string"
  ],
  "description": "string",
  "markings": [
    "string"
  ],
  "created_at": 0,
  "updated_at": 0,
  "owners": [
    {
      "id": "string",
      "type": "user",
      "display_name": "string",
      "avatar_url": "string",
      "avatar_config": {},
      "email": "user@example.com"
    }
  ],
  "my_share_scope": "owner",
  "input_mode": "chat",
  "mode": "react",
  "agent": {
    "instructions": "string",
    "prompts": [
      {
        "prompt_id": "string",
        "variables": {}
      }
    ],
    "model_provider": "string",
    "model": "string",
    "tools": [
      "string",
      {
        "id": "string",
        "name": "string"
      },
      {
        "name": "string",
        "description": "",
        "type": "python",
        "function": {
          "source": "string",
          "inputs": {},
          "outputs": {},
          "dependencies": [
            "string"
          ],
          "decorators": [
            {
              "decorator": "string",
              "name": "string",
              "arguments": {}
            }
          ]
        },
        "require_browser": false,
        "options": {}
      },
      {}
    ],
    "actors": [
      "string",
      {
        "id": "string",
        "name": "string"
      },
      {
        "name": "string",
        "description": "",
        "function": {
          "source": "string",
          "inputs": {},
          "outputs": {},
          "dependencies": [
            "string"
          ],
          "decorators": [
            {
              "decorator": "string",
              "name": "string",
              "arguments": {}
            }
          ]
        },
        "confirmation_policy": "confirm",
        "options": {}
      },
      {}
    ],
    "roles": [
      "string",
      {
        "id": "string",
        "name": "string"
      },
      {}
    ],
    "outputs": {},
    "max_iterations": 50,
    "max_input_tokens": 0,
    "compaction": {
      "enabled": true,
      "trigger_ratio": 0,
      "target_ratio": 0,
      "summary_max_tokens": 0
    },
    "options": {},
    "reasoning_effort": "none"
  },
  "nodes": [
    {
      "id": "string",
      "type": "start",
      "config": {
        "variables": [
          {
            "name": "string",
            "type": "string",
            "required": true,
            "description": ""
          }
        ]
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "end",
      "config": {
        "outputs": [
          {
            "name": "string",
            "type": "string",
            "value": "string"
          }
        ]
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "llm",
      "config": {
        "model_provider": "string",
        "model": "string",
        "prompt": "string",
        "system_prompt": "",
        "reasoning_effort": "none",
        "output": "llm_output",
        "response": {}
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "tool_call",
      "config": {
        "tool": {
          "name": "string",
          "description": "",
          "type": "python",
          "function": {
            "source": "string",
            "inputs": {},
            "outputs": {},
            "dependencies": [
              "string"
            ],
            "decorators": [
              {
                "decorator": "string",
                "name": "string",
                "arguments": {}
              }
            ]
          },
          "require_browser": false,
          "options": {}
        },
        "input_mappings": {},
        "outputs": {},
        "timeout": 30
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "actor_call",
      "config": {
        "actor": {
          "name": "string",
          "description": "",
          "function": {
            "source": "string",
            "inputs": {},
            "outputs": {},
            "dependencies": [
              "string"
            ],
            "decorators": [
              {
                "decorator": "string",
                "name": "string",
                "arguments": {}
              }
            ]
          },
          "confirmation_policy": "confirm",
          "options": {}
        },
        "input_mappings": {},
        "outputs": {},
        "timeout": 30
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "if_else",
      "config": {
        "condition": "string"
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "loop",
      "config": {
        "mode": "list",
        "source": "string",
        "iterator": "item",
        "count": 0,
        "counter": "index",
        "max_iterations": 100,
        "body_node_ids": [
          "string"
        ]
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "parallel",
      "config": {
        "branches": [
          {
            "id": "string",
            "node_ids": [
              "string"
            ]
          }
        ],
        "join_strategy": "all",
        "timeout": 300
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "human_input",
      "config": {
        "prompt": "string",
        "input_fields": [
          {
            "name": "string",
            "type": "string",
            "description": "",
            "required": true,
            "options": [
              "string"
            ]
          }
        ],
        "timeout": 86400,
        "assignees": [
          "string"
        ],
        "on_timeout": "error"
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "error_handler",
      "config": {
        "target_node_id": "string",
        "retry_count": 0,
        "retry_delay_seconds": 5,
        "retry_backoff": "fixed",
        "on_error": "fallback",
        "fallback_node_id": "string"
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "code",
      "config": {
        "language": "python",
        "source": "string",
        "input_mappings": {},
        "outputs": {},
        "timeout": 30,
        "dependencies": [
          "string"
        ]
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "template",
      "config": {
        "template": "string",
        "output": "text"
      },
      "metadata": {}
    },
    {
      "id": "string",
      "type": "variable",
      "config": {
        "operations": [
          {
            "action": "set",
            "variable": "string"
          }
        ]
      },
      "metadata": {}
    }
  ],
  "edges": [
    {
      "source": "string",
      "target": "string",
      "condition": "string"
    }
  ],
  "tables": [
    "string"
  ],
  "templates": [
    "string"
  ],
  "ontologies": [
    "string"
  ],
  "conversations": [
    {
      "name": "string",
      "type": "string",
      "description": "string"
    }
  ],
  "options": {},
  "is_builtin": false
}