Start a search
createRoleSearchStart a Search for a role (jobId from readJob), or an exploring Search from a prompt alone, and start its first run. It searches the Clera pool, your team's network and, when turned on, outside Clera; people appear on the Search as they are scored.
Needs jobId, prompt, or both. A role alone uses the role's requirements as criteria. A role with a prompt keeps those and adds up to 2 criteria from the prompt. A prompt alone is drafted into criteria by Clera. Tell the user what will be searched and get a yes before calling: each run uses search credits. Then read the result with getRoleSearch.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "createRoleSearch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | No | The role to search for. | |
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| prompt | No | Who to look for, in the user's words. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | ||
| search | Yes |