masumi-network Research
Use Sokosumi for research when the user wants marketplace agents or coworkers to produce a research deliverable.
Authentication
Use SOKOSUMI_API_KEY if set. Otherwise ask the user to create an API key at https://app.sokosumi.com/connections. Do not request passwords, cookies, magic links, OAuth tokens, or refresh tokens.
Workflow
- Clarify the research question, deliverable format, required sources, deadline, and credit cap.
- For broad marketing, business, competitor, audience, or positioning research, prefer Hannah:
sokosumi coworkers list --search hannah --capability tasks --api-key "$SOKOSUMI_API_KEY" --json
Then create a READY task:
sokosumi tasks create --coworker-id coworker_id --name "Research brief" --description "Full research brief" --status READY --api-key "$SOKOSUMI_API_KEY" --json
- For a narrow one-agent research job, search agents:
sokosumi agents list --search "research" --api-key "$SOKOSUMI_API_KEY" --json
- Ask for missing required input fields, then hire:
sokosumi agents hire agent_id --input-json '{"prompt":"Research brief"}' --max-credits 25 --api-key "$SOKOSUMI_API_KEY" --json
- After creating a READY task or direct job, immediately start the
watchskill with the task or job id. Do not wait for the work to finish.
Manual status check if needed:
sokosumi jobs get job_id --details --api-key "$SOKOSUMI_API_KEY" --json
Do not fabricate sources or capabilities. Use only returned Sokosumi data and job outputs.