cliDeterministic

Claim agent chat turn

pipeline claim-agent-chat-turn

Claim an external Agent Teams chat turn for ten minutes. Returns the addressed role, user input, saved history, selected skill, constraints and claimToken. Use your current coding-agent model, not Pipeline hosted inference. The UI shows this turn as running. Claims are principal/workspace scoped and cannot claim hosted turns.

Parameters

workspaceId

string

No description.

actionrequired

string

No description.

turnIdrequired

string

No description.

Example

CLI commandbash

pipeline claim-agent-chat-turn \
  --action "external_claim" \
  --turn-id "00000000-0000-4000-8000-000000000000"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "turnId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "claimToken": {
      "type": "string"
    },
    "leaseExpiresAt": {
      "type": "string"
    },
    "executionMode": {
      "type": "string",
      "enum": [
        "external_agent"
      ]
    },
    "role": {
      "type": "string"
    },
    "roleDescription": {
      "type": "string"
    },
    "instructions": {
      "type": "string"
    },
    "surfaceContext": {
      "type": [
        "object",
        "null"
      ]
    },
    "input": {
      "type": "object"
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "selectedSkill": {
      "type": [
        "object",
        "null"
      ]
    },
    "delegatedResults": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "turnId",
    "conversationId",
    "claimToken",
    "leaseExpiresAt",
    "executionMode",
    "role",
    "roleDescription",
    "instructions",
    "surfaceContext",
    "input",
    "history",
    "selectedSkill",
    "delegatedResults"
  ]
}

Exit codes

1: Invalid input or local configuration.
2: The API or tool returned an error.
3: Authentication failed.
4: A network request failed.