Skip to main content

​
Install and configure the SoMark plugin

1

Install the plugin

Make sure DeepSeek Harness is running correctly, then install dsh-tool-somark into the profile you want to use.Restart the profile after installation. The plugin registers the somark_parse tool automatically.
2

Configure the API key

We recommend setting the SoMark API key as an environment variable in the terminal that starts DeepSeek Harness.
No API key yet? Go to the SoMark API workbench to get your API key. Free quota does not need to be claimed and is automatically credited to your account (500 pages/day, 2000 pages/month).
3

Configure one profile (optional)

If you do not want to use an environment variable, configure the API key in the profile’s cordis.patch.yml:
Do not commit a configuration file that contains a real API key.

​
Parse documents in DeepSeek Harness

1

Prepare the document

Place the PDF, image, Word, or PPT file in a location that the current DeepSeek Harness workspace can access, and use its absolute path.
2

Send a parsing instruction

Tell the agent which file to parse and what you need. For example:
  • “Use SoMark to parse /workspace/report.pdf and summarize the main conclusions.”
  • “Parse /workspace/contract.docx as Markdown and extract the key clauses.”
  • “Parse /workspace/slides.pptx and organize the content by section.”
The agent calls somark_parse to read the file and waits for SoMark to finish parsing it.
3

Use the parsed result

After parsing finishes, ask the agent to summarize the content, extract fields, organize tables, or save the result as Markdown.

​
Parameters and outputs

​
Input parameters

​
Common configuration

Add these fields under the tool-somark config object. The plugin uses its defaults when you omit them. See the plugin README for all configuration fields and defaults.

​
Outputs

​
Notes

  • somark_parse parses one file per call. Ask the agent to call the tool once per file when processing multiple documents.
  • The plugin reads documents through the DeepSeek Harness file system, so the file must be in a location allowed by the current workspace.
  • The plugin sends documents to the SoMark API for parsing. Make sure the documents meet your data security and compliance requirements.