Saltar para o conteúdo principal
As credenciais são chaves de API e tokens que os seus agentes usam para iniciar sessão em serviços de terceiros em seu nome. São guardadas encriptadas e, depois de guardado, o valor pode ser substituído, mas nunca lido novamente. Gere as credenciais em Settings > Credentials.

Adicionar uma credencial

1

Abra as definições de credenciais

Aceda a Settings > Credentials a partir da barra lateral.
2

Clique em Add credential

O botão Add credential abre uma janela onde dá um nome à credencial e cola o respetivo valor.
3

Dê um nome e guarde

Introduza um nome como NOTION_TOKEN. Os nomes têm de começar por uma letra e conter apenas letras, dígitos e underscores. Cole o valor e clique em Add. O valor é guardado encriptado e nunca volta a ser mostrado.
As credenciais geridas (por exemplo, as criadas por uma integração como o Telegram) não podem ser editadas nesta página. Mostram uma etiqueta Managed by e uma ligação para a integração a que pertencem.

Conceder credenciais aos agentes

Por predefinição, nada é concedido, e All agents nunca inclui a Maya. Tem de escolher explicitamente que agentes podem usar cada credencial.

Ativar para todos os agentes (exceto a Maya)

Na página Credentials, ative o interruptor All agents ao lado de uma credencial. Assim, concede-a a todos os agentes personalizados que tem. A Maya fica excluída e tem de lhe ser concedida à parte, se quiser que a use.

Conceder a agentes específicos

  1. Clique na etiqueta de acesso ao lado de uma credencial (mostra o número atual de agentes).
  2. Na janela Manage Credential Access, selecione os agentes a quem quer conceder a credencial.
  3. Clique em Save.
Os agentes que herdam o acesso do interruptor All agents mostram a etiqueta via All agents. Se desmarcar um desses agentes, é registada uma exceção explícita em vez de ser removida uma concessão direta.

Rodar uma credencial

Se uma chave expirar ou ficar comprometida, pode substituí-la:
  1. Clique no ícone de rodar ao lado da credencial.
  2. Cole o novo valor na janela Replace credential.
  3. Clique em Replace. O novo valor é guardado e todos os agentes com acesso recebem-no no turno seguinte.
O valor atual não pode ser mostrado. Rodar a credencial é a única forma de alterar uma credencial guardada.

Eliminar uma credencial

  1. Clique no ícone de eliminar ao lado da credencial.
  2. Confirme na janela. A credencial é removida definitivamente e todos os agentes que tinham acesso perdem-no de imediato.
A eliminação é irreversível. Não é possível recuperar o valor, e os agentes que o usavam deixam de funcionar com esse serviço até adicionar uma nova credencial.

Pedidos de credenciais no chat

Por vezes, um agente precisa de uma credencial que não tem. Nesse caso, envia um pedido de credenciais (credential request) no chat, a pedir-lhe as chaves específicas de que precisa. Quando vir um cartão de pedido de credenciais:
  1. Reveja os nomes das credenciais que estão a ser pedidas.
  2. Escolha se quer introduzir valores novos ou reutilizar os que já guardou.
  3. Clique em Save. Os valores são guardados e concedidos ao agente que os pediu, e o agente retoma automaticamente.
O agente apenas fica a saber que nomes de credenciais foram fornecidos. Os valores reais nunca passam pelo chat.

Notas de segurança

  • Os valores são encriptados antes de chegarem à base de dados.
  • Nenhum endpoint devolve o valor de uma credencial, nem mesmo ao seu proprietário.
  • Os últimos quatro caracteres são mostrados apenas para o ajudar a reconhecer a chave guardada.
  • As credenciais geridas são tratadas pela integração a que pertencem e devem ser alteradas na página de definições dessa integração.

Próximos passos

Ligar aplicações

Ligue aplicações que usam estas credenciais.

Skills

Instale skills que podem precisar de credenciais.

Browsers

Emparelhe um browser para aceder à web.