Workshop: Criação de um Prompt de Especialista
Nesta página
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:
- Completude: Todas as secções do formato foram preenchidas?
- Relevância: Os riscos identificados são reais e devidamente avaliados?
- Consistência: A pontuação de risco é consistente com os riscos listados?
- 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.