Tiangong KB Course Fulltext Fetch

Use this skill when the task has a Tiangong KB course document_id and tags, and needs the full processed text for that document.

Boundary

Always call the Tiangong AI CLI:

npx @tiangong-ai/[email protected] kb course fulltext --document-id <document_id> --tags <tags>

Do not call S3, NAS, Supabase, Pinecone, or OpenSearch directly from the skill. The CLI owns the S3 path rule, list/get behavior, and AWS SDK credential handling.

Prerequisites

• The wrapper defaults to npx @tiangong-ai/[email protected]; users do not need a

preinstalled CLI. Set TIANGONGAICLI or TIANGONGAICLI_BIN only to override the CLI entrypoint.

• AWS credentials must already be available in the environment through the AWS

SDK default chain, such as AWSACCESSKEYID, AWSSECRETACCESSKEY, AWSSESSIONTOKEN, AWSPROFILE, AWSREGION, or AWSDEFAULTREGION.

• If credentials live in a dotenv file, pass env_file. Loaded dotenv values

only fill unset environment variables; explicit JSON fields such as bucket, prefix, and region are passed as CLI flags and take precedence. Never print secret values.

Fetch Full Text

Pass the course document_id and tags:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities"
}'

The wrapper calls:

npx @tiangong-ai/[email protected] kb course fulltext --document-id <document_id> --tags <tags>

To save the full text:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities"
}' ./fulltext.txt

To return CLI metadata and text as JSON:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities",
  "json": true
}'

Input Fields

• document_id or documentId: required course document id.
• tags or tag: required course tag, such as thu_humanities.
• output_file: optional output path. The second wrapper argument takes

precedence when both are provided.

• env_file: optional dotenv file to load before calling the CLI.
• json: true to return the CLI JSON payload instead of plain text.
• bucket, prefix, region: optional overrides for the CLI command.

When using the returned text in reader-facing prose, cite source titles or paths when useful, but do not describe internal S3 paths, AWS credentials, or retrieval mechanics unless the user asks for implementation details.