Tool Details: agent_fail_task

Basic Information

Tool Name:agent_fail_task
Asset Name:Fail Agent Task
Description:Reject or fail the in-scope task when the request cannot be fulfilled, for example because it is outside the agent's capabilities or its input is invalid. The agent and task are determined from the current request context — no id is passed. Without a task in scope the call fails. Side effects: fails the pending task Job with the supplied error and removes the task from the agent's task queue.
Adapter:agent
Asset Hash:0x8f8aae00bd44a8207131786e233ec121c0647dd1647bc7d3f11e166596c3a407
Input
PropertyTypeDescription
error*stringHuman-readable explanation of why the task cannot be completed.
Output
PropertyTypeDescription
statusstringAlways 'FAILED'.
agentIdstring-
taskIdstring-

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-4.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent_fail_task",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-4.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "agent_fail_task",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-4.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "agent_fail_task",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-4.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'agent_fail_task',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
    "name": "Fail Agent Task",
    "description": "Reject or fail the in-scope task when the request cannot be fulfilled, for example because it is outside the agent's capabilities or its input is invalid. The agent and task are determined from the current request context — no id is passed. Without a task in scope the call fails. Side effects: fails the pending task Job with the supplied error and removes the task from the agent's task queue.",
    "dateCreated": "2026-04-16T00:00:00Z",
    "operation": {
        "adapter": "agent:failTask",
        "toolName": "agent_fail_task",
        "input": {
            "type": "object",
            "properties": {
                "error": {
                    "type": "string",
                    "description": "Human-readable explanation of why the task cannot be completed."
                }
            },
            "required": ["error"]
        },
        "output": {
            "type": "object",
            "properties": {
                "agentId": { "type": "string" },
                "taskId":  { "type": "string" },
                "status":  { "type": "string", "description": "Always 'FAILED'." }
            }
        }
    }
}

Navigation

Back to adapter details

Back to all adapters

Back to index