Carregando
0x70Lição 8 de 16

Ofereça recursos e prompts

Exponha contexto por URIs e modelos reutilizáveis com argumentos, protegendo os caminhos.

20 min Questionário com 6 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Listar, ler e criar modelos de URI para recursos
  • Usar anotações para indicar contexto relevante
  • Retornar mensagens de prompt e impedir path traversal

Um recurso é um dado identificado por URI, como file:///project/README.md, git://repo/main ou crm://customers/42. Clientes os descobrem com resources/list e os leem com resources/read. Quando há muitos dados para listar, ofereça modelos de recursos com variáveis, como weather://{city}/today.

Um prompt tem nome, descrição e argumentos opcionais. prompts/get retorna mensagens com papel e conteúdo, prontas para iniciar uma conversa. Hosts costumam apresentar prompts como comandos de barra.

Resultado de resources/read
1{
2  "jsonrpc": "2.0",
3  "id": 2,
4  "result": {
5    "resultType": "complete",
6    "contents": [
7      {
8        "uri": "file:///project/src/main.rs",
9        "mimeType": "text/x-rust",
10        "text": "fn main() {\n    println!(\"Hello world!\");\n}"
11      }
12    ],
13    "ttlMs": 60000,
14    "cacheScope": "private"
15  }
16}

Recursos e conteúdos podem trazer anotações para ajudar o host a decidir o que incluir: audience ("user", "assistant" ou ambos), priority de 0 (opcional) a 1 (praticamente obrigatório) e lastModified.

Prompts

Um prompt tem nome, descrição e argumentos opcionais. prompts/get recebe os argumentos e devolve uma lista de mensagens, cada uma com role (user ou assistant) e conteúdo, prontas para iniciar uma conversa. Hosts costumam apresentá-los como comandos de barra.

Resultado de prompts/get
1{
2  "jsonrpc": "2.0",
3  "id": 2,
4  "result": {
5    "resultType": "complete",
6    "description": "Prompt de revisão de código",
7    "messages": [{
8      "role": "user",
9      "content": { "type": "text", "text": "Revise este código Python:\ndef hello():\n    print('mundo')" }
10    }]
11  }
12}

Principais conclusões

  • Recursos são dados identificados por URI; modelos representam famílias de URIs.

  • Prompts retornam mensagens prontas para iniciar uma interação.

  • Valide o caminho resolvido para impedir acesso fora da raiz permitida.

Quiz da aula

6 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: crie um servidor MCP

Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.

Exercício 1

Expanda um modelo de URI

+25 XP

A primeira linha contém um modelo com variáveis {name}; a segunda, um objeto JSON com os valores. Substitua cada variável e imprima o URI. Se faltar um valor, imprima missing NAME para a primeira variável ausente.

  • Duas variáveis
  • Valor ausente
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Bloqueie path traversal

+25 XP

A primeira linha informa a pasta raiz absoluta. Cada linha seguinte é um caminho relativo solicitado. Imprima allow FULL_PATH se o caminho normalizado ficar dentro da raiz; caso contrário, imprima deny REQUESTED.

  • Caminho normal e tentativa de escapar
  • Pasta irmã e caminho absoluto
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…