> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolmena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar e gerir credenciais para os seus agentes

> Guarde credenciais encriptadas, conceda-as a agentes específicos e responda a pedidos de credenciais a partir do chat. Os valores nunca voltam a ser mostrados depois de guardados.

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.

> [!NOTE]
>
> 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.

> [!WARNING]
>
> 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.

> [!WARNING]
>
> 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

> [card] [Ligar aplicações](https://docs.kolmena.ai/pt/integrations/connect-apps.md)
>
> Ligue aplicações que usam estas credenciais.

> [card] [Skills](https://docs.kolmena.ai/pt/integrations/skills.md)
>
> Instale skills que podem precisar de credenciais.

> [card] [Browsers](https://docs.kolmena.ai/pt/integrations/browsers.md)
>
> Emparelhe um browser para aceder à web.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.