Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Workshop: Criação de um Prompt de Especialista

Aula 13 de 14 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Objetivo do Workshop
  2. O Projeto: Assistente de Análise de Contratos
  3. Passo 1: Definir a Mensagem do Sistema
  4. Passo 2: Estruturar o Formato de Saída
  5. Passo 3: Adicionar Exemplos Few-Shot
  6. Passo 4: Calibrar Parâmetros
  7. Passo 5: Testar e Iterar
  8. Passo 6: Documentar o Prompt Final
  9. Coloque em Prática
  10. Pontos-chave

Objetivo do Workshop

Este workshop guia-o passo a passo na construção de um prompt de especialista completo. Vai criar um assistente especializado para um caso de uso real, aplicando todas as técnicas abordadas neste curso: papéis, parâmetros, few-shot prompting, cadeia de pensamento (chain of thought) e instruções de sistema estruturadas.

No final deste workshop, terá um prompt pronto para produção, apto a ser integrado nas suas ferramentas ou fluxo de trabalho.

O Projeto: Assistente de Análise de Contratos

Vamos construir um assistente capaz de analisar contratos comerciais e extrair informações-chave, riscos e pontos de negociação.

Este caso de uso combina várias técnicas: extração estruturada, análise crítica e redação de recomendações.

Passo 1: Definir a Mensagem do Sistema

Comece com o esqueleto da mensagem do sistema. Identifique as secções necessárias:

You are an in-house counsel specializing in French commercial law, with 10 years of experience negotiating B2B contracts.

## Mission
You analyze commercial contracts and provide a structured assessment including: key clauses, identified risks, recommended negotiation points, and an overall risk score.

## Context
You work for a French SME in the technology sector (50 employees, €8 million annual revenue). The contracts analyzed are primarily vendor contracts, service agreements, and partnership deals.

## Constraints
- Always respond in English
- Base your analysis on French commercial law
- Systematically flag any clause that is unusual or unfavorable
- Clearly indicate when an analysis requires validation by a lawyer
- Never provide definitive legal advice

## Output Format
[to be defined in the next step]

Teste esta mensagem do sistema com um texto de contrato simples. Observe o formato de resposta padrão e identifique o que deseja melhorar.

Passo 2: Estruturar o Formato de Saída

Após o primeiro teste, defina o formato esperado com precisão:

## Output Format

### 1. Summary (3-5 lines)
Contract type, parties, main subject, duration.

### 2. Key Clauses
For each important clause:
- **Title**: clause name
- **Summary**: what it stipulates (1-2 lines)
- **Assessment**: favorable / neutral / unfavorable
- **Comment**: why this assessment

### 3. Identified Risks
Numbered list, from most critical to least critical:
- Risk description
- Severity: critical / high / moderate / low
- Mitigation recommendation

### 4. Negotiation Points
The 3-5 points to prioritize in negotiation, with a suggested alternative wording.

### 5. Overall Risk Score
Rating from 1 (very low) to 10 (very high) with a 2-line justification.

Volte a testar com o mesmo contrato. O resultado deve agora estar estruturado e ser imediatamente acionável.

Passo 3: Adicionar Exemplos Few-Shot

Para calibrar a qualidade das avaliações, adicione um par de entrada/saída de exemplo à sua conversa:

[
  {"role": "system", "content": "[your complete system message]"},
  {"role": "user", "content": "Analyze this clause: 'The service provider commits to a guaranteed result obligation on all deliverables. Any delay will be penalized at 5% of the total amount per day of delay, without cap.'"},
  {"role": "assistant", "content": "### Clause: Guaranteed Result Obligation and Penalties\n- **Summary**: The provider is subject to a guaranteed result obligation (not best efforts) with delay penalties of 5% per day without cap.\n- **Assessment**: Unfavorable\n- **Comment**: The absence of a cap on penalties is a major risk. Under French law, uncapped penalties can exceed the total contract amount. Additionally, the guaranteed result obligation (vs. best efforts) transfers all risk to the provider. Recommendation: negotiate a penalty cap at 10–15% of the total amount and propose a reinforced best efforts obligation."},
  {"role": "user", "content": "[new contract to analyze]"}
]

Este exemplo mostra ao modelo o nível de detalhe e o tom esperados.

Passo 4: Calibrar Parâmetros

Para uma tarefa de análise que exige rigor e consistência:

{
  "model": "grok-4.20-0309-reasoning",
  "temperature": 0.3,
  "max_completion_tokens": 3000,
  "reasoning": {"effort": "high"}
}

Justificação das escolhas:

  • Modelo de raciocínio: A análise de contratos exige um raciocínio estruturado.
  • Temperatura baixa: Pretende-se rigor, não criatividade.
  • Tokens elevados: A análise completa de um contrato pode ser longa.
  • Esforço elevado: As nuances jurídicas exigem um raciocínio profundo.

Passo 5: Testar e Iterar

Teste o seu prompt com 3 a 5 contratos diferentes e verifique:

  1. Completude: Todas as secções do formato foram preenchidas?
  2. Relevância: Os riscos identificados são reais e devidamente avaliados?
  3. Consistência: A pontuação de risco é consistente com os riscos listados?
  4. Clareza: Um não jurista consegue compreender as recomendações?

Para cada problema identificado, ajuste uma coisa de cada vez:

  • Se os riscos forem subestimados: Adicione «Seja conservador na sua avaliação de riscos. Em caso de dúvida, classifique o risco num nível superior».
  • Se o formato se desviar: Adicione um segundo exemplo few-shot para reforçar a estrutura.
  • Se a análise for demasiado técnica: Adicione «Explique cada risco em termos compreensíveis para um executivo não jurista».

Passo 6: Documentar o Prompt Final

Assim que estiver satisfeito com o resultado, documente o seu prompt:

  • A mensagem do sistema completa
  • Os exemplos few-shot
  • Os parâmetros (modelo, temperatura, tokens)
  • Os casos de teste e os resultados obtidos
  • Os ajustes efetuados e o seu impacto

Este documento é a sua receita de prompt: permite-lhe reproduzi-lo, partilhá-lo ou adaptá-lo a um novo caso de uso.

Coloque em Prática

Aplique esta metodologia de 6 passos ao seu próprio caso de uso. Escolha um tema que domine bem, para que possa avaliar a qualidade das respostas. Itere até obter um resultado de qualidade profissional.

Pontos-chave

  • A construção de um prompt de especialista segue um processo de 6 passos: sistema, formato, exemplos, parâmetros, testes, documentação.
  • A mensagem do sistema é a base: invista tempo a estruturá-la corretamente.
  • Os exemplos few-shot calibram o nível de detalhe e o tom das respostas.
  • Teste com casos variados e ajuste um aspeto por iteração.
  • Documente o seu prompt final para o poder reproduzir e melhorar.