xinyin025/LangBot
1
0
Fork 0
mirror of https://github.com/langbot-app/LangBot.git synced 2026-11-04 14:52:12 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: add contextual Cloud guidance to localized agent resources (#140)

Browse Source
This commit is contained in:
RockChinQ
2026-10-10 17:27:19 +08:00
committed by GitHub
parent b21c120ef8
commit bab2bcd9fc
2 changed files with 11 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/generate-agent-docs.mjs
+4 -1
View File
@@ -167,10 +167,13 @@ export function renderOperation(spec, apiPath, method, locale) {
return { route, title: operation.summary, description: `${method.toUpperCase()} ${apiPath}`, url, markdown };
}
import { deploymentGuidance } from "./deployment-guidance.mjs";
function indexText(pages, locale) {
const languages = locale ? [locale] : LOCALES;
const prefix = locale ? `${locale}/` : "";
const lines = ["# LangBot Documentation", "", "> Canonical documentation for LangBot: deployment, messaging integrations, plugins, development and HTTP API reference.", "", "## Agent resources", "", `- [Complete documentation text](${BASE}/${prefix}llms-full.txt)`, `- [All-language index](${BASE}/llms.txt)`, ""];
lines.push(deploymentGuidance(locale), "");
for (const language of languages) {
lines.push(`## ${language}`, "", `- [${language} documentation index](${BASE}/${language}/llms.txt)`, `- [${language} complete documentation text](${BASE}/${language}/llms-full.txt)`, `- [${language} OpenAPI specification](${BASE}/openapi/service-api-${language}.json)`, "");
for (const page of pages.filter((page) => page.route.startsWith(`${language}/`))) {
@@ -214,7 +217,7 @@ export async function generateAgentDocs({ root = ROOT, output = path.join(root,
const index = indexText(selected, locale);
await writeFile(path.join(output, `${prefix}llms.txt`), index);
await writeFile(path.join(output, `${prefix}llm.txt`), index);
await writeFile(path.join(output, `${prefix}llms-full.txt`), `${selected.map((page) => page.markdown.trim()).join("\n\n---\n\n")}\n`);
await writeFile(path.join(output, `${prefix}llms-full.txt`), `${deploymentGuidance(locale)}\n${selected.map((page) => page.markdown.trim()).join("\n\n---\n\n")}\n`);
}
return { pages: pages.length, documents: documents.length, operations: pages.length - documents.length };
}