Agente de gestão de contratos com IA e Hermes Agent

Pode utilizar um agente de gestão de contratos com inteligência artificial (IA) através do Hermes Agent, da Nous Research, depois de lhe dar a ligação certa. Num caso ilustrativo com dados fictícios, a nota de encomenda de uma agência para a Vantage, o seu sistema de gestão de relações com clientes (CRM, customer relationship management), renova a 1 de fevereiro com aviso prévio de 60 dias. O resumo semanal do agente avisa que a decisão deve ser tomada até 2 de dezembro. O agente encontra contratos nas suas pastas e na sua caixa de entrada, carrega-os num único repositório de contratos e mantém esse repositório atualizado de acordo com um horário. O Contracko trata da parte especializada: a análise de cada documento com IA, as datas, os lembretes e a revisão de riscos. O Hermes trata do trabalho operacional.

O Hermes Agent é o agente de código aberto da Nous Research [1]. Pode executá-lo por si próprio, num portátil, num pequeno servidor ou numa máquina na cloud, com o fornecedor de modelo que escolher, e conversar com ele no terminal ou em aplicações de conversação como Telegram e Slack [1]. Este guia dá ao Hermes um perfil de contratos próprio, liga o servidor do Model Context Protocol (MCP) do Contracko e configura tarefas cron que correm segundo um horário.

Porque merecem os contratos um perfil próprio

Um perfil Hermes é um agente separado na mesma instalação, com configuração, ficheiro de personalidade, memória, skills e tarefas cron próprios [1]. O trabalho com contratos tem as suas fontes, o seu ritmo e os seus erros a evitar, pelo que merece um perfil próprio.

Para uma pessoa, esse perfil acompanha subscrições, o arrendamento, o crédito à habitação e a apólice de seguro. Para uma empresa, funciona como um gestor de contratos interno: reúne cada acordo assinado, arquiva-o, completa os dados e assinala cada data de aviso antes de esta passar.

Na gestão de contratos com IA, a divisão de trabalho é o que mais importa. O Hermes e o modelo que o suporta não devem ler contratos nem extrair condições. O Contracko faz ele próprio a extração e a análise com IA: partes, datas, condições de renovação e de aviso, valor, responsabilidade, obrigações e riscos [4]. O Hermes faz o que faz um bom assistente:

• encontra documentos no disco, em pastas de armazenamento na cloud sincronizadas ou no email
• carrega-os no Contracko e verifica quando termina cada importação
• confirma que cada contrato ficou no tipo de contrato certo e, quando não ficou, corrige o tipo e pede ao Contracko que volte a ler o documento
• arquiva os contratos em pastas e preenche os contactos em falta das contrapartes
• configura lembretes, cria relatórios e indica o que exige atenção

Saiba como funciona a ligação em geral em o que é um servidor MCP de gestão de contratos.

Um agente de contratos Hermes em ação

A pasta contém, entre outros ficheiros, um acordo de tratamento de dados (DPA, data processing agreement) e uma nota de encomenda de um sistema de CRM. Segue-se um exemplo ilustrativo de uma conversa no Telegram, com empresas e dados fictícios. O utilizador pede ao perfil de contratos que processe uma pasta de digitalizações:

Import everything in ~/Contracts/2025-archive into Contracko. Wait for each import, check the contract types and file each contract under its client or supplier.

Ficheiro	Tipo de contrato	Pasta	Estado
Marlow Logistics framework.pdf	Acordo-quadro	Fornecedores / Marlow	Importado
Pinecrest Clinic DPA.pdf	Acordo de tratamento de dados	Clientes / Pinecrest	Importado, tipo alterado de "Outro"
Harbour St sublease.docx	Arrendamento de escritório	Instalações	Importado
Vantage CRM order form.pdf	Subscrição de software	Fornecedores / Vantage	Importado, renova automaticamente a 1 de fevereiro

