Tool details
| Field | Value |
|---|---|
| Name | create_agent |
| Group | Agents |
Playground
Input schema
input-schema.json
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[a-zA-Z0-9_-]+$",
"description": "Unique identifier for the record."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Human-readable name for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"model": {
"type": [
"string",
"null"
],
"description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
},
"system": {
"type": "string",
"minLength": 1,
"description": "Canonical system prompt for the agent. Set this field only."
},
"system_prompt": {
"type": "string",
"minLength": 1,
"description": "Compatibility alias for system. Omit this field when system is present."
},
"temperature": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 2,
"description": "The temperature associated with this record."
},
{
"type": "null",
"description": "Provide the temperature."
}
],
"description": "The temperature associated with this record."
},
"max_steps": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"description": "The max steps associated with this record."
},
{
"type": "null",
"description": "Provide the max steps."
}
],
"description": "The max steps associated with this record."
},
"allowed_models": {
"type": "array",
"items": {
"type": "string",
"description": "One allowed model item associated with this record."
},
"description": "AI model ids or aliases the agent may switch between. Call list_models for the accepted ids."
},
"skill_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One skill id item associated with this record."
},
"description": "The skill ids associated with this record."
},
"skill_selection": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"omitted",
"explicit"
],
"description": "The kind associated with this record."
},
"skill_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "One skill id item associated with this record."
},
"description": "The skill ids associated with this record.",
"default": []
}
},
"required": [
"kind"
],
"additionalProperties": false,
"description": "The skill selection associated with this record."
},
"tool_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One tool id item associated with this record."
},
"description": "Tool IDs attached to the record, including project-local, built-in, and integration catalog tools."
},
"provider_tool_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One provider tool id item associated with this record."
},
"description": "Provider-native model tool IDs attached to the record."
},
"suggestions": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The option 1 associated with this record."
},
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Short human-readable title for the record."
},
"prompt": {
"type": "string",
"minLength": 1,
"description": "The prompt associated with this record."
}
},
"required": [
"title",
"prompt"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this record."
}
],
"description": "One suggestion item associated with this record."
},
"description": "List of suggestions associated with this record."
},
{
"type": "null",
"description": "Provide the suggestions."
}
],
"description": "The suggestions associated with this record."
},
"avatar_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"description": "The avatar url associated with this record."
},
{
"type": "null",
"description": "Provide the avatar url."
}
],
"description": "The avatar url associated with this record."
},
"security_enabled": {
"type": "boolean",
"description": "Whether the agent default security guardrails are enabled."
},
"project_reference": {
"type": "string",
"description": "Project identifier or slug associated with the record."
},
"source_target_kind": {
"type": "string",
"description": "The source target kind associated with this record."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The target branch id associated with this record."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "The target branch id associated with this record."
}
},
"required": [
"id",
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Input schema for the create_agent tool."
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"model": {
"type": [
"string",
"null"
],
"description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
},
"system_prompt": {
"type": [
"string",
"null"
],
"description": "The system prompt associated with this record."
},
"temperature": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 2,
"description": "The temperature associated with this record."
},
{
"type": "null",
"description": "The temperature returned by the tool."
}
],
"description": "The temperature associated with this record."
},
"max_steps": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"description": "The max steps associated with this record."
},
{
"type": "null",
"description": "The max steps returned by the tool."
}
],
"description": "The max steps associated with this record."
},
"allowed_models": {
"type": "array",
"items": {
"type": "string",
"description": "One allowed model item associated with this record."
},
"description": "AI model ids or aliases the agent may switch between. Call list_models for the accepted ids."
},
"skill_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One skill id item associated with this record."
},
"description": "List of skill ids associated with this record."
},
"skill_selection": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"omitted",
"explicit"
],
"description": "The kind associated with this record."
},
"skill_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One skill id item associated with this record."
},
"description": "List of skill ids associated with this record."
}
},
"required": [
"kind",
"skill_ids"
],
"additionalProperties": false,
"description": "Structured skill selection details associated with this record."
},
"tool_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One tool id item associated with this record."
},
"description": "Tool IDs attached to the record, including project-local, built-in, and integration catalog tools."
},
"provider_tool_ids": {
"type": "array",
"items": {
"type": "string",
"description": "One provider tool id item associated with this record."
},
"description": "Provider-native model tool IDs attached to the record."
},
"suggestions": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The option 1 associated with this record."
},
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Short human-readable title for the record."
},
"prompt": {
"type": "string",
"minLength": 1,
"description": "The prompt associated with this record."
}
},
"required": [
"title",
"prompt"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this record."
}
],
"description": "One suggestion item associated with this record."
},
"description": "List of suggestions associated with this record."
},
{
"type": "null",
"description": "The suggestions returned by the tool."
}
],
"description": "List of suggestions associated with this record."
},
"security_enabled": {
"type": [
"boolean",
"null"
],
"description": "Whether the agent default security guardrails are enabled."
},
"source_path": {
"type": "string",
"description": "The source path associated with this record."
},
"source": {
"type": "string",
"description": "The source associated with this record."
},
"edit_mode": {
"type": "string",
"enum": [
"structured",
"source_only"
],
"description": "The edit mode associated with this record."
},
"source_only_reasons": {
"type": "array",
"items": {
"type": "string",
"description": "One source only reason item associated with this record."
},
"description": "List of source only reasons associated with this record."
},
"avatar_url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"description": "The avatar url associated with this record."
},
{
"type": "null",
"description": "The avatar url returned by the tool."
}
],
"description": "The avatar url associated with this record."
}
},
"required": [
"id",
"name",
"description",
"model",
"system_prompt",
"temperature",
"max_steps",
"allowed_models",
"skill_ids",
"skill_selection",
"tool_ids",
"provider_tool_ids",
"suggestions",
"security_enabled",
"source_path",
"source",
"edit_mode",
"source_only_reasons",
"avatar_url"
],
"additionalProperties": false,
"description": "Structured agent source output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}