用途:当任务已持有天工知识库课程 document_id 与 tags,并需要该文档的完整处理后文本时,可使用本技能获取全文。其边界是始终通过天工 AI CLI 调用,不直接从技能内访问 S3、NAS、Supabase、Pinecone 或 OpenSearch,由 CLI 负责 S3 路径规则、list/get 行为与 AWS SDK 凭证处理。
主要能力:封装并调用以下命令获取课程全文:
npx @tiangong-ai/cli@0.0.19 kb course fulltext --document-id <document_id> --tags <tags>
包装脚本默认使用 npx @tiangong-ai/cli@0.0.19,用户无需预装 CLI;仅在需要覆盖 CLI 入口时设置 TIANGONG_AI_CLI 或 TIANGONG_AI_CLI_BIN。可输出纯文本,也可保存到文件,或返回 CLI 元数据与文本的 JSON。
使用方式:运行包装脚本并传入含 document_id 与 tags 的 JSON,例如:
./scripts/course_fulltext_fetch.sh '{ "document_id": "000125ed-c4d9-4fe3-9383-281162406d66", "tags": "thu_humanities" }'
保存全文时追加输出路径作为第二个参数;需要 JSON 时在输入中设 "json": true。输入字段包括:document_id 或 documentId(必填课程文档 ID);tags 或 tag(必填课程标签);output_file(可选输出路径,第二个包装参数优先);env_file(可选 dotenv 文件);json(为 true 时返回 CLI JSON 载荷);bucket、prefix、region(可选覆盖项)。
前提条件:环境中须已通过 AWS SDK 默认链提供 AWS 凭证,例如 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN、AWS_PROFILE、AWS_REGION 或 AWS_DEFAULT_REGION。若凭证存放在 dotenv 文件,可传 env_file;dotenv 值仅用于填充未设置的环境变量,bucket、prefix、region 等显式 JSON 字段会作为 CLI 标志传递并优先。不要打印密钥值。
限制:不直接调用 S3 等底层存储;凭证由环境或 dotenv 提供;在面向读者的正文中引用返回文本时,可注明来源标题或路径,但除非用户要求实现细节,不要描述内部 S3 路径、AWS 凭证或检索机制。其他未在资料中说明的收费、平台支持与效果暂未提供。