O Hermes acrescenta que o acordo da Pinecrest foi inicialmente classificado como "Outro", pelo que alterou o tipo e pediu ao Contracko que o analisasse de novo. Os novos valores dos campos resultantes dessa segunda leitura aguardam a sua aprovação no Contracko [5]. Assinala ainda que a nota de encomenda da Vantage renova a 1 de fevereiro com aviso prévio de 60 dias, pelo que a decisão deve ser tomada até 2 de dezembro.

Configure o agente de contratos

O Hermes é gratuito e de código aberto, sob a licença do Massachusetts Institute of Technology (MIT) [1]. Os custos do modelo e do alojamento dependem da sua configuração. Fornecedores como OpenRouter ou OpenAI, ou uma subscrição Nous Portal, cobram pela utilização do modelo, e uma máquina na cloud tem custos. Um endpoint de modelo que execute por si, ou um portátil que já tenha, pode não implicar qualquer custo adicional [1]. Se ainda não instalou o Hermes, siga os passos no repositório Hermes Agent da Nous Research no GitHub.

Crie um perfil de contratos

Crie um perfil chamado contracts:

hermes profile create contracts

O perfil tem o seu próprio config.yaml, memória, skills, tarefas cron e gateway [1]. Descreva depois a tarefa no ficheiro SOUL.md do perfil. Mantenha o texto centrado no trabalho:

You run our contracts in Contracko. Keep the contract repository complete, filed and up to date. Import new signed agreements as they appear, check contract types, set reminders and tell me what needs attention. Quote the clause behind each finding, and never delete anything.

Não precisa de uma lista extensa de regras de aprovação. O Contracko pede a aprovação de uma pessoa antes de aplicar novos valores de campos resultantes de uma nova leitura e antes de alterar a partilha de um relatório. Pede-a também antes de eliminar um relatório ou um bloco de relatório, ou de criar ou revogar uma ligação de partilha de um contrato [5]. A skill do Contracko faz ainda com que o agente confirme primeiro as alterações em massa e o respetivo custo face à franquia do seu plano [2].

Ligue o servidor MCP do Contracko

O Hermes comunica com o Contracko através do Model Context Protocol (MCP), a norma aberta que os agentes de IA utilizam para trabalhar com outro software. Não existe um botão de um clique para o Hermes, mas o caminho mais curto aproxima-se disso: o Contracko publica um pacote para o Hermes com instruções de configuração, e o Hermes pode instalá-lo por si [2]. Estes passos seguem essas instruções publicadas. Inicie o perfil com hermes -p contracts e cole o pedido da página MCP do Contracko:

Fetch and follow the setup instructions for Contracko MCP at https://contracko.com/mcp/install/prompt.md

O Hermes instala o pacote contracko-hermes a partir das versões da biblioteca aberta de skills do Contracko e pede-lhe que o ative. Pergunta depois se pode adicionar o servidor MCP do Contracko ao config.yaml do perfil [2]:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Em seguida, inicia a autenticação. Também pode executá-la por si para o perfil de contratos e iniciar sessão no Contracko no navegador:

hermes -p contracts mcp login contracko

Num servidor sem navegador, faça a autenticação por Secure Shell (SSH). O Hermes indica como chegar ao endereço de retorno da autenticação ou como colar o endereço redirecionado [1]. Depois de iniciar sessão, recarregue o MCP ou reinicie o Hermes [2]. Peça então ao perfil que verifique a ligação ao Contracko; deve indicar o nome do espaço de trabalho em que iniciou sessão.

Quando o ecrã de consentimento do Contracko perguntar o que pretende autorizar, mantenha selecionadas as opções View contracts e Add and edit contracts [2]. A opção de adicionar e editar só é oferecida quando a sua função no espaço de trabalho o permite. Sem ela, o agente pode responder a perguntas, mas não pode importar, arquivar nem configurar lembretes.

O Contracko tem dois produtos:

• Contract management é o seu repositório de contratos: contratos, datas, lembretes, pastas, análises e relatórios. É o que o Hermes utiliza e nunca consome créditos Parser [2].
• Contracko Parser é uma ferramenta separada para processar documentos em massa sem os adicionar ao repositório. O seu agente de contratos não precisa dela.

Ainda não tem conta? O início de sessão permite-lhe começar uma avaliação gratuita sem cartão de crédito, ou pode começar pela página de preços.

