---
title: Conectar e controlar aplicativos de agente
description: Encontre um aplicativo de agente, escolha suas ferramentas permitidas, conecte-o e gerencie o acesso.
---

Os aplicativos de agente permitem que o Runner Agent use um serviço externo enquanto trabalha em seu projeto. Você
pode inspecionar as ferramentas do aplicativo e desativar as ferramentas que não deseja que o Agent use.

## Antes de começar

**Caminho de entrada:** **Projeto → Aplicativos → Agent Apps**

Os aplicativos de agente são condicionais. A seção pode estar oculta, um aplicativo individual pode estar
indisponível ou o catálogo pode falhar ao carregar. A disponibilidade pode variar por espaço de trabalho, projeto,
provedor e acesso ao produto em fases.

Você precisa de:

- acesso ao projeto;
- uma conta ou credencial aceita pelo provedor selecionado; e
- permissão para permitir que o Runner use as ferramentas que você deixar ativadas.

Revise cada ferramenta antes de conectar. O acesso à ferramenta se aplica ao projeto atual e pode
permitir que o Agent leia ou altere dados no serviço externo.

A conexão da conta externa pertence à sua conta Runner conectada, enquanto as opções de ferramentas
são salvas para o projeto atual. Desconectar pode, portanto, remover a conexão usada por
outros projetos, mesmo que suas escolhas de ferramentas sejam separadas.

## Encontrar e inspecionar um aplicativo

| Controle ou estado | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Pesquisar aplicativos** | Filtra aplicativos de loja e aplicativos de agente juntos. | O catálogo mostra nomes e descrições correspondentes. |
| Seletor de categoria | Restringe o catálogo de aplicativos de agente. | Escolha **Todos** para remover o filtro de categoria. |
| **Anterior** e **Próximo** | Move-se por um catálogo longo. | O Runner mostra a página anterior ou seguinte de aplicativos correspondentes. |
| Cartão do aplicativo | Mostra o nome do aplicativo, descrição e estado de conexão. | Selecioná-lo abre **Detalhes do aplicativo**. |
| **Nenhum aplicativo encontrado** | Mostra que os filtros atuais não têm correspondência. | **Limpar pesquisa** redefine a pesquisa e a categoria. |
| Espaços reservados de carregamento | Mostra que o Runner está buscando o catálogo. | Aguarde os cartões antes de escolher um aplicativo. |

## Controles de detalhes do aplicativo

| Controle ou estado | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| Descrição do aplicativo e categoria | Ajuda a confirmar que você abriu o serviço pretendido. | Nenhum acesso externo é concedido ao visualizar detalhes. |
| Opção de ferramenta | Limita o que o Runner pode pedir ao aplicativo conectado para fazer. | Antes de conectar, o Runner salva suas escolhas com a conexão. Após conectar, uma alteração é salva imediatamente. |
| **Anterior** e **Próximo** na lista de ferramentas | Revisa aplicativos com muitas ferramentas. | Move-se pelas ferramentas sem fechar o diálogo. |
| Campos de credencial obrigatórios | Suporta aplicativos que não usam autorização de navegador. | **Conectar** permanece indisponível até que os campos obrigatórios sejam preenchidos. Campos semelhantes a segredos são mascarados. |
| **Conectar** | Envia credenciais do provedor quando essa estratégia é necessária. | O Runner tenta a conexão com seu acesso à ferramenta escolhido. |
| **Conectar e autorizar** | Inicia a autorização do provedor. | O Runner abre uma janela de autorização. |
| **Conectando...** | Mostra que a autorização está em andamento. | A ação permanece indisponível até que o Runner receba um resultado. |
| **Conectado** | Confirma que o Runner reconhece a conta. | Feche o diálogo ou gerencie o acesso à ferramenta. |
| **Gerenciar** | Reabre um aplicativo conectado. | Revise e altere suas ferramentas ativadas ou desconecte-o. |
| **Desconectar** | Inicia a remoção. | O Runner pergunta **Tem certeza de que deseja desconectar?** |
| **Cancelar** ou **Confirmar** | Resolve o aviso de desconexão. | Cancelar mantém o acesso; Confirmar remove a conexão do aplicativo de agente no nível da conta do Runner. As configurações de ferramentas do projeto são separadas. |

## Conectar um aplicativo de agente

1. Abra **Projeto → Aplicativos** e role até **Apps de Agent**.
2. Pesquise o aplicativo ou escolha uma categoria.
3. Selecione o cartão do aplicativo para abrir **Detalhes do aplicativo**.
4. Leia sua descrição e inspecione cada ferramenta disponível.
5. Desative qualquer ferramenta que o Runner não deva usar neste projeto.
6. Digite as credenciais do provedor obrigatórias ou selecione **Conectar e autorizar**.
7. Conclua a etapa do provedor. Se seu navegador bloquear a janela de autorização, permita
   o pop-up para o Runner e comece novamente.
8. Retorne ao diálogo e confirme que diz **Conectado**.
9. Selecione **Gerenciar** mais tarde para revisar o acesso à ferramenta ou desconectar o aplicativo.

O diálogo de conexão afirma que as credenciais do provedor são enviadas através do serviço de conexão
e não são armazenadas pelo Runner. Você ainda deve tratar cada credencial como um segredo
e inseri-la apenas nos campos de credencial do aplicativo.

## Alterar acesso à ferramenta

1. Selecione **Gerenciar** no aplicativo conectado.
2. Encontre a ferramenta que deseja alterar.
3. Ative ou desative sua opção.
4. Aguarde **Ferramenta ativada** ou **Ferramenta desativada**.
5. Se o Runner mostrar **Falha ao atualizar ferramenta**, deixe o diálogo aberto, verifique o estado
   da opção atual após a atualização e tente novamente apenas se o estado salvo estiver claro.

Desativar uma ferramenta limita o uso dessa ferramenta pelo Runner. Não exclui dados criados anteriormente
no serviço externo.

## Reparar ou desconectar uma conexão

Se o catálogo não mostrar mais uma conexão utilizável, abra o aplicativo e inicie **Conectar** ou
**Conectar e autorizar** novamente, depois confirme **Conectado**.

Para remover o acesso, selecione **Gerenciar → Desconectar**, revise a confirmação e selecione
**Confirmar**. Isso remove a conexão do aplicativo de agente da conta conectada, não apenas o acesso
à ferramenta do projeto atual. Se a desconexão falhar, o Runner mantém o estado conectado; não assuma
que a conta externa foi removida.

## Se os aplicativos de agente estiverem faltando

- O recurso pode não estar ativado para o espaço de trabalho.
- Limpe a pesquisa e defina a categoria como **Todos**.
- Atualize os aplicativos se o catálogo nunca sair de seu estado de carregamento.
- Um aplicativo individual pode relatar que ainda não está disponível para conectar.
- Se a lista de ferramentas falhar, selecione **Tentar novamente** dentro de **Detalhes do aplicativo**.
- Nenhuma entrada de catálogo específica deve ser prometida até que apareça no espaço de trabalho atual.

## Guias relacionados

- [Visão geral de aplicativos e integrações](../apps-and-integrations)
- [Conectar, gerenciar e reconectar um aplicativo](./connect-manage-reconnect)
- [Solucionar problemas de conexão de um aplicativo](./troubleshooting)