Conectar e controlar aplicativos de agente
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
- Abra Projeto → Aplicativos e role até Apps de Agent.
- Pesquise o aplicativo ou escolha uma categoria.
- Selecione o cartão do aplicativo para abrir Detalhes do aplicativo.
- Leia sua descrição e inspecione cada ferramenta disponível.
- Desative qualquer ferramenta que o Runner não deva usar neste projeto.
- Digite as credenciais do provedor obrigatórias ou selecione Conectar e autorizar.
- Conclua a etapa do provedor. Se seu navegador bloquear a janela de autorização, permita o pop-up para o Runner e comece novamente.
- Retorne ao diálogo e confirme que diz Conectado.
- 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
- Selecione Gerenciar no aplicativo conectado.
- Encontre a ferramenta que deseja alterar.
- Ative ou desative sua opção.
- Aguarde Ferramenta ativada ou Ferramenta desativada.
- 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.