A skill do Contracko está incluída

O Hermes suporta skills, as pastas de instruções que ensinam um agente a utilizar bem uma ferramenta. O pacote Contracko inclui a única skill do Contracko, contracko, pelo que o seu perfil já sabe como funcionam as importações, quando esperar por elas e como verificar tipos e datas. Se estabeleceu a ligação manualmente, instale a skill a partir da biblioteca aberta de skills do Contracko no GitHub [1]:

hermes -p contracts skills install contracko/contracko-skills/skills/contracko

Crie um repositório de contratos com acompanhamento

Um repositório central de contratos com acompanhamento é onde um agente Hermes demonstra o seu valor. Cada acordo fica num único espaço de trabalho, com datas e lembretes que continuam ativos quando o Hermes está inativo. Se a ideia for nova para si, comece por o que é um repositório de contratos.

Reúna todos os documentos

O Hermes lê e escreve ficheiros na máquina onde funciona. Indique-lhe uma pasta local ou uma pasta Google Drive, Dropbox ou OneDrive sincronizada com essa máquina. Para o email, adicione ao mesmo bloco mcp_servers um servidor MCP de email para a sua caixa de correio, que consiga pesquisar mensagens e ler anexos.

Find every signed contract under ~/Contracts and ~/Dropbox/Clients. Tell me how many files you found and wait for my go-ahead. Then import each one into Contracko, wait until every import has finished, and list any file that failed and why.

O Hermes carrega cada ficheiro e verifica até a importação terminar [5]. O Contracko lê o documento e cria o registo do contrato, associado a uma contraparte nova ou existente. A versão mais longa desta tarefa está em como importar e organizar contratos com MCP.

O Contracko sabe o que extrair

O acompanhamento de contratos só funciona com os campos certos. Quando um contrato entra, a IA do Contracko extrai os seus dados principais, como partes, datas e obrigações [4]. O registo do contrato inclui campos para condições de renovação e de aviso, valor anual e total, limites de responsabilidade e lei aplicável, preenchidos a partir dessa extração [5]. Os tipos de contrato podem ter campos personalizados próprios, que o Contracko consegue ler nos documentos desse tipo [5].

É nos pormenores que as folhas de cálculo falham. Uma data de fim não indica se um contrato renova. O Contracko regista separadamente a renovação automática e o respetivo período e acompanha o aviso de rescisão como um prazo antes da data de fim [3]. Os detalhes estão em datas contratuais e renovações automáticas.

Corrija tipos e pastas

Esta é a etapa que as pessoas saltam. Entregue-a ao agente:

Check every contract imported today. If the contract type is wrong, change it and ask Contracko to read the document again. Then file each contract in the right client, supplier or facilities folder, creating folders where needed, and list the re-reads waiting for my approval.

Depois de uma alteração de tipo, uma nova leitura propõe valores para os campos do novo tipo, de modo que um acordo de tratamento de dados recebe condições de tratamento e não condições genéricas. Aprova no Contracko quais as propostas a aplicar, e os campos guardados mantêm-se como estão até o fazer [5].

Lembretes e calendário

Depois de inseridas as datas, uma só mensagem configura lembretes para todo o repositório de contratos:

Add a reminder 21 days before the notice deadline of every contract that renews automatically, sent to me and to each contract's owner.

Os lembretes ficam no Contracko e chegam por email, pelo que são enviados mesmo que a sua gateway Hermes esteja desligada nessa semana [5]. Encontre mais pedidos para esta tarefa em lembretes de renovação de contratos com MCP.

O feed de calendário do Contracko coloca as datas de início, fim e aviso, bem como os lembretes, no Google Calendar, no Apple Calendar ou no Outlook [3]. Subscreva-o uma só vez: abra Calendar no Contracko, copie o endereço do feed e adicione-o à sua aplicação de calendário. O guia de configuração do calendário explica os passos.

Análise de contratos com IA para qualquer acordo

