OneShotInteractionCreateRequest

Creates a one-shot interaction: one agent takes the task and gives its answer.

Kind: an object, used in requests.

Fields

Field	Type	Required	Description
`agent`	`InteractionAgentBindingInput`	yes	The agent that takes the task. Constraints: required (empty or whitespace-only strings are rejected).
`name`	`string`	yes	The interaction’s name, unique within its namespace. Constraints: maxLength: 150, required (empty or whitespace-only strings are rejected).
`prompt`	`string`	yes	What the agents are asked to do. A run’s inputs are filled in wherever it says `%%name%%`. Constraints: minLength: 3, required (empty or whitespace-only strings are rejected).
`solutionSchema`	`string \| null`		The JSON Schema the answer must match, as JSON text: the run’s output is then JSON of that shape. Null: the output is free text.
`systemPromptMode`	`InteractionSystemPromptMode`	yes	How `systemPrompts` combine with the instructions Maitento gives every agent. Constraints: required (empty or whitespace-only strings are rejected).
`systemPrompts`	`string[]`	yes	Extra system instructions for every agent in the interaction. Constraints: required (empty or whitespace-only strings are rejected).
`durationWarningToAi`	`timespan \| null`		How long into a run the agents are told that time is running short. Null: they are not told.
`durationAutoTermination`	`timespan \| null`		The longest a run may take. The run stops with an error when it is reached; time spent waiting for a person does not count. Null: no limit.
`contextSettings`	`InteractionContextSettingsInput\| null`		How the conversation is kept within the model’s context window, and how many rounds of tool calls an agent may make in one turn. Null: the defaults.
`swarm`	`InteractionSwarmSettingsInput\| null`		The sub-interactions its participants may start. Null: none.
`credentialStack`	`string \| null`		The credential stack its runs use, by id or name, when their start doesn’t name one. Null: the namespace’s default stack, then your tenant’s. A stack that doesn’t exist when a run starts refuses the run.
`externalOperationsOpenApi`	`OpenApiExternalOperationBindingInput[]`	yes	Tools from OpenAPI connectors that every agent in the interaction can call, as well as its own tools. Constraints: required (empty or whitespace-only strings are rejected).
`externalOperationsMcp`	`McpExternalOperationBindingInput[]`	yes	Tools from MCP connectors that every agent in the interaction can call, as well as its own tools. Constraints: required (empty or whitespace-only strings are rejected).
`inputsConnectorAuthenticationSecret`	`ConnectorAuthenticationSecretInputInput[]`	yes	Run inputs that choose the secret a tool sends with its calls. Constraints: required (empty or whitespace-only strings are rejected).
`inputsConnectorBinding`	`ConnectorBindingInputInput[]`	yes	Run inputs whose values go straight into a tool’s calls, so the model never sees or chooses them. Constraints: required (empty or whitespace-only strings are rejected).
`inputsPrompt`	`PromptInputInput[]`	yes	The inputs a run is started with, which the prompt uses as `%%name%%`. Constraints: required (empty or whitespace-only strings are rejected).
`loom`	`LoomConfigurationInput\| null`		Long-term memory for the interaction’s agents. Null: no memory.

Example

{
  "agent": {
    "name": "...",
    "agent": {
      "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "version": 0
    },
    "externalOperationsMcp": [
      {}
    ],
    "externalOperationsOpenApi": [
      {}
    ],
    "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "webAccess": {
      "search": false,
      "fetch": false
    }
  },
  "name": "...",
  "prompt": "...",
  "solutionSchema": "...",
  "systemPromptMode": "AppendToDefault",
  "systemPrompts": [
    "..."
  ],
  "durationWarningToAi": "00:05:00",
  "durationAutoTermination": "00:05:00",
  "contextSettings": {
    "mode": "None",
    "targetUtilization": 0,
    "toolResultTrimmingMode": "Never",
    "toolResultTrimmingMaxCycles": 0,
    "toolResultTrimmingStyle": "Placeholder",
    "toolResultTrimmingReplacement": "...",
    "compactionType": "SameAgent",
    "lowWaterUtilization": 0,
    "compactAtUtilization": 0,
    "compactKeepRecentTokens": 0,
    "compactTargetTokens": 0,
    "maxToolCallLoops": 0,
    "responseMaxTokens": 0,
    "compactMaxTokens": 0
  },
  "swarm": {
    "interactions": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "participants": [
      "..."
    ],
    "maxDepth": 0,
    "maxConcurrent": 0,
    "maxTotal": 0
  },
  "credentialStack": "...",
  "externalOperationsOpenApi": [
    {
      "pathBindings": [],
      "queryBindings": [],
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "externalOperationsMcp": [
    {
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "inputsConnectorAuthenticationSecret": [
    {
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "defaultSecretId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "headerName": "...",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "inputsConnectorBinding": [
    {
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "target": "...",
      "defaultValue": "...",
      "type": "Request",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "inputsPrompt": [
    {
      "dataType": "String",
      "name": "...",
      "description": "...",
      "isRequired": false
    }
  ],
  "loom": {
    "enabled": false,
    "scope": "Process",
    "scopeInput": "...",
    "shared": false,
    "recall": "Off",
    "weave": "Manual",
    "tapestryTokens": 0,
    "subjectInputs": [
      "..."
    ],
    "nightWeaving": false,
    "quietMinutes": 0,
    "weaverModel": "...",
    "vetModel": "...",
    "vetRecall": false,
    "seedFromLoomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "readFromLoomIds": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ]
  }
}

Where it’s used

interactions.createOneShot (POST /namespaces/{namespaceName}/interactions/one-shot)