Category: provider

Document Mind (DocMind) — Node.js SDK

Use DocMind to extract document structure, text, and layout with async jobs.

Prerequisites

Install SDKs:

npm install @alicloud/docmind-api20220711 @alicloud/tea-util @alicloud/credentials

Provide credentials via standard Alibaba Cloud env vars:

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

ALICLOUD_REGION_ID

(optional default; if unset, choose the most reasonable region for the task or ask the user)

Quickstart (submit + poll)

const

Client

=

require

(

'@alicloud/docmind-api20220711'

)

;

const

Credential

=

require

(

'@alicloud/credentials'

)

;

const

Util

=

require

(

'@alicloud/tea-util'

)

;

const

cred

=

new

Credential

.

default

(

)

;

const

regionId

=

process

.

env

.

ALICLOUD_REGION_ID

||

'cn-hangzhou'

;

// Example default; choose/ask if unset.

const

client

=

new

Client

.

default

(

{

endpoint

:

`

docmind-api.

${

regionId

}

.aliyuncs.com

`

,

accessKeyId

:

cred

.

credential

.

accessKeyId

,

accessKeySecret

:

cred

.

credential

.

accessKeySecret

,

type

:

'access_key'

,

regionId

,

}

)

;

async

function

submitByUrl

(

fileUrl

,

fileName

)

{

const

req

=

new

Client

.

SubmitDocStructureJobRequest

(

)

;

req

.

fileUrl

=

fileUrl

;

req

.

fileName

=

fileName

;

const

resp

=

await

client

.

submitDocStructureJob

(

req

)

;

return

resp

.

body

.

data

.

id

;

}

async

function

pollResult

(

jobId

)

{

const

req

=

new

Client

.

GetDocStructureResultRequest

(

)

;

req

.

id

=

jobId

;

const

resp

=

await

client

.

getDocStructureResult

(

req

)

;

return

resp

.

body

;

}

(

async

(

)

=>

{

const

jobId

=

await

submitByUrl

(

'https://example.com/example.pdf'

,

'example.pdf'

)

;

console

.

log

(

'jobId:'

,

jobId

)

;

// Poll every 10s until completed.

for

(

;

)

{

const

result

=

await

pollResult

(

jobId

)

;

if

(

result

.

completed

)

{

console

.

log

(

result

.

status

,

result

.

data

||

result

.

message

)

;

break

;

}

await

new

Promise

(

r

)

=>

setTimeout

(

r

,

10000

)

;

}

)

(

)

;

Script quickstart

DOCMIND_FILE_URL

=

"https://example.com/example.pdf"

\

node

skills/ai/text/alicloud-ai-text-document-mind/scripts/quickstart.js

Environment variables:

DOCMIND_FILE_URL

DOCMIND_FILE_NAME

(optional)

DOCMIND_POLL_INTERVAL_MS

(optional, default 10000)

DOCMIND_MAX_POLLS

(optional, default 120)

Local file upload

const

fs

=

require

(

'fs'

)

;

const

advanceReq

=

new

Client

.

SubmitDocStructureJobAdvanceRequest

(

)

;

advanceReq

.

fileUrlObject

=

fs

.

createReadStream

(

'./example.pdf'

)

;

advanceReq

.

fileName

=

'example.pdf'

;

const

runtime

=

new

Util

.

RuntimeOptions

(

{

}

)

;

const

resp

=

await

client

.

submitDocStructureJobAdvance

(

advanceReq

,

runtime

)

;

Notes for Claude Code/Codex

DocMind is async: submit a job, then poll until

completed=true

.

Poll every ~10s; max processing window is 120 minutes.

Keep files publicly accessible when using URL submission.

Error handling

UrlNotLegal

URL not publicly accessible or malformed.

DocProcessing

job still running; keep polling.
Fail: check message and error code for root cause. Validation mkdir -p output/alicloud-ai-text-document-mind for f in skills/ai/text/alicloud-ai-text-document-mind/scripts/*.py ; do python3 -m py_compile " $f " done echo "py_compile_ok"

output/alicloud-ai-text-document-mind/validate.txt Pass criteria: command exits 0 and output/alicloud-ai-text-document-mind/validate.txt is generated. Output And Evidence Save artifacts, command outputs, and API response summaries under output/alicloud-ai-text-document-mind/ . Include key parameters (region/resource id/time range) in evidence files for reproducibility. Workflow Confirm user intent, region, identifiers, and whether the operation is read-only or mutating. Run one minimal read-only query first to verify connectivity and permissions. Execute the target operation with explicit parameters and bounded scope. Verify results and save output/evidence files. References DocMind Node.js SDK: @alicloud/docmind-api20220711 Source list: references/sources.md

安装