Faça uma pergunta sobre um único acordo e obtém uma resposta clara: a que o compromete, quais as datas relevantes, como circula o dinheiro e o que é invulgar. O Contracko já analisou o contrato, pelo que o Hermes responde com base nessa análise [4]. Como o seu SOUL.md o pede, o Hermes cita a frase que fundamenta cada ponto, a qual pode confrontar com o documento no Contracko.

Give me the Vantage CRM order form in five lines: term, renewal, notice, price changes and anything unusual.

Under the Pinecrest data processing agreement, how fast do we have to report a data breach?

Exemplo ilustrativo de resposta ao primeiro pedido, com dados fictícios:

Ponto	O que o Contracko encontrou	Cláusula
Duração	12 meses a partir de 1 de fevereiro, renovação anual	"This Order Form renews automatically for successive one-year terms."
Aviso	60 dias antes da renovação, por email	"Customer may cancel by written notice at least 60 days before renewal."
Invulgar	O número de licenças nunca pode diminuir	"Seat quantities may not be reduced during or at the end of a term."

É uma forma de usar IA para ler contratos sem os colar noutro local. A versão desta tarefa num assistente de conversação está em revisão de contratos com IA e MCP.

Revisão de riscos e obrigações com IA

A revisão de contratos com IA em toda a carteira coloca as mesmas perguntas a todos os acordos em simultâneo: onde estamos expostos e o que devemos, a quem e quando [4]?

Which supplier contracts have uncapped liability, one-sided indemnities or a termination right only for the supplier? Sort them by renewal date.

What do we owe clients in the next 60 days under our contracts: reports, audits, notices and payments?

Tabela ilustrativa de resultados para o segundo pedido, com dados fictícios:

Obrigação	Devida a	Prazo
Relatório anual de auditoria de segurança	Pinecrest Clinic	10 de janeiro
Certificado de seguro atualizado	Senhorio da Harbour St	31 de janeiro
Aviso com 30 dias de antecedência de qualquer alteração de subcontratante	Pinecrest Clinic	Antes da alteração

O Hermes lê a análise de riscos e obrigações do Contracko por contrato e, como as suas instruções pedem, cita a cláusula, para que possa verificar o texto antes de agir. Para uma visão mais ampla da disciplina, consulte gestão de riscos contratuais.

Relatórios que a sua equipa lê de facto

O Contracko cria relatórios a partir dos dados atuais da sua conta, e estes mantêm-se atualizados à medida que os contratos mudam [3]. O seu agente Hermes pode criar um relatório através de MCP a partir de um pedido em linguagem simples, agrupado por contraparte, tipo de contrato, estado ou responsável pelo contrato, com medidas como o valor anual [5]. Pode também partilhar um relatório com o seu espaço de trabalho ou com colegas indicados por nome, depois de o aprovar, porque as novas definições de partilha substituem as anteriores [5].

Create a Contracko report of all contracts renewing next quarter, grouped by contract owner, with annual value.

Quem o abrir no mês seguinte verá os números desse mês.

Cinco fluxos de trabalho com cron

O Hermes tem um agendador cron integrado. Pode criar tarefas em linguagem simples na conversa, com /cron add ou com hermes cron create, e escolher o destino dos resultados: a conversa de origem, o Telegram ou outra plataforma ligada, ou um ficheiro local [1]. As tarefas funcionam dentro da gateway Hermes, pelo que deve mantê-la em execução numa máquina que fique ligada. Cole um dos pedidos abaixo no perfil de contratos e adapte caminhos, horários e canais aos seus.

As tarefas que escrevem no Contracko continuam a seguir a skill do Contracko, que faz com que o agente confirme as alterações em massa e o respetivo custo antes de as fazer [2]. Por isso, as tarefas de escrita abaixo publicam primeiro um plano e agem com base na sua resposta. Crie-as na conversa em que pretende responder. Consoante a versão e as definições do seu Hermes, uma resposta no tópico da execução, no Slack ou nos tópicos do Telegram, continua a tarefa com todo o contexto [1]. Se não acontecer, peça ao perfil, numa nova mensagem, que execute o plano publicado. As tarefas que apenas leem, como o resumo, são executadas diretamente.

Importe tudo uma vez

