# RoundRobinInteractionVersion

A version of a round-robin interaction.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `agents` | [`InteractionAgentBinding`](https://docs.maitento.com/reference/types/interaction-agent-binding.md)`[]` | The participants, in the order they take turns. |
| `isNoActionAllowed` | `boolean` | Whether an agent may pass its turn without saying anything. |
| `isVotingAllowed` | `boolean` | Whether an agent may put something to a vote. |
| `isDirectQuestioningAllowed` | `boolean` | Whether an agent may ask another a question directly. |
| `isSolutionProposalAllowed` | `boolean` | Whether an agent may propose a final answer for the others to vote on. With no one able to, a conversation with a person carries on until it is stopped. |
| `humanSettings` | [`RoundRobinInteractionHumanSettings`](https://docs.maitento.com/reference/types/round-robin-interaction-human-settings.md)`\| null` | Whether a person takes part in the conversation, and how. Null: no one does. |
| `maximumNoActionLoops` | `integer \| null` | How many rounds in which every agent passes end the run. Null: no limit. Constraints: range: 1..2147483647. |
| `externalOperationsMcp` | [`McpExternalOperationBinding`](https://docs.maitento.com/reference/types/mcp-external-operation-binding.md)`[]` | Tools from MCP connectors that every agent in the interaction can call, as well as its own tools. |
| `externalOperationsOpenApi` | [`OpenApiExternalOperationBinding`](https://docs.maitento.com/reference/types/open-api-external-operation-binding.md)`[]` | Tools from OpenAPI connectors that every agent in the interaction can call, as well as its own tools. |
| `inputsConnectorAuthenticationSecret` | [`ConnectorAuthenticationSecretInput`](https://docs.maitento.com/reference/types/connector-authentication-secret-input.md)`[]` | Run inputs that choose the secret a tool sends with its calls. |
| `inputsConnectorBinding` | [`ConnectorBindingInput`](https://docs.maitento.com/reference/types/connector-binding-input.md)`[]` | Run inputs whose values go straight into a tool's calls, so the model never sees or chooses them. |
| `inputsPrompt` | [`PromptInput`](https://docs.maitento.com/reference/types/prompt-input.md)`[]` | The inputs a run is started with, which the prompt uses as `%%name%%`. |
| `prompt` | `string` | What the agents are asked to do. A run's inputs are filled in wherever it says `%%name%%`. |
| `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`](https://docs.maitento.com/reference/types/interaction-system-prompt-mode.md) | How `systemPrompts` combine with the instructions Maitento gives every agent. |
| `systemPrompts` | `string[]` | Extra system instructions for every agent in the interaction. |
| `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: the interaction sets no limit. |
| `contextSettings` | [`InteractionContextSettings`](https://docs.maitento.com/reference/types/interaction-context-settings.md) | 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. |
| `loom` | [`LoomConfiguration`](https://docs.maitento.com/reference/types/loom-configuration.md)`\| null` | Long-term memory for the interaction's agents. Null: no memory. |
| `swarm` | [`InteractionSwarmSettings`](https://docs.maitento.com/reference/types/interaction-swarm-settings.md)`\| null` | Whether this interaction's participants may start sub-interactions, which ones, and how far the work may spread. Null: none may. |
| `credentialStack` | `string \| null` | The credential stack this interaction's runs use, by id or name, when their start doesn't name one. Null: the namespace's default stack, then your tenant's. |
| `version` | `integer` | The version number, from 1. Every change to a definition adds a new version with the next number. |
| `date` | `datetime` | When this version was created, in UTC. |
| `isDisabled` | `boolean` | Whether this version is disabled. A disabled version is never used: new links and runs take the latest enabled version, and anything pinned to this one fails until it is re-enabled. |

## Example

```json
{
  "agents": [
    {
      "name": "...",
      "agent": {},
      "externalOperationsMcp": [],
      "externalOperationsOpenApi": [],
      "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "webAccess": {}
    }
  ],
  "isNoActionAllowed": false,
  "isVotingAllowed": false,
  "isDirectQuestioningAllowed": false,
  "isSolutionProposalAllowed": false,
  "humanSettings": {
    "chatMode": "Excluded",
    "includeInVotes": false,
    "includeInSolutions": false
  },
  "maximumNoActionLoops": 0,
  "externalOperationsMcp": [
    {
      "name": "...",
      "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "externalOperationVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "isTerminal": false
    }
  ],
  "externalOperationsOpenApi": [
    {
      "pathBindings": [],
      "queryBindings": [],
      "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
    }
  ],
  "prompt": "...",
  "solutionSchema": "...",
  "systemPromptMode": "AppendToDefault",
  "systemPrompts": [
    "..."
  ],
  "durationWarningToAi": "00:05:00",
  "durationAutoTermination": "00:05:00",
  "contextSettings": {
    "mode": "None",
    "targetUtilization": 0,
    "toolResultTrimmingMode": "Never",
    "toolResultTrimmingMaxCycles": 0,
    "toolResultTrimmingStyle": "Placeholder",
    "effectiveToolResultTrimmingStyle": "Placeholder",
    "toolResultTrimmingReplacement": "...",
    "compactionType": "SameAgent",
    "effectiveCompactionType": "SameAgent",
    "lowWaterUtilization": 0,
    "effectiveLowWaterUtilization": 0,
    "compactAtUtilization": 0,
    "compactKeepRecentTokens": 0,
    "compactTargetTokens": 0,
    "maxToolCallLoops": 0,
    "effectiveMaxToolCallLoops": 0,
    "responseMaxTokens": 0,
    "compactMaxTokens": 0
  },
  "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"
    ],
    "effectiveScope": "Process",
    "effectiveShared": false,
    "effectiveRecall": "Off",
    "effectiveWeave": "Manual",
    "effectiveTapestryTokens": 0,
    "effectiveSubjectInputs": [
      "..."
    ],
    "effectiveReadFromLoomIds": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "vets": false,
    "effectiveVetRecall": false
  },
  "swarm": {
    "interactions": [
      "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f"
    ],
    "participants": [
      "..."
    ],
    "maxDepth": 0,
    "maxConcurrent": 0,
    "maxTotal": 0
  },
  "credentialStack": "...",
  "version": 0,
  "date": "2026-10-26T12:00:00.0000000Z",
  "isDisabled": false
}
```

## Where it's used

- Inside [`RoundRobinInteraction`](https://docs.maitento.com/reference/types/round-robin-interaction.md)
