Start a research project
start_projectDelegate research, data analysis, or writing tasks to cloud agents with local files; approve the plan before credits are charged or set a credit cap for unattended runs.
Instructions
Hand a research, data analysis or writing task to HumanPen's cloud agents, with local files as its input: they scope it with the user, propose a plan, do the work, have it reviewed and deliver files. COSTS CREDITS once a plan is confirmed (charged by use; there is no price up front): show the user the plan and get their agreement before act_on_project confirm_plan, unless they set autonomy with a max_credits. Needs an API key with "Research projects" ticked.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request": "<request>"
},
"name": "start_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | The language to write in, e.g. en or zh | |
| files | No | Absolute paths of input files (data, drafts, papers) | |
| title | No | A name for the project; one is made from the request if omitted | |
| request | Yes | What the user wants done, in their words: the goal, the deliverables, any constraints | |
| autonomy | No | Let it run unattended within a credit cap the user set; omit to stop for the user at every step |