Tool Details: agent_complete_task

Basic Information

Tool Name:agent_complete_task
Asset Name:Complete Agent Task
Description:Explicitly marks the in-scope task as successfully complete. Invoked by an agent transition (typically as an LLM tool call) to deliver the final result to the caller. The agentId and taskId are read from the request context — the framework populates them when dispatching a task transition. Without a task in scope the call fails. Side effects: completes the pending task Job with the supplied result and removes the task from the agent's task queue.
Adapter:agent
Asset Hash:0xb54a66b6ba0e2847f679376a6738139c6812ce49eb2872f47cfb21c7c4eee86d
Input
PropertyTypeDescription
resultanyThe successful result to deliver to the caller. Any value is accepted; the schema is intentionally open so transitions can return arbitrary structured output.
Output
PropertyTypeDescription
agentIdstring-
taskIdstring-
statusstringAlways 'COMPLETE' on success.

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-3.covia.ai/mcp

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

url = "https://venue-3.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "agent_complete_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-3.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'agent_complete_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": "Complete Agent Task",
    "description": "Explicitly marks the in-scope task as successfully complete. Invoked by an agent transition (typically as an LLM tool call) to deliver the final result to the caller. The agentId and taskId are read from the request context — the framework populates them when dispatching a task transition. Without a task in scope the call fails. Side effects: completes the pending task Job with the supplied result and removes the task from the agent's task queue.",
    "dateCreated": "2026-04-16T00:00:00Z",
    "operation": {
        "adapter": "agent:completeTask",
        "toolName": "agent_complete_task",
        "input": {
            "type": "object",
            "properties": {
                "result": {
                    "description": "The successful result to deliver to the caller. Any value is accepted; the schema is intentionally open so transitions can return arbitrary structured output."
                }
            }
        },
        "output": {
            "type": "object",
            "properties": {
                "agentId": { "type": "string" },
                "taskId":  { "type": "string" },
                "status":  { "type": "string", "description": "Always 'COMPLETE' on success." }
            }
        }
    }
}

Navigation

Back to adapter details

Back to all adapters

Back to index