MCP Academy · Aula

Criar conteúdo no momento da leitura

Calcule o corpo de um recurso quando ele for solicitado.

Criar conteúdo no momento da leitura é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.

Sob demanda, não antecipadamente

Um recurso dinâmico não armazena um corpo fixo. Seu conteúdo é calculado sob demanda, somente quando um cliente realmente solicita sua leitura. ⚡

A leitura dispara o trabalho

Sua função de recurso é executada no momento de uma solicitação de leitura. Nada acontece até que um cliente faça a leitura, portanto você nunca desperdiça esforço criando conteúdo que ninguém quer.

Retorne o corpo

O que quer que sua função retorne se torna o conteúdo do recurso. Retorne uma cadeia de caracteres e o cliente receberá exatamente esse texto como corpo do recurso.

@mcp.resource("time://now")
def now() -> str:
    return datetime.now().isoformat()

Atualizado a cada leitura

Como o corpo é recriado a cada vez, o modelo sempre vê dados atuais. Leia o relógio duas vezes e obterá duas marcas de tempo diferentes.

Use as variáveis da URI

Combine a criação no momento da leitura com um modelo. Os parâmetros capturados determinam o que você calcula, permitindo que a mesma função forneça conteúdo personalizado para cada URI.

@mcp.resource("greeting://{name}")
def greet(name: str) -> str:
    return f"Hello, {name}!"

Busque dados de qualquer lugar

No momento da leitura, você pode realizar um trabalho real: consultar um banco de dados, chamar uma API ou ler um arquivo. O resultado desse trabalho é o que você retorna como corpo.

@mcp.resource("stats://summary")
def summary() -> str:
    return db.fetch_summary()

Use assíncrono quando houver espera

Se criar o conteúdo significar aguardar uma operação de entrada e saída, torne a função assíncrona. O servidor poderá atender outras leituras enquanto a sua aguarda uma chamada de rede lenta.

@mcp.resource("feed://latest")
async def latest() -> str:
    return await fetch_feed()

Dê forma ao texto retornado

Você decide o formato do corpo. Retornar texto JSON é comum quando o modelo precisa de dados estruturados sobre os quais possa raciocinar com clareza.

import json

def report() -> str:
    return json.dumps({"ok": True})

Mantenha a rapidez

Uma leitura deve parecer ágil. Se o trabalho for pesado, armazene o resultado em cache para que leituras repetidas não refaçam cálculos caros todas as vezes.

Lide com dados ausentes

E se o item solicitado não existir? Gere um erro a partir da função para que o cliente saiba que não foi possível ler o recurso, em vez de receber dados inúteis.

def get_doc(doc_id: str) -> str:
    if doc_id not in store:
        raise ValueError("not found")
    return store[doc_id]

Por que isso importa

Criar o conteúdo no momento da leitura transforma uma ideia estática em uma janela ativa para seus dados. O modelo sempre lê o que é verdadeiro agora, não uma fotografia desatualizada. 🎯

Verificação rápida

Quando o corpo de um recurso dinâmico é produzido?

Recapitulação

Você viu como retornar um valor a partir de uma função de recurso cria conteúdo durante a leitura, fornecendo ao modelo dados novos e calculados a cada vez. A seguir: recursos listados versus baseados em modelos. 🚀

Perguntas Frequentes

A aula “Criar conteúdo no momento da leitura” é grátis?

Sim — o texto completo de “Criar conteúdo no momento da leitura” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.

O que vou aprender em “Criar conteúdo no momento da leitura”?

Calcule o corpo de um recurso quando ele for solicitado. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar MCP Academy?

Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Criar conteúdo no momento da leitura”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de MCP Academy?

Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para MCP Academy