← Cloudflare Workers AI / workers-ai / features / markdown-conversion / usage

Workers Binding

Bezserverová platforma Cloudflare vám umožňuje spouštět kód na edge a vytvářet tak fullstack aplikace pomocí Workers. binding umožňuje vašemu Workeru nebo Pages Function pracovat s prostředky na Cloudflare Developer Platform.

Chcete-li využívat naši službu Markdown Conversion přímo z Workers, vytvořte vazbu AI buď v Cloudflare dashboardu (viz AI bindings s pokyny), nebo můžete aktualizovat Soubor Wrangler. Do souboru Wrangler přidejte následující:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "ai": {
    "binding": "AI"
  }
}

[ai]
binding = "AI" # i.e. available in your Worker on env.AI

V tomto příkladu načteme dokument PDF a obrázek z R2 a oba předáme env.AI.toMarkdown. Výsledkem je seznam převedených dokumentů. Modely Workers AI se automaticky použijí k detekci a shrnutí obrázku.

import { Env } from "./env";

export default {
	async fetch(request, env, ctx) {
		// https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/somatosensory.pdf
		const pdf = await env.R2.get("somatosensory.pdf");

		// https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/cat.jpeg
		const cat = await env.R2.get("cat.jpeg");

		return Response.json(
			await env.AI.toMarkdown([
				{
					name: "somatosensory.pdf",
					blob: new Blob([await pdf.arrayBuffer()], {
						type: "application/pdf",
					}),
				},
				{
					name: "cat.jpeg",
					blob: new Blob([await cat.arrayBuffer()], {
						type: "image/jpeg",
					}),
				},
			]),
		);
	},
};

import { Env } from "./env";

export default {
	async fetch(request: Request, env: Env, ctx: ExecutionContext) {
		// https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/somatosensory.pdf
		const pdf = await env.R2.get("somatosensory.pdf");

		// https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/cat.jpeg
		const cat = await env.R2.get("cat.jpeg");

		return Response.json(
			await env.AI.toMarkdown([
				{
					name: "somatosensory.pdf",
					blob: new Blob([await pdf.arrayBuffer()], {
						type: "application/pdf",
					}),
				},
				{
					name: "cat.jpeg",
					blob: new Blob([await cat.arrayBuffer()], {
						type: "image/jpeg",
					}),
				},
			]),
		);
	},
};

import { Env } from "./env";

export default {
	async fetch(request, env, ctx) {
		return Response.json(await env.AI.toMarkdown().supported());
	},
};

import { Env } from "./env";

export default {
	async fetch(request: Request, env: Env, ctx: ExecutionContext) {
		return Response.json(await env.AI.toMarkdown().supported());
	},
};

Přijímá dokument nebo seznam dokumentů v různých formátech a převádí je do formátu Markdown.

const result = await env.AI.toMarkdown({
	name: "document.pdf",
	blob: new Blob([documentBuffer]),
});

const result = await env.AI.toMarkdown({
	name: "document.pdf",
	blob: new Blob([documentBuffer]),
});

• files: MarkdownDocument | MarkdownDocument[]- instance nebo pole MarkdownDocuments.

• conversionOptions: ConversionOptions- options které řídí, jak probíhá konverze. Viz Možnosti převodu pro další podrobnosti.

• results: Promise<ConversionResult | ConversionResult[]>- Instance nebo pole ConversionResults.

• name string

  • Název dokumentu, který se má převést.

• blob Blob

  • Nový Blob ↗ objekt s obsahem dokumentu.

• id string

  • ID přiřazené k tomuto objektu.

• name string

  • Název převedeného dokumentu. Odpovídá názvu vstupního souboru.

• format 'markdown' | 'text' | 'error'

  • Formát tohoto ConversionResult objekt. Rovná se text při nastavení output.format možnost na text.

• mimetype string

  • Zjištěný typ MIME ↗ dokumentu.

• tokens number

  • Odhadovaný počet tokenů převedeného dokumentu. Není přítomen, pokud format se rovná error.

• data string

  • Obsah převedeného dokumentu. Není přítomen, pokud format se rovná error.

• error string

  • Chybová zpráva vysvětlující, proč převod selhal. Přítomna pouze v případě, že format se rovná error.

Tato metoda je podobná env.AI.toMarkdown s tím rozdílem, že je zpřístupněna prostřednictvím nového handle. Přijímá stejné argumenty a vrací stejné hodnoty.

const result = await env.AI.toMarkdown().transform({
	name: "document.pdf",
	blob: new Blob([documentBuffer]),
});

const result = await env.AI.toMarkdown().transform({
	name: "document.pdf",
	blob: new Blob([documentBuffer]),
});

Vrátí seznam formátů souborů, které jsou aktuálně podporovány pro převod do markdownu. Viz Podporované formáty pro úplný seznam formátů souborů, které lze převést do Markdownu.

const formats = await env.AI.toMarkdown().supported();

const formats = await env.AI.toMarkdown().supported();

• results: SupportedFormat[]- Pole všech formátů podporovaných pro konverzi do markdownu.

• extension string

  • Přípona souborů v tomto formátu.

• mimeType string

  • typ MIME ↗ souborů tohoto formátu