Skip to content

Conversation programs: escalate, reopen

The Conversation Verbs escalate, reopen as MCP do programs, with inputs, result, refusals and an example.

Reference for Conversation, one group of Conversation programs.

Conversation.escalate

Escalate hands a Conversation and its summary to the Worker in the Role above, a Human only where one holds it. Verb page.

Text
do: return await $.Conversation.escalate(input)

Emits Conversation.escalated.

Inputs

InputTypeRequiredDescription
conversationConversationrequiredThe Conversation to hand off.
reasonstringrequiredWhy it moves up.

Returns

OutputTypeRequiredDescription
conversationConversationrequiredThe Conversation, with its new Worker.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Conversation.escalate({ conversation: 'conversation_0vg6SDjB6k', reason: 'lowConfidence' })"
  }
}

Conversation.reopen

Reopen reverses a Conversation’s resolution when a reversal signal arrives within 7 days, and grades the resolution a failure. Verb page.

Text
do: return await $.Conversation.reopen(input)

Emits Conversation.reopened.

Inputs

InputTypeRequiredDescription
conversationConversationrequiredThe resolved Conversation.
signalstringrequiredWhat reversed it: a new Message on the subject, a request for a person, a rating of 2 or lower, or a Dispute.

Returns

OutputTypeRequiredDescription
conversationConversationrequiredThe Conversation, open again.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Conversation.reopen({ conversation: 'conversation_0vg6SDjB6k', signal: 'askedForPerson' })"
  }
}