Solicitando listas e tópicos
Peça à IA listas numeradas ou com marcadores e uma quantidade específica de itens.
Solicitando listas e tópicos é uma aula grátis de AI Prompt Engineering no CoddyKit. Esta é a aula 1 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 AI Prompt Engineering, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Prompt Engineering inclui 4 aulas no total.
Por que as listas funcionam bem com a IA
As listas são um dos formatos de saída mais claros para solicitar a uma IA. Elas são inequívocas, fáceis de percorrer rapidamente e fáceis de verificar — você pode contar imediatamente se recebeu a quantidade de itens solicitada.
Conhecer a sintaxe exata para solicitações de listas ajuda você a obter uma saída formatada de maneira consistente, sem correções posteriores.
Solicitações básicas de listas
Os padrões mais comuns para solicitar listas:
- «Liste 5 maneiras de...»
- «Dê-me 10 tópicos sobre...»
- «Dê 7 exemplos de...»
- «Forneça 3 razões pelas quais...»
Sempre especifique a quantidade exata. Dizer «liste algumas maneiras» produz uma quantidade variável de itens — às vezes 3, às vezes 12. Um número elimina essa variação.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=300,
messages=[{
'role': 'user',
'content': 'List exactly 5 ways a developer can improve Python code performance. Each item: one sentence only.'
}]
)
print(response.content[0].text)Solicitações de itens com marcadores
Quando quiser especificamente uma formatação com marcadores, em vez de listas numeradas, diga isso explicitamente. Os marcadores do Markdown (- ou •) são renderizados na maioria das interfaces de bate-papo, mas não em todos os ambientes.
- 'Dê-me 8 itens com marcadores sobre...'
- 'Crie uma lista com marcadores de...'
- 'Exiba como itens com marcadores, um por linha...'
Adicione 'cada item: no máximo X palavras' para controlar a densidade.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Create a bulleted list of 8 best practices for writing REST APIs. '
'Format: each bullet starts with a bold action verb. '
'Each bullet: max 15 words. No sub-bullets.'
)
}]
)
print(response.choices[0].message.content)Listas numeradas e etapas
As listas numeradas são melhores para conteúdo sequencial em que a ordem é importante:
- Instruções passo a passo
- Opções classificadas (das mais às menos recomendadas)
- Listas de tarefas priorizadas
- Etapas ordenadas para solucionar problemas
Use: 'Numere cada etapa...', 'Liste em ordem, da maior para a menor...', 'Dê-me 6 etapas numeradas para...'
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Give me 6 numbered steps to deploy a Python FastAPI app to AWS EC2. '
'Order: from initial setup to app accessible via browser. '
'Each step: 1-2 sentences + the specific command(s) to run. '
'Assume a fresh Ubuntu 22.04 server.'
)
}]
)
print(response.content[0].text)Listas de verificação
As listas de verificação são um subtipo específico de lista — itens que devem ser marcados conforme forem concluídos. Elas funcionam especialmente bem para:
- Listas de verificação de revisão de código
- Listas de verificação de preparação para o lançamento
- Listas de verificação de auditoria de segurança
- Listas de verificação de integração de novos membros
Solicite: 'Crie uma lista de verificação de...' ou 'Gere uma lista de verificação pré-lançamento para...' O modelo exibirá os itens em um formato com caixas de seleção - [ ] (padrão do Markdown).
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Create a pre-production launch checklist for a Python web API. '
'Format: markdown checkboxes (- [ ] item). '
'Group into sections: Security, Performance, Monitoring, Documentation. '
'4 items per section. Each item: specific and actionable in under 12 words.'
)
}]
)
print(response.choices[0].message.content)Controlando o tamanho e a densidade dos itens
A qualidade da lista melhora muito quando você especifica quanto detalhe cada item deve conter:
- 'Uma frase por item' — conciso e fácil de examinar
- 'Duas frases: a primeira descreve o que, a segunda explica por quê' — detalhe estruturado
- 'Título do item + descrição de 1 linha' — cabeçalho + explicação
- 'No máximo 10 palavras por item' — exige concisão extrema
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Two-sentence structure per list item
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'List 5 common Python performance bottlenecks. '
'For each item, use exactly 2 sentences: '
'Sentence 1: describe the bottleneck. '
'Sentence 2: state the fix in one specific action.'
)
}]
)
print(response.content[0].text)Listas rotuladas e categorizadas
Adicionar rótulos aos itens da lista cria listas categorizadas ou marcadas, mais fáceis de examinar e usar:
- 'Rotule cada item como EASY, MEDIUM ou HARD'
- 'Marque cada sugestão com a equipe relevante: [FRONTEND] [BACKEND] [DEVOPS]'
- 'Indique o investimento de tempo esperado em cada item: (5 min) (2 h) (1 semana)'
Os rótulos transformam uma lista simples em um recurso acionável e filtrável.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'List 8 ways to reduce AWS costs for a startup. '
'Label each with: [IMMEDIATE] if doable today, [MEDIUM] if takes 1-2 weeks, or [LONG] if takes a month+. '
'Also label each with estimated monthly savings: ($50-200) ($200-500) ($500+). '
'Each item: one sentence.'
)
}]
)
print(response.choices[0].message.content)Listas aninhadas
As listas aninhadas adicionam um nível de hierarquia — úteis para organizar ideias que têm agrupamentos naturais:
- Categorias principais no nível 1
- Exemplos específicos ou subitens no nível 2
Solicite: 'Crie um esboço de dois níveis com 4 seções principais e 3 subitens em cada uma.' Tenha cuidado — mais de 2 níveis de profundidade fica difícil de ler na maioria dos contextos.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Create a 2-level outline for a "Python for Data Science" beginner course. '
'Level 1: exactly 4 module titles. '
'Level 2: exactly 3 lesson titles under each module. '
'Format as nested markdown bullets. '
'Lesson titles should be specific — not generic like "Introduction".'
)
}]
)
print(response.content[0].text)Listas classificadas e ordenadas
Quando a ordem transmite significado, especifique explicitamente o critério de classificação:
- 'Classifique do maior para o menor impacto'
- 'Ordene do mais rápido ao mais demorado para implementar'
- 'Liste em ordem de risco — primeiro o maior risco'
- 'Ordene alfabeticamente'
Sem uma ordenação explícita, o modelo pode listar os itens na ordem em que vieram à mente, que não é necessariamente a mais útil para você.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'List 6 database indexing strategies for PostgreSQL. '
'Order: from most commonly needed to most specialized. '
'Each item: strategy name in bold, followed by a 10-word description, '
'then a note of when NOT to use it in parentheses.'
)
}]
)
print(response.choices[0].message.content)Antipadrões: listas que falham
Erros comuns em solicitações de listas que produzem uma saída ruim:
- Sem quantidade: 'Dê-me alguns itens com marcadores' → tamanho variável, geralmente curto ou longo demais
- Sem estrutura para os itens: o modelo escolhe sua própria combinação de itens longos e curtos
- Solicitar itens demais: 'Liste 50 ideias' → os últimos 30 são conteúdo de preenchimento
- Aninhamento profundo demais: 3 ou mais níveis → a saída fica ilegível
Prática recomendada: de 5 a 15 itens com uma estrutura especificada para cada item é o ponto ideal para a maioria dos casos de uso.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# Anti-pattern: no count, no structure
bad_prompt = 'Give me some ideas for blog posts about Python.'
# Good pattern: count + structure + ordering
good_prompt = (
'Generate 8 Python blog post title ideas. '
'Target audience: intermediate Python developers (2-3 years experience). '
'Mix: 4 practical how-to titles, 4 conceptual deep-dive titles. '
'Label each [HOW-TO] or [DEEP DIVE]. '
'Each title: max 10 words. No clickbait.'
)
for label, prompt in [('BAD', bad_prompt), ('GOOD', good_prompt)]:
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{'role': 'user', 'content': prompt}]
)
print(f'--- {label} ---')
print(response.content[0].text.strip())
print()Saída de listas em contextos programáticos
Ao usar IA para gerar listas que serão processadas por código, solicite a saída em um formato analisável por máquina:
- Matriz JSON: 'Exiba como uma matriz JSON de cadeias de caracteres'
- Um item por linha: 'Exiba exatamente um item por linha, sem marcadores e sem números'
- CSV: 'Exiba como uma única linha separada por vírgulas'
Isso evita a necessidade de analisar os marcadores do Markdown na cadeia de resposta.
import openai
import json
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'List 8 Python standard library modules that every developer should know. '
'Output as a valid JSON array of strings only. '
'No explanation, no formatting, no markdown — just the raw JSON array.'
)
}]
)
raw = response.choices[0].message.content.strip()
try:
modules = json.loads(raw)
print(f'Parsed successfully: {len(modules)} modules')
for m in modules:
print(f' - {m}')
except json.JSONDecodeError as e:
print(f'Parse error: {e}')
print('Raw output:', raw)Verificação de conhecimento
Uma pessoa líder de equipe quer gerar uma lista de itens de ação a partir de um assistente de IA. Ela envia: 'Dê-me alguns itens de ação.' O resultado são 4 itens vagos com marcadores. Qual reformulação produz a saída mais útil?
Recapitulação: solicitando listas
As listas são um dos formatos de saída mais claros que você pode solicitar. Para dominar as solicitações de listas, especifique:
- Quantidade exata: forneça sempre um número, não 'alguns' ou 'poucos'
- Formato: marcadores, números, lista de verificação, aninhada
- Estrutura de cada item: uma frase / duas frases / título + descrição
- Rótulos: dificuldade, tempo, equipe, categoria
- Ordenação: mais importante primeiro, classificada por X, alfabética
- Formato para máquina: matriz JSON ou um item por linha para uso programático
Perguntas Frequentes
A aula “Solicitando listas e tópicos” é grátis?
Sim — o texto completo de “Solicitando listas e tópicos” é 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 AI Prompt Engineering, atualize para CoddyKit PRO. O curso de AI Prompt Engineering inclui 4 aulas no total.
O que vou aprender em “Solicitando listas e tópicos”?
Peça à IA listas numeradas ou com marcadores e uma quantidade específica de itens. Você pratica AI Prompt Engineering 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 AI Prompt Engineering?
Nenhuma experiência prévia é necessária. AI Prompt Engineering 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 1 de 4.
Quanto tempo leva a aula “Solicitando listas e tópicos”?
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 AI Prompt Engineering?
Sim. Cada aula de AI Prompt Engineering 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
- Solicitando listas e tópicos
- Solicitando tabelas e dados estruturados
- Formatação markdown nas solicitações
- Texto simples versus resultado formatado