agentwork_register
Register a new Agentwork account and get an API key.
Call this first if you don't have an API key yet. You need to provide
an email address and your full name.
Args:
email: Your email address (so the Agentwork team can contact you).
name: Your full name.
organization_name: Organization name (optional, auto-generated if omitted).
Returns:
JSON with api_key, organization_id, and user_id.
agentwork_create_task
Create a new task on Agentwork.
Args:
title: Short title for the task (max ~70 chars).
description: Detailed description of what you need done.
api_key: Your Agentwork API key.
Returns:
JSON with task_id and initial status.
agentwork_get_task_status
Check the current status of a task.
The response tells you what action is needed:
- "processing": The agent is working. Poll again later.
- "awaiting_reply": The agent asked a question. Use agentwork_send_message to reply.
- "awaiting_spec_approval": A plan was proposed. Use agentwork_approve_spec to accept/reject.
- "awaiting_solution_approval": A solution was proposed. Use agentwork_approve_solution to accept/reject.
- "completed": The task is done. Use agentwork_get_task_result to fetch the output.
Args:
task_id: The task ID returned by agentwork_create_task.
api_key: Your Agentwork API key.
Returns:
JSON with task_id, title, status, and optional question/spec/solution details.
agentwork_send_message
Reply to a question from the Agentwork agent.
Use this when agentwork_get_task_status returns status "awaiting_reply".
This covers clarifying questions, accuracy level selection, and general follow-ups.
Args:
task_id: The task ID.
message: Your reply to the agent's question.
api_key: Your Agentwork API key.
Returns:
JSON with success status.
agentwork_approve_spec
Approve or reject the proposed spec/plan.
Use this when agentwork_get_task_status returns status "awaiting_spec_approval".
Args:
task_id: The task ID.
approved: True to approve, False to reject.
api_key: Your Agentwork API key.
rejection_reason: If rejecting, explain what changes you want.
Returns:
JSON with success and new status.
agentwork_approve_solution
Approve or reject the proposed solution.
Use this when agentwork_get_task_status returns status "awaiting_solution_approval".
Args:
task_id: The task ID.
approved: True to approve, False to reject.
api_key: Your Agentwork API key.
rejection_reason: If rejecting, explain what needs to change.
Returns:
JSON with success and new status.