Kartez Contract — elaboração, revisão e edição de contratos com IA
Interrompido pelo cliente a um mês da conclusão, por razões de financiamento ligadas à guerra. O relato de engenharia abaixo é a parte que sobreviveu ao contrato.
Em resumo
- O trabalho com contratos em persa exige uma IA que se mantenha presa ao documento sobre a mesa, porque uma cláusula inventada é um risco jurídico.
- Um assistente de elaboração, uma revisão escrita a partir da posição do usuário no negócio e um estúdio de contratos com um copiloto de edição.
- Interrompido pelo cliente a um mês da conclusão, por razões de financiamento ligadas à guerra.
Destaques
2.144 tipos de documento como ponto de partida
Cada tipo tem nome em persa, árabe e inglês, e a escolha de um deles traz sua estrutura típica e seus pontos-chave de atenção.
3 posições de negociação por pergunta
Agressiva, padrão ou de concessão, cada uma com exemplo de redação, efeito jurídico, impacto comercial e a provável reação da outra parte.
Revisão a partir da posição do usuário no negócio
O usuário informa seu papel e envia ou cola o contrato; cada constatação é escrita para essa posição, ao longo de uma jornada em 5 etapas.
Correções baseadas na própria redação do contrato
Cada correção precisa citar a redação atual palavra por palavra, para que o trecho possa ser localizado e substituído, e vem com texto substituto pronto para uso; as correções são ordenadas por prioridade.
Uma pontuação de saúde em 4 dimensões
Exequibilidade, clareza, equilíbrio e completude, cada uma pontuada de 0 a 100, com riscos classificados como críticos, altos, médios ou baixos.
Um copiloto que edita o contrato inteiro
Instruções em linguagem simples são planejadas, aplicadas a todas as seções afetadas e destacadas, com uma conversa salva para cada contrato.
O desafio
O trabalho com contratos não perdoa invenções. Um modelo que inventa uma cláusula é pior do que nenhum modelo, porque a cláusula inventada se torna um risco jurídico para quem assina. Um assistente útil precisa se manter preso ao contrato que está de fato sobre a mesa e apontar trechos dele que um profissional possa conferir.
O público trouxe restrições próprias. O Kartez Contract foi criado para advogados, empresas e pessoas físicas que trabalham em persa, com suporte também a árabe e inglês, e os contratos persas têm uma estrutura própria de artigos, cláusulas e notas. A interface precisava ser da direita para a esquerda desde a concepção, e toda resposta da IA precisava voltar no idioma do usuário.
Por fim, elaborar, revisar e editar são três trabalhos diferentes. Partir de uma página em branco, entender um acordo redigido por outra pessoa e alterar uma minuta no meio de uma negociação exigem, cada um, seu próprio fluxo guiado, e não uma única janela de conversa.
Arquitetura
Três fluxos guiados funcionam sobre um único motor de IA: elaboração, revisão e um estúdio de contratos. O motor roda como um serviço próprio, ao lado do serviço de contas e contratos, cada um com sua própria verificação de integridade. A recuperação acontece de duas formas, cada uma com uma finalidade diferente.
Recuperação na biblioteca para a elaboração. Os requisitos do usuário são convertidos em temas de pesquisa, e os trechos mais relevantes de uma biblioteca curada de textos em inglês sobre redação contratual são colocados diante do modelo enquanto ele escreve as perguntas e as minutas.
Recuperação de cláusulas para o copiloto. O próprio contrato do usuário é dividido segundo sua estrutura, incluindo os artigos, cláusulas e notas dos contratos persas, e apenas as seções relevantes para uma pergunta são usadas para respondê-la.
Toda análise retorna uma estrutura fixa, para que a interface possa exibir linhas do tempo, registros de riscos e correções de forma consistente, e uma resposta malformada é reparada quando possível e nunca é exibida em estado bruto. A biblioteca de referência é mantida sem código: documentos colocados na pasta de uma coleção são incorporados em uma sincronização, apenas arquivos novos ou alterados são reindexados, e as coleções podem ser ativadas ou desativadas.
O que eu construí
Os três fluxos compartilham uma regra: a IA propõe e o usuário decide. As correções sugeridas vêm com texto substituto pronto para uso, que pode ser aplicado a partir da própria revisão, e as edições do copiloto são destacadas no editor para que o usuário as aceite ou rejeite.
Assistente de elaboração
2.144 tipos de documento como ponto de partida, cada um com nome em persa, árabe e inglês e uma descrição, ou um tipo personalizado descrito com as palavras do próprio usuário.
Um briefing do tipo escolhido: visão geral, estrutura típica, pontos-chave de atenção e uma sugestão de jurisdição e de lei aplicável, com a justificativa.
Exatamente 7 perguntas em linguagem simples, cada uma com uma nota sobre por que ela importa, e uma revisão por IA que avalia as respostas e sugere respostas melhores antes do início da redação.
Me oriente, disponível em cada pergunta: 3 posições de negociação (agressiva, padrão e de concessão), cada uma com exemplo de redação, efeito jurídico, impacto comercial e a provável reação da outra parte.
6 estilos de redação (formal, simples, pró-comprador, pró-vendedor, detalhado e conciso), com a minuta aparecendo em tempo real no editor.
Revisão do ponto de vista do usuário
Uma jornada em 5 etapas: entrada; visão geral; riscos; correção e negociação; e, por fim, o estúdio. O usuário envia um arquivo PDF, DOCX ou TXT, ou cola o texto, e informa seu papel no negócio.
Visão geral: uma linha do tempo de prazos, pagamentos, renovações e gatilhos de notificação; um resumo executivo; e trechos das cláusulas-chave explicados em linguagem simples.
Riscos: um registro de riscos categorizado, com uma medida de mitigação para cada item, e uma leitura seção por seção de prós, contras e efeitos.
Correção e negociação: correções priorizadas, cada uma com a exigência de citar literalmente a redação atual e de fornecer texto substituto, além de um roteiro de negociação com estratégias colaborativas, assertivas e de meio-termo.
Estúdio de contratos e copiloto
Um copiloto que distingue perguntas de pedidos de edição, mostra seu progresso, responde com base nas cláusulas relevantes e é instruído a avisar quando precisa de seções que não lhe foram mostradas.
Edições no contrato inteiro em linguagem simples: uma instrução como renomear uma das partes é primeiro planejada, depois aplicada a todas as seções afetadas e destacada no editor.
Uma pontuação de saúde do contrato em 4 dimensões (exequibilidade, clareza, equilíbrio e completude), além de riscos classificados como críticos, altos, médios ou baixos.
Um relatório de riscos aprofundado com pelo menos duas redações alternativas para cada cláusula sinalizada, e um relatório gerado com um clique em 4 formatos: cópia, TXT, DOCX ou PDF.
Resultado
O cliente interrompeu o projeto um mês antes da conclusão, quando dificuldades financeiras ligadas à guerra cortaram o financiamento. Foi uma falha de financiamento do cliente, não uma falha de entrega.
Até então, o assistente de elaboração, o estúdio de contratos com seu copiloto, o pipeline da biblioteca de referência e a interface trilíngue estavam construídos e integrados de ponta a ponta, da interface ao motor de IA. A jornada de revisão foi construída em todas as cinco etapas; ainda não havia sido totalmente testada e continuava em refinamento quando o trabalho parou.
Post-mortem
Os problemas mais difíceis foram a recuperação e a ancoragem. O copiloto precisava encontrar as cláusulas certas dentro de contratos persas, com sua própria numeração de artigos, cláusulas e notas, e o assistente de elaboração precisava levar requisitos escritos em persa até uma biblioteca de textos em inglês sobre redação contratual.
Manter o modelo ancorado foi uma questão de estrutura, não de confiança: as respostas se baseiam apenas nas cláusulas selecionadas, as correções precisam citar literalmente a redação existente, as saídas seguem esquemas fixos e o modelo roda com baixa aleatoriedade durante a redação. São restrições de projeto, não uma garantia medida.
Nenhum índice de precisão é publicado aqui. O projeto parou antes que um conjunto formal de avaliação fosse construído, e este site não estima números que não mediu.
Meu papel
- Reconstruiu e ampliou o motor de IA por trás dos três fluxos (o assistente de elaboração, a jornada de revisão e o estúdio de contratos), partindo das primeiras cadeias básicas de IA do cliente.
- Construiu o pipeline da biblioteca de referência: ingestão, reindexação sensível a alterações, recuperação para a elaboração e controles para ativar ou desativar coleções.
- Construiu o copiloto agêntico que classifica cada solicitação, encontra as cláusulas relevantes e planeja edições em todo o contrato.
- Tornou o produto trilíngue e adaptado à escrita da direita para a esquerda, e levou para o assistente de elaboração o catálogo de tipos de documento com 2.144 entradas.
- Desenvolveu as tarefas em segundo plano com progresso em tempo real, a transmissão das minutas em tempo real, a exportação em quatro formatos e os builds de produção compilados.
- O login, as páginas de marketing, o faturamento e as primeiras cadeias básicas de IA vieram da base própria do cliente e não são creditados a este trabalho.
Engenharia
Ancorado no documento que tem diante de si
As respostas usam apenas as cláusulas relevantes, o copiloto é instruído a avisar quando precisa de seções que não lhe foram mostradas, e as correções precisam citar o texto literalmente.
Redação resiliente, sem texto repetido
Se a geração de temas ou a recuperação falhar, temas alternativos e um caminho sem recuperação mantêm a redação em andamento; uma minuta cuja transmissão já começou nunca é reexecutada, e assim nenhum texto se repete.
Saída estruturada que resiste a respostas ruins
As respostas passam por uma etapa de análise e reparo em vários estágios, incluindo o reparo de respostas cortadas, e são solicitadas novamente com mais espaço quando necessário.
Análises longas rodam em segundo plano
Análises pesadas rodam como tarefas em segundo plano, com progresso em tempo real, enquanto as minutas e as respostas do copiloto aparecem à medida que são escritas.
Separado, compilado e auditável
O motor de IA roda separado das contas e dos contratos, os builds de produção são distribuídos já compilados e todo prompt de redação e de pergunta é registrado para auditoria.
Resultados
- Interrompido pelo cliente a um mês da conclusão, por razões de financiamento ligadas à guerra: uma falha de financiamento, não de entrega.
- O assistente de elaboração, o estúdio de contratos, o copiloto e o pipeline da biblioteca de referência foram construídos e integrados de ponta a ponta.
- A jornada de revisão em cinco etapas foi construída, mas ainda não havia sido totalmente testada quando o trabalho parou.
- Nenhum índice de precisão é declarado: o projeto terminou antes que um conjunto formal de avaliação fosse construído.