Execute esta tarefa uma vez no arquivo completo. Funciona tanto para documentos pessoais como para o arquivo histórico de uma empresa.

Find every signed contract under ~/Contracts, ~/Dropbox and ~/Google Drive, and in the attachments in my mailbox. Tell me how many you found and wait for my go-ahead. Then import each one into Contracko that is not already there and wait until every import has finished. Check each contract type; fix any that are wrong and ask Contracko to read those documents again. File each contract in a folder per client, supplier or household category. Then send me a summary: how many you imported, what you filed where, which re-reads wait for my approval, and anything you could not import.

Acompanhe uma pasta para detetar novos contratos

Create a cron job that runs every weekday at 07:00. Check ~/Dropbox/Signed agreements for files added since the last run and post the list, with the contract type you expect for each. When I reply to confirm, import each file into Contracko, wait for the import to finish, check the contract type and file it in the right folder. If there are no new files, post "No new files".

Recolha contratos assinados na caixa de entrada

A gateway de email do Hermes recebe as mensagens enviadas ao agente; não pesquisa a sua caixa de correio existente [1]. Por isso, adicione primeiro ao mcp_servers do perfil um servidor MCP de email para a sua caixa de correio e verifique na respetiva documentação que consegue pesquisar mensagens anteriores e descarregar anexos. A primeira execução faz uma auditoria da caixa de correio. Depois disso, a tarefa procura acordos assinados que chegam como anexos e completa os dados da contraparte a partir da troca de emails.

First, search my mailbox for emails with a signed contract attached. List them and wait for my go-ahead, then import each confirmed contract into Contracko that is not already there. Then create a cron job that runs every day at 18:00, finds signed contracts attached to mail received since the last run and posts the list. When I confirm, import them, and add the counterparty's contact person, email address and role from the email to the counterparty in Contracko.

Receba um resumo semanal de prazos

Create a cron job for every Monday at 08:00. List every contract with a notice deadline or end date in the next 60 days, with the date and the decision I need to make. Add any contract imported last week that has no end date or no contract type. Deliver it to Telegram.

Partilhe relatórios com a equipa

Ligue primeiro o Slack à gateway do perfil de contratos. O cron do Hermes entrega ao seu canal principal do Slack ou a um canal através do respetivo identificador (ID) do Slack [1].

Create a Contracko report of all contracts renewing in the next quarter, grouped by contract owner, with annual value. Then create a cron job for the first weekday of each month at 09:00 that posts to Slack the contracts renewing next month, with each one's owner and annual value, and the name of the report in Contracko.

Execute cada tarefa manualmente uma vez e verifique o resultado no Contracko.

As capacidades e os limites do agente

O Hermes atua em seu nome, dentro do espaço de trabalho que escolheu ao iniciar sessão, e nunca pode abrir um contrato que não possa abrir pessoalmente [4]. Os registos que cria ou atualiza aparecem no histórico de atividade do Contracko, identificados como provenientes de MCP [4]. A partilha funciona de forma diferente. Com a sua aprovação, o agente pode partilhar um relatório com colegas. Pode também criar uma ligação de partilha de contrato com prazo limitado, que qualquer pessoa que a tenha pode usar, se puder gerir esse contrato e o seu plano incluir a partilha [5]. Uma ligação de partilha de relatório criada na aplicação Contracko também mostra o relatório a qualquer pessoa que tenha a ligação [3].

Não pode eliminar os seus contratos. O servidor MCP do Contracko não tem uma ferramenta para eliminar um contrato, um documento, uma pasta, uma contraparte ou um tipo de contrato; isso só acontece na aplicação Contracko [5]. O que pode remover limita-se a datas personalizadas, lembretes, relatórios, blocos de relatório e ligações de partilha de contratos, estas três últimas apenas após a sua aprovação [5]. Pode também editar os dados de um contrato, retirar um contrato de uma pasta e alterar a lista de campos personalizados de um tipo de contrato, por isso peça-lhe que lhe mostre uma alteração de tipo antes de a guardar.

