Como pedir listas, relatórios e totais ao Copiloto
Para que serve?
Na janela do Copiloto pode escrever, como diria a um colega, o que quer saber dos números da empresa: «Quanto faturei em setembro?», «Que faturas de fornecedores vencem esta semana?». Com a IA ligada, o Copiloto envia o pedido a um fornecedor de IA e responde com os valores que as consultas devolvem; também pode preparar rascunhos (um cliente, uma fatura). Essa resposta ainda não foi validada no ecrã (veja «Resultado esperado»). Este artigo mostra o que é preciso ligar, como testar a ligação e o que acontece quando a IA não pode ser chamada.
Sem a IA, a mesma janela continua a dar a ajuda passo a passo (veja Como tirar dúvidas na janela do Copiloto).
Quando utilizar?
- Quer um total ou uma lista sem procurar o ecrã certo.
- Quer saber o que está por receber, por pagar ou em atraso.
- Quer preparar um rascunho de um documento a partir de uma frase.
Onde encontrar?
- A conversa: o ícone Copiloto na barra de cima, opções Perguntar aos números, Abrir uma lista e Criar um relatório.
- Uma pergunta só sobre números, numa janela à parte: Contabilidade › Consultar › Análise › Perguntar aos números.
- O que é preciso ligar: Copiloto › Controlo › Interruptores, Copiloto › Ligações às IAs › Ligações e Copiloto › Ligações às IAs › Definições da IA.
Antes de começar
A conversa só usa a IA quando as quatro condições abaixo estão cumpridas. As três primeiras são da Administração fiscal (ou do administrador do sistema); as perguntas fazem-se com o perfil Contabilista.
- Uma ligação à IA com a chave da empresa. Veja Como ligar o Copiloto a um fornecedor de IA.
- Os interruptores ligados em Copiloto › Controlo › Interruptores: Copiloto (interruptor geral da empresa), Ligação à IA (chamadas ao fornecedor de IA) e IA - Conversa (responde com dados e cria rascunhos) para a janela do Copiloto, ou IA - Perguntas sobre os números para o menu Perguntar aos números da Contabilidade. Os da IA são do tipo Para fora e vêm desligados. Veja Como ligar ou desligar o Copiloto e controlar os dados enviados.
- Um limite de gasto da empresa. Em Definições da IA, o Limite mensal de gasto da empresa (EUR) vem a 0,00, e 0 quer dizer bloqueado: enquanto não escrever um valor, a IA nunca é chamada.
- Uma base de dados de produção. Numa base de testes o fiscaldoo não chama a IA (veja «Notas importantes»).
Como utilizar
Testar a ligação (Administração fiscal)
- Abra Copiloto › Ligações às IAs › Ligações e a ligação da empresa. Confirme que Chave guardada está marcada.
- Carregue em Testar a ligação. O fiscaldoo faz a chamada mais pequena possível ao fornecedor (uma palavra, sem dados da empresa).
- Leia a mensagem. Com uma chave aceite, numa base de produção, a mensagem diz que a ligação funciona e com que modelo o fornecedor respondeu (não visto: a demonstração é uma base de testes). Com uma chave recusada: «A ligação falhou. O fornecedor recusou a chave (HTTP 401). Nada foi alterado. Escreva uma chave nova na ligação e teste de novo.»
Fazer um pedido (Contabilista)
- Carregue no ícone Copiloto da barra de cima.
- Carregue em Perguntar aos números (ou Abrir uma lista, ou Criar um relatório). O campo Escreva a sua dúvida… fica com um exemplo, como «Quanto faturei este mês?».
- Mude o texto para o que quer saber, por exemplo «Quanto faturei em setembro?», e carregue em Perguntar.
Também pode abrir Contabilidade › Consultar › Análise › Perguntar aos números, escrever em A sua pergunta e carregar em Perguntar. Com o interruptor IA - Perguntas sobre os números desligado, a janela diz «Este agente está desligado…» e o botão Perguntar fica inativo.
Resultado esperado
Pendente de validação no ecrã: a resposta de um fornecedor de IA real. A demonstração é uma base de testes e o fiscaldoo não chama a IA a partir dela; o que está abaixo vem do produto (o código e o guia do Copiloto) e não foi visto.- Com a IA a funcionar: o Copiloto responde com o valor e, por baixo, de onde vem e o botão para abrir a lista dos documentos que o formam. Pode pedir faturas (de clientes ou de fornecedores, por período, em atraso ou por pagar), o que há a receber e a pagar, vendas por cliente, faturas de fornecedores a vencer, o balancete ou o extrato de uma conta. Se pedir para criar, aparece um cartão com o rascunho, que abre e confirma no ecrã do documento.
- Cada chamada fica registada em Copiloto › Controlo › Chamadas à IA: quem, a ligação, o resultado, os tipos de dados enviados e o custo estimado, sem o conteúdo (veja Como ver o que o Copiloto fez e o que enviou à IA).
- Quando a IA não pode ser chamada, a janela diz porquê e responde com a pesquisa na documentação e nos menus: «A conversa não pôde usar a IA, por isso este é o resultado da pesquisa.» seguido do motivo, e no fim «Resposta obtida por pesquisa na documentação e nos menus.». Na demonstração, com tudo ligado, o motivo foi a base de testes:
Notas importantes
- Numa base de testes a IA não é chamada, a menos que o administrador do sistema a tenha permitido nessa base. Em Perguntar aos números da Contabilidade aparece a janela Operação inválida com o mesmo texto. A conversa responde «A IA não é chamada a partir de um ambiente de teste. Nada foi enviado. Use a base de dados de produção, ou peça ao administrador de sistema que permita a IA nesta base de testes.», e Chamadas à IA regista a tentativa como bloqueada («Ambiente de teste: a IA nunca é chamada.»).
- O Testar a ligação numa base de testes não sai do servidor (com a mesma exceção). Responde um simulador: «A ligação funciona. Teste simulado: esta é uma base de teste, por isso nada saiu do servidor e nenhum fornecedor real foi chamado. O simulador aceitou a chave.» O simulador só serve para o teste da ligação: não responde a conversas.
- O Copiloto nunca valida, envia nem paga. Um pedido desses é recusado antes de chegar à IA, e diz-lhe onde o fazer.
- Dados reservados não saem, por omissão. Perguntas sobre saúde (baixas por doença), sindicatos ou greves não são enviadas à IA, a menos que a Administração fiscal tenha marcado Autorizar dados pessoais e sensíveis nesta ligação na ligação à IA: nesse caso, seguem para o fornecedor. Senhas e chaves nunca são enviadas. A recusa diz «Isto fala de saúde, sindicato, greve ou palavras-passe, e isso nunca sai do produto, por isso não o enviei à IA.» ou, quando há artigos da documentação sobre o tema, «Esta pergunta fala de credenciais ou de dados reservados, por isso não a enviei à IA. Estes são os artigos da documentação mais próximos.»
- Os números vêm das consultas, feitas com as suas permissões e só na empresa ativa: o que não pode ver, o Copiloto também não vê. Confira o valor na lista que ele abre. (Vem do código do produto; ainda não foi visto com uma IA real.)
Problemas frequentes
«O limite mensal de gasto com IA da empresa … (0,00 EUR) seria ultrapassado»
- Sintoma: a resposta começa por «A conversa não pôde usar a IA…» e diz «O limite mensal de gasto com IA da empresa "…" (0,00 EUR) seria ultrapassado: já foram usados 0,00 EUR este mês. Nada foi enviado.»
- Causa: o limite da empresa está a 0,00 (bloqueado) ou foi atingido este mês.
- O que fazer: peça à Administração fiscal que escreva um limite em Copiloto › Ligações às IAs › Definições da IA, Limite mensal de gasto da empresa (EUR), ou espere pelo mês seguinte.
«O fornecedor recusou a chave (HTTP 401)»
- Sintoma: Testar a ligação diz «A ligação falhou. O fornecedor recusou a chave (HTTP 401)…».
- Causa: a chave está errada ou foi anulada na conta do fornecedor.
- O que fazer: escreva a chave certa em Chave de API / token de acesso, guarde e teste outra vez.
«Não posso fazer isso, nem vou poder: só preparo rascunhos»
- Sintoma: pediu para validar, enviar, pagar ou apagar e o Copiloto responde «Não posso fazer isso, nem vou poder: só preparo rascunhos.» e diz onde o fazer.
- Causa: é a regra do Copiloto, não um erro.
- O que fazer: faça-o no ecrã do documento, por exemplo com o botão Confirmar.