ManagedInteractionAgentBinding

An agent a managed interaction’s manager can dispatch work to, and what it sees when it does.

Kind: an object, used in requests and responses. In a request it is called ManagedInteractionAgentBindingInput.

In a request

Field	Type	Required	Description
mode	ManagedAgentMode		What the agent sees when the manager dispatches work to it. Default: OneTime, which shows it the least.
name	string		The participant’s name in the interaction. Per-agent settings of a run, such as model overrides and loom mappings, name the participant by it.
agent	VersionReference		The agent, and the version of it, that takes part.
externalOperationsMcp	McpExternalOperationBindingInput[]		Tools from MCP connectors this participant gets on top of its agent’s own.
externalOperationsOpenApi	OpenApiExternalOperationBindingInput[]		Tools from OpenAPI connectors this participant gets on top of its agent’s own.
loomId	uuid | null		The id of a named loom this participant always wakes up with. Null: the interaction’s loom scope decides. A loom mapped when a run starts takes precedence.
webAccess	InteractionAgentWebAccessInput| null		This participant’s web tools, overriding what its agent allows; each null member keeps the agent’s setting. Null: the agent decides. A run’s own overrides take precedence over this.

{
  "mode": "OneTime",
  "name": "...",
  "agent": {
    "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "version": 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
    }
  ],
  "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "webAccess": {
    "search": false,
    "fetch": false
  }
}

In a response

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

Field	Type	Description
mode	ManagedAgentMode	What the agent sees when the manager dispatches work to it. Default: OneTime, which shows it the least.
name	string	The participant’s name in the interaction. Per-agent settings of a run, such as model overrides and loom mappings, name the participant by it.
agent	VersionReference	The agent, and the version of it, that takes part.
externalOperationsMcp	McpExternalOperationBinding[]	Tools from MCP connectors this participant gets on top of its agent’s own.
externalOperationsOpenApi	OpenApiExternalOperationBinding[]	Tools from OpenAPI connectors this participant gets on top of its agent’s own.
loomId	uuid | null	The id of a named loom this participant always wakes up with. Null: the interaction’s loom scope decides. A loom mapped when a run starts takes precedence.
webAccess	InteractionAgentWebAccess| null	This participant’s web tools, overriding what its agent allows; each null member keeps the agent’s setting. Null: the agent decides. A run’s own overrides take precedence over this.

{
  "mode": "OneTime",
  "name": "...",
  "agent": {
    "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
    "version": 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
    }
  ],
  "loomId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "webAccess": {
    "search": false,
    "fetch": false
  }
}

Where it’s used

• Inside ManagedInteractionCreateRequest
• Inside ManagedInteractionUpdateRequest
• Inside ManagedInteractionVersion