McpContentBlock class
Classe base astratta per i blocchi di contenuto di risposta agli strumenti MCP.
La libreria Funzioni di Azure discrimina i blocchi di contenuto dai valori utente semplici usando instanceof McpContentBlock, quindi solo le istanze delle sottoclassi integrate (McpTextContent, McpImageContent, McpAudioContent, McpResourceLinkContent, McpResourceContent) — o una sottoclasse personalizzata che estende questa classe — saranno trattate come blocchi di contenuto.
I letterali di oggetti semplici come { type: 'text', text: '...' }non sono trattati come blocchi di contenuto e verranno invece serializzati come testo JSON.
Estensione con tipi di blocco di contenuto personalizzati
Se la specifica MCP aggiunge un nuovo tipo di blocco — o il tuo scenario ne ha bisogno di uno personalizzato — puoi distribuire la tua sottoclasse senza alcun cambiamento di libreria. Il convertitore controlla instanceof McpContentBlock e chiama JSON.stringify(block)solo , il che invoca U toJSON() per produrre il payload del filo.
Esempio: aggiungere un ipotetico VideoContent
import { McpContentBlock } from '@azure/functions';
export interface VideoContentInit {
data: string | Buffer | ArrayBuffer;
mimeType: string; // e.g. 'video/mp4'
durationMs?: number; // optional field from a hypothetical spec
}
export class VideoContent extends McpContentBlock {
readonly type = 'video' as const;
readonly data: string | Buffer | ArrayBuffer;
readonly mimeType: string;
readonly durationMs?: number;
constructor(init: VideoContentInit) {
super();
this.data = init.data;
this.mimeType = init.mimeType;
this.durationMs = init.durationMs;
}
toJSON(): Record<string, unknown> {
const out: Record<string, unknown> = {
type: this.type,
data: toBase64(this.data),
mimeType: this.mimeType,
};
if (this.durationMs !== undefined) out.durationMs = this.durationMs;
return out;
}
}
function toBase64(data: string | Buffer | ArrayBuffer): string {
if (typeof data === 'string') return data;
if (Buffer.isBuffer(data)) return data.toString('base64');
return Buffer.from(new Uint8Array(data)).toString('base64');
}
Utilizzo di un blocco personalizzato da un gestore di utensili
// Single block
handler: async () => new VideoContent({ data: buf, mimeType: 'video/mp4' })
// Mixed with built-ins + structured content
handler: async () => new McpToolResponse({
content: [
new McpTextContent('Detected 3 scenes'),
new VideoContent({ data: buf, mimeType: 'video/mp4' }),
],
structuredContent: { scenes: 3, confidence: 0.92 },
})
Cosa fa la biblioteca per te
-
instanceof McpContentBlocktratta la tua sottoclasse in modo identico ai blocchi incorporati. - I ritorni a blocco singolo propagano la tua
typestringa verso il risultato esterno; gli array sono avvolti comemulti_content_result. -
structuredContentGestione, sintesi di testo di fallback e nullish passthrough si applicano tutti invariati.
Cosa devi fare bene nella tua sottoclasse
-
toJSON()deve restituire la forma esatta del filo richiesta dalle specifiche per il tuotype. - I payload binari devono essere codificati
toJSON()in base64 (vedi l'aiutantetoBase64sopra). - I letterali degli oggetti semplici non sono riconosciuti — devi costruire un'istanza.
Proprietà
| type |
Metodi
| toJSON() |
Dettagli proprietà
type
type: string
Valore della proprietà
string
Dettagli metodo
toJSON()
function toJSON(): Record<string, unknown>
Valori restituiti
Record<string, unknown>