Pode desligar o Hermes a qualquer momento no Contracko, em Settings, depois Integrations e MCP Connections. A documentação do servidor MCP explica os restantes detalhes, incluindo chaves da interface de programação de aplicações (API) para configurações que não podem usar autenticação no navegador [3].

Há uma ressalva específica do Hermes. É alojado por si, pelo que o token de início de sessão do Contracko fica na máquina onde o Hermes funciona, junto dos ficheiros que o agente pode ler [1]. Trate essa máquina como qualquer outro local que contenha uma chave de acesso aos seus contratos.

O Contracko não treina modelos com os seus contratos [4]. O Hermes envia texto contratual ao fornecedor de modelo que configurar, pelo que deve verificar os termos de dados desse fornecedor e desativar aí o treino de modelos, quando o fornecedor o permitir, antes de ligar contratos reais [4].

Porque é melhor ligar do que colar

Um agente sem ligação conhece apenas os documentos que recebeu por último e não distingue uma adenda assinada de um rascunho antigo. Através do Hermes MCP e do Contracko, trabalha sempre com os registos, as datas e as análises atuais. Assim, uma tarefa cron de segunda-feira descreve a carteira de hoje.

Perguntas frequentes

Como ligo o Hermes Agent a um servidor MCP de gestão de contratos?

Cole o pedido de configuração do Contracko no seu perfil de contratos. O Hermes instala o pacote, pergunta antes de adicionar o servidor MCP do Contracko ao config.yaml e inicia a autenticação. Num servidor sem navegador, o Hermes orienta-o na autenticação por SSH. Não é necessário código, mas deve estar à vontade para instalar o Hermes e editar um ficheiro de configuração.

Preciso de um plano ou de uma região específicos?

Não é necessário nenhum plano específico do Contracko: todos os planos incluem o servidor MCP sem custos adicionais [4]. O Hermes não tem plano próprio e funciona na máquina em que o alojar, pelo que os custos do modelo e do alojamento dependem da sua configuração [1].

Um agente ou vários?

Um perfil de contratos por cada espaço de trabalho do Contracko mantém tudo simples, porque cada início de sessão liga ao espaço de trabalho que escolher [4]. Os perfis são agentes separados, pelo que o seu restante trabalho com o Hermes mantém a memória e as instruções próprias [1].

Como acompanham as empresas automaticamente as datas de renovação de contratos?

Guardam cada contrato num repositório de contratos que regista cada data de renovação e de aviso, e deixam que os lembretes tratem de se lembrar. Com o Hermes e o Contracko, o agente importa os contratos, o Contracko extrai as datas, o agente configura lembretes no Contracko e uma tarefa cron semanal indica o que se aproxima.

Posso experimentar gratuitamente a revisão de contratos com IA antes de configurar o agente?

Sim. A ferramenta de revisão gratuita de contratos com IA do Contracko analisa um único documento. É separada do agente, que trabalha dentro da sua conta Contracko.

Os meus dados contratuais são usados para treinar modelos de IA?

Não pelo Contracko [4]. Quanto ao Hermes, depende do fornecedor de modelo que escolher, pelo que deve verificar os respetivos termos e desativar o treino onde puder.

Fontes

[1] Nous Research. Hermes Agent repository and documentation (licença, fornecedores de modelos, perfis, autenticação MCP, skills, cron e gateway de email). github.com/NousResearch/hermes-agent e hermes-agent.nousresearch.com/docs

[2] Contracko. Biblioteca de skills com o pacote Hermes, passos de configuração, ecrã de consentimento e regras da skill. github.com/contracko/contracko-skills

[3] Contracko. Documentação de ajuda sobre o servidor MCP, relatórios, datas contratuais e o feed de calendário. contracko.com/docs

[4] Contracko. Páginas do servidor MCP de gestão de contratos e da IA para contratos (acesso, histórico de atividade, planos, extração e utilização de dados). contracko.com/mcp/contract-management e contracko.com/features/contract-ai

[5] Contracko. Descrições de ferramentas publicadas pelo servidor MCP do Contracko em produção (importações, novas leituras, lembretes, relatórios, partilha e aprovações). app.contracko.com/mcp