Tool details
| Field | Value |
|---|---|
| Name | upsert_child_agent_run |
| Group | Conversations |
Playground
Input schema
input-schema.json
{
"type": "object",
"properties": {
"parent_run_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Provide the parent run id."
},
"tool_call_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Tool call identifier that links this request to a prior tool invocation."
},
"request": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"description": "Provide the prompt."
},
"task_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
"description": "Provide the task id."
},
"context_mode": {
"type": "string",
"enum": [
"continue",
"fresh"
],
"description": "Provide the context mode."
},
"idempotency_scope": {
"type": "string",
"enum": [
"durable_task"
],
"description": "Provide the idempotency scope."
},
"context": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Provide the context.",
"default": {}
},
"evidence_refs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier for the target record."
},
"run_id": {
"type": "string",
"minLength": 1,
"description": "Run identifier that scopes the request."
},
"message_id": {
"type": "string",
"minLength": 1,
"description": "Provide the message id."
},
"tool_call_id": {
"type": "string",
"minLength": 1,
"description": "Tool call identifier that links this request to a prior tool invocation."
},
"result_path": {
"type": "string",
"minLength": 1,
"description": "Provide the result path."
},
"label": {
"type": "string",
"minLength": 1,
"description": "Provide the label."
},
"summary": {
"type": "string",
"minLength": 1,
"description": "Provide the summary."
}
},
"additionalProperties": true,
"description": "One evidence ref item supplied to the tool."
},
"maxItems": 50,
"description": "Provide the evidence refs."
},
"description": {
"type": "string",
"minLength": 1,
"description": "Human-readable description that clarifies the request."
},
"agent_id": {
"type": "string",
"minLength": 1,
"description": "Provide the agent id."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier for the target project."
},
"runtime_target_kind": {
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "Provide the runtime target kind."
},
"target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target environment id."
},
{
"type": "null",
"description": "Provide the target environment id."
}
],
"description": "Provide the target environment id."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Provide the target branch id."
},
"source_target_kind": {
"type": "string",
"enum": [
"project",
"main_branch",
"environment",
"preview_branch"
],
"description": "Provide the source target kind."
},
"allow_delegation": {
"type": "boolean",
"description": "Provide the allow delegation."
},
"tools": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "One tool item supplied to the tool."
},
"maxItems": 500,
"description": "Provide the tools."
},
"model": {
"type": "string",
"minLength": 1,
"description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
},
"thinking": {
"anyOf": [
{
"type": "boolean",
"const": false,
"description": "Provide the option 1."
},
{
"type": "integer",
"exclusiveMinimum": 0,
"description": "Provide the option 2."
}
],
"description": "Provide the thinking."
},
"max_steps": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Provide the max steps."
}
},
"additionalProperties": true,
"description": "Structured request details used by the tool."
}
},
"required": [
"parent_run_id",
"tool_call_id",
"request"
],
"additionalProperties": false,
"description": "Input schema for the upsert_child_agent_run tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"child_conversation_id": {
"type": "string",
"format": "uuid",
"description": "The child conversation id associated with this tool result."
},
"child_run_id": {
"type": "string",
"minLength": 1,
"description": "The child run id associated with this tool result."
},
"child_message_id": {
"type": "string",
"format": "uuid",
"description": "The child message id associated with this tool result."
},
"agent_id": {
"type": "string",
"minLength": 1,
"description": "The agent id associated with this tool result."
},
"duplicate": {
"type": "boolean",
"description": "Whether the submitted response duplicated an existing response."
}
},
"required": [
"child_conversation_id",
"child_run_id",
"child_message_id",
"agent_id",
"duplicate"
],
"additionalProperties": false,
"description": "Structured result returned by the upsert_child_agent_run tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}