Como criar e usar agentes do gabinete

Para que serve?

Um agente do gabinete é um assistente com instruções e fontes suas, por exemplo para responder a dúvidas de IVA com as notas internas do gabinete. Só sugere e explica, para uma pessoa verificar: não valida, não lança, não assina, não envia nem paga.

Quando utilizar?

• O gabinete repete as mesmas respostas e quer que partam dos seus textos.
• Quer mudar a forma como um agente de série responde.

Onde encontrar?

• Criar: Copiloto › Agentes › Agentes do gabinete.
• Mudar as instruções dos agentes de série: Copiloto › Instruções › Instruções dos agentes.
• Perguntar: painel que abre com a Contabilidade, grupo Listas de apoio, ligação Perguntar a um agente do gabinete, com o Modo gabinete ligado em Definições › Contabilidade › Gabinete de contabilidade. Também pode escrever agente do gabinete na caixa Pesquisar menu, na barra de cima; só aparece o que o seu perfil pode abrir. Com o Modo gabinete desligado, o Contabilista não encontra nada.

Antes de começar

• Para criar: o administrador do sistema (ou Administração fiscal). O Contabilista não vê estas entradas.
• Para perguntar: o perfil Contabilista e o Modo gabinete ligado.
• Para funcionar: os interruptores Copiloto (interruptor geral da empresa), Ligação à IA (chamadas ao fornecedor de IA) e IA - Agentes do gabinete, em Copiloto › Controlo › Interruptores, e uma ligação à IA pronta.
• Feito a 5 de novembro de 2026, na Empresa Demonstração, Lda, onde já existe o agente Assistente do IVA (exemplo), desligado.

Como utilizar

Criar um agente

1. Abra Copiloto › Agentes › Agentes do gabinete e carregue em Novo.
2. Escreva o Nome. Em Ligação à IA, escolha a ligação, ou deixe vazio para usar a Ligação por omissão.
3. Em Quem o pode usar, escolha os perfis que o podem usar.
4. No separador Instruções, escreva o que o agente deve fazer.
5. No separador Fontes, carregue em Adicionar uma linha e preencha Fonte e Texto, ou escolha um Ficheiro. Com Responder só com base nas fontes marcado, o agente só usa o que está aqui.
6. Marque Ligado quando estiver pronto e guarde. Um agente novo nasce desligado.

Fazer uma pergunta

1. Com o perfil Contabilista, abra Perguntar a um agente do gabinete.
2. Escolha o Agente do gabinete e escreva A sua pergunta.
3. Carregue em Perguntar ao agente.

Mudar as instruções de um agente de série

1. Abra Copiloto › Instruções › Instruções dos agentes e escolha o agente.
2. Em O meu texto, escreva a instrução. Por baixo vê o Texto original e as Regras sempre acrescentadas, que não se mudam.
3. Guarde. Vazio, O meu texto deixa o agente com o texto original.

Resultado esperado

O agente aparece na lista Agentes do gabinete e, ligado, na escolha da janela de perguntas.

Pendente de validação no ecrã: a resposta do agente. A demonstração é uma base de testes e o fiscaldoo não chama a IA a partir dela.

Notas importantes

• Saúde, greve e sindicato: escrever nas instruções não faz o agente ler estes dados. O que segue para a IA depende de Autorizar dados pessoais e sensíveis nesta ligação?, desligado por omissão: só com ele ligado os dados sobre saúde, filiação sindical ou greves seguem tal como estão. As credenciais nunca são enviadas. Veja Privacidade e consentimentos.
• Um agente é de uma empresa. Num grupo, crie-o em cada empresa.

Problemas frequentes

«Escolha primeiro o agente do gabinete. Não foi enviado nada…»

• Causa: carregou em Perguntar ao agente sem escolher o agente.
• O que fazer: escolha-o. Se a lista estiver vazia, peça ao perfil Administração fiscal que crie e ligue um agente.

«Não há no cofre nenhuma chave de API deste fornecedor para a empresa…»

• Causa: a ligação do agente não tem chave.
• O que fazer: peça ao perfil Administração fiscal que escreva a chave na ligação, ou que escolha outra ligação para o agente.

«Há campos obrigatórios por preencher…»

• Causa: guardou o agente sem Nome.
• O que fazer: preencha os campos assinalados a vermelho.