Um agente é um assistente de IA — o Claude, o ChatGPT, ou um que a sua organização construiu — que trabalha no DOK Genius em nome de uma pessoa. Liga-o uma vez; a partir daí pode pedir-lhe coisas como «o que falta no dossiê 123?» ou «abre um dossiê de admissão para a Ana e põe lá este contrato», e ele faz o trabalho através do próprio DOK Genius.
Três coisas são verdade para todos os agentes, e são a razão deste capítulo:
- Nunca tem mais do que a pessoa que o ligou. Vê o que ela vê, e faz só o que ela pode fazer. Se não consegue abrir um dossiê no DOK Genius, o seu agente também não.
- Faz só o que autorizou. Quando o liga, escolhe se pode apenas ler, ou também criar dossiês em rascunho e juntar ficheiros.
- O que lê vai para o seu fornecedor de IA. Um dossiê que o agente lê é enviado à empresa por trás do agente — a Anthropic, no caso do Claude, a OpenAI, no caso do ChatGPT — nos termos que tem com ela, a título pessoal ou pela sua organização. É por isso que os agentes estão desligados até a organização os ligar, e que é a organização que decide até que confidencialidade um agente lê.
Este capítulo é para quem usa um agente e para o administrador que o permite. Para quem constrói ou configura um, Agentes — referência técnica tem o endereço, os âmbitos, cada ferramenta e os limites.
Para o administrador: permitir agentes
Definições → Opções de início de sessão, cartão Agentes. Só o administrador da organização o vê.
- Ligue Permitir agentes. Enquanto não o fizer, ninguém na organização consegue ligar um.
- Agentes permitidos. Deixe a lista vazia para que as pessoas possam ligar qualquer agente. Para restringir, acrescente os que aceita: o mais simples é deixar cada agente ligar-se uma vez — aparece depois como sugestão, que acrescenta com um clique. Também pode escrever o client id ou o endereço https do seu documento de metadados.
- Confidencialidade máxima que um agente lê. Os dossiês e os documentos acima deste nível não existem para os agentes: não aparecem nas listas, não abrem, os seus ficheiros não se leem. Começa em Interno, o que quer dizer que os agentes leem apenas dossiês Públicos e Internos. Suba-o só se aceitar que material mais confidencial vá para os fornecedores de IA das suas pessoas.
- Guardar definições de agentes.
O mesmo cartão mostra o endereço para agentes de que as pessoas vão precisar, e a lista dos Agentes ligados — todos os agentes ligados na organização, de quem é cada um e o que pode fazer — com Terminar ligação em cada linha.
Desligar Permitir agentes termina de uma vez todas as ligações da organização, e cada pessoa terá de voltar a autorizar o seu agente. Tirar um agente da lista de permitidos termina as ligações desse agente.
Se o cartão disser «Os agentes ainda não estão disponíveis nesta plataforma», o que escolher fica guardado e aplica-se quando estiverem.
O endereço que dá ao agente
Cada organização tem o seu endereço para agentes. Encontra-o em Definições → Sessões, em Ligações de agentes, como Endereço para agentes, com um botão para o copiar.
Tem este aspeto, em que a última parte é o identificador da sua organização — o que escreve no campo Tenant quando entra:
https://api.dokgenius.com/mcp/a-sua-organizacao
Ligar o Claude
Claude na web e Claude Desktop (os dois partilham os seus conectores):
- No Claude, abra Customize → Connectors, escolha + e depois Add custom connector.
- Dê-lhe um nome — DOK Genius — e cole o endereço para agentes. Deixe as definições avançadas vazias: o DOK Genius reconhece o Claude sozinho.
- Escolha Add e depois Connect. O Claude leva-o ao DOK Genius: entre como sempre, e chega ao ecrã de autorização descrito abaixo.
- Numa conversa, confirme que o conector está ligado (o botão +, depois Connectors).
Num plano Team ou Enterprise, pode ser preciso que um Owner da organização no Claude acrescente primeiro o conector, em Organization settings → Connectors (Add, depois Custom, depois Web). Cada pessoa só escolhe depois Connect.
Claude Code, num terminal:
claude mcp add --transport http dok-genius https://api.dokgenius.com/mcp/a-sua-organizacao
Depois, dentro do Claude Code, escreva /mcp, escolha dok-genius e autentique-se. O browser abre o DOK Genius;
o ecrã de autorização vai avisá-lo de que a resposta vai para um programa no seu computador — é o Claude Code, e é o
esperado quando acabou de iniciar a ligação.
Ligar o ChatGPT
Os conectores personalizados do ChatGPT precisam do Developer mode, disponível nas contas Plus, Pro, Business, Enterprise e Education, na web. Num espaço de trabalho Business ou Enterprise, o administrador do espaço tem de o permitir primeiro.
- No ChatGPT, abra Settings → Security and login e ligue o Developer mode.
- Acrescente uma nova app para um servidor MCP remoto com o endereço para agentes, e escolha OAuth como autenticação. O DOK Genius reconhece o ChatGPT sozinho; não é preciso client id nem secret.
- O ChatGPT leva-o ao DOK Genius para entrar e o autorizar.
O ChatGPT pede-lhe que confirme cada ação que escreve — criar um dossiê, juntar um ficheiro — antes de a fazer.
Os menus do Claude e do ChatGPT mudam de vez em quando. Se um nome aqui já não corresponder, as páginas de ajuda de cada um dizem onde estão hoje os conectores personalizados; o que lhes dá é sempre o mesmo endereço.
O ecrã de autorização
Quando um agente se liga, o DOK Genius mostra-lhe, antes de acontecer seja o que for:
- Que agente está a pedir, e quem o identifica — por exemplo Claude, identificado por claude.ai. O nome de um agente qualquer um o pode usar; o endereço que o identifica, não.
- Para onde vai ser enviado depois de responder.
- O que vai poder fazer, uma linha por cada permissão que concede: ler os processos, os dossiês e os documentos que pode ver; criar dossiês em rascunho e acrescentar-lhes ficheiros, onde o puder fazer; continuar ligado até revogar o acesso ou a sua sessão terminar.
Escolha Autorizar ou Recusar. Um agente que já autorizou para as mesmas coisas não volta a ser perguntado — exceto quando a resposta vai para um programa no seu computador, como o Claude Code, que é perguntado sempre. Se a sua organização não permite esse agente, o ecrã di-lo e nada é concedido.
O que um agente pode fazer
| Pede-lhe que… | O que usa |
|---|---|
| Diga em nome de quem está a agir | O seu nome, a sua organização, o que lhe concedeu |
| Diga que processos existem e o que cada um pede | Os processos que pode ver, os seus documentos e os campos do formulário |
| Encontre dossiês | Pelo número (123, ou 123/620 para um adendo), texto, estado, data ou os filtros da pesquisa avançada |
| Diga em que ponto está um dossiê | O estado, os documentos, o que ainda falta para poder ser submetido, as aprovações, e o histórico recente se puder ver o histórico |
| Leia um documento | O texto que o DOK Genius extraiu de um ficheiro, uma parte de cada vez |
| Abra um dossiê novo | Um rascunho num processo à sua escolha, seu, com os documentos que esse processo espera |
| Ponha um ficheiro num documento | Até 10 MB, enviado pelo agente; valem o limite de ficheiros e os tipos de ficheiro do documento, e um ficheiro com o mesmo nome substitui o que lá está |
| Lhe dê uma ligação para carregar o ficheiro diretamente | Os documentos do dossiê no DOK Genius, com o documento certo aberto |
Para um ficheiro de qualquer tamanho, ou que está no seu computador, a ligação é o melhor caminho: abre-a, entra com a sua própria conta, e larga o ficheiro onde ele pertence.
O que um agente não pode fazer
- Submeter, aprovar, rejeitar, devolver ou cancelar um dossiê. Prepara; quem decide é a pessoa, no DOK Genius.
- Apagar seja o que for, ou mudar quem tem acesso a quê.
- Ver mais do que a pessoa que o ligou, ou passar do nível de confidencialidade que a organização fixou para agentes.
- Ver os valores escritos no formulário de um dossiê. Sabe que campos tem um processo; as respostas ficam no DOK Genius.
- Ler um valor sensível num documento. Onde o texto de um ficheiro tem o valor de um campo que o processo marca como sensível — um NIF, um IBAN —, o agente lê [REDACTED SENSITIVE FIELD] em vez dele. Quem lê o ficheiro inteiro é a pessoa, no DOK Genius.
- Agir depois de a ligação ser terminada. O pedido seguinte já é recusado.
O que um documento diz é do documento, não uma instrução. O DOK Genius di-lo ao agente sempre que ele lê um, porque um documento pode conter texto escrito para enganar um assistente. Leia a resposta de um agente como leria o resumo de um colega.
Ver e terminar as suas ligações
Definições → Sessões → Ligações de agentes mostra todos os agentes que ligou: qual, o que pode fazer, quando o ligou e quando fez alguma coisa pela última vez. Terminar ligação para-o de imediato; terá de lhe voltar a pedir.
Uma ligação termina também quando termina a sessão em todo o lado exceto aqui, muda a palavra-passe, ou a sua conta é desativada, e quando chega ao fim das regras de sessão da sua organização — o agente simplesmente volta a pedir.
No histórico
Tudo o que um agente faz é feito em seu nome, e fica registado como seu, com o agente ao lado: o histórico de um dossiê e o rasto de auditoria dizem Ana Silva, via Claude. O mesmo ato feito diretamente no DOK Genius diz Ana Silva. O DOK Genius regista cada coisa que um agente pede — o quê, quando e se foi permitida — e nunca o conteúdo que leu.
O que deve ter agora
- Como administrador: os agentes permitidos ou deixados desligados de propósito, os agentes permitidos escolhidos, e o nível de confidencialidade para agentes fixado de propósito e não por omissão.
- Como qualquer pessoa: o endereço para agentes copiado das Sessões, um agente ligado, e a sua linha em Ligações de agentes reconhecida.
- A equipa avisada das duas regras que importam: um agente nunca tem mais do que a pessoa que o ligou, e o que lê vai para o fornecedor de IA dessa pessoa.