Conectar y controlar aplicaciones de agente
Encuentra una aplicación de agente, elige sus herramientas permitidas, conéctala y gestiona el acceso.
Las aplicaciones de agente permiten que el Agente de Runner use un servicio externo mientras trabaja en tu proyecto. Puedes inspeccionar las herramientas de la aplicación y desactivar las herramientas que no deseas que use el Agente.
Antes de empezar
Ruta de acceso: Proyecto → Aplicaciones → Aplicaciones de agente
Las aplicaciones de agente son condicionales. La sección puede estar oculta, una aplicación individual puede no estar disponible, o el catálogo puede no cargar. La disponibilidad puede variar según el espacio de trabajo, proyecto, proveedor y acceso al producto por fases.
Necesitas:
- acceso al proyecto;
- una cuenta o credencial aceptada por el proveedor seleccionado; y
- permiso para que Runner use las herramientas que dejes habilitadas.
Revisa cada herramienta antes de conectar. El acceso a las herramientas se aplica al proyecto actual y puede permitir que el Agente lea o cambie datos en el servicio externo.
La conexión de la cuenta externa pertenece a tu cuenta de Runner con sesión iniciada, mientras que los cambios de herramientas se guardan para el proyecto actual. Desconectar puede, por lo tanto, eliminar la conexión utilizada por otros proyectos aunque sus opciones de herramientas sean separadas.
Buscar e inspeccionar una aplicación
| Control o estado | Por qué es útil | Qué sucede después |
|---|---|---|
| Buscar aplicaciones | Filtra aplicaciones de tienda y aplicaciones de agente juntas. | El catálogo muestra nombres y descripciones coincidentes. |
| Selector de categoría | Reduce el catálogo de aplicaciones de agente. | Elige Todas para eliminar el filtro de categoría. |
| Anterior y Siguiente | Se mueve a través de un catálogo largo. | Runner muestra la página anterior o siguiente de aplicaciones coincidentes. |
| Tarjeta de aplicación | Muestra el nombre de la aplicación, descripción y estado de conexión. | Seleccionarla abre Detalles de la aplicación. |
| No se encontraron aplicaciones | Muestra que los filtros actuales no tienen coincidencia. | Borrar búsqueda restablece la búsqueda y categoría. |
| Marcadores de posición de carga | Muestra que Runner está obteniendo el catálogo. | Espera a las tarjetas antes de elegir una aplicación. |
Controles de detalles de la aplicación
| Control o estado | Por qué es útil | Qué sucede después |
|---|---|---|
| Descripción de la aplicación y categoría | Ayuda a confirmar que abriste el servicio previsto. | No se otorga acceso externo al ver detalles. |
| Cambio de herramienta | Limita lo que Runner puede pedirle a la aplicación conectada que haga. | Antes de conectar, Runner guarda tus opciones con la conexión. Después de conectar, un cambio se guarda inmediatamente. |
| Anterior y Siguiente en la lista de herramientas | Revisa aplicaciones con muchas herramientas. | Se mueve a través de herramientas sin cerrar el diálogo. |
| Campos de credencial requeridos | Admite aplicaciones que no usan autorización del navegador. | Conectar permanece no disponible hasta que se completen los campos requeridos. Los campos similares a secretos están enmascarados. |
| Conectar | Envía credenciales del proveedor cuando esa estrategia es requerida. | Runner intenta la conexión con tu acceso a herramientas elegido. |
| Conectar y autorizar | Inicia la autorización del proveedor. | Runner abre una ventana de autorización. |
| Conectando... | Muestra que la autorización está en progreso. | La acción permanece no disponible hasta que Runner reciba un resultado. |
| Conectado | Confirma que Runner reconoce la cuenta. | Cierra el diálogo o gestiona el acceso a herramientas. |
| Gestionar | Reabre una aplicación conectada. | Revisa y cambia sus herramientas habilitadas o desconéctala. |
| Desconectar | Inicia la eliminación. | Runner pregunta ¿Estás seguro de que deseas desconectar? |
| Cancelar o Confirmar | Resuelve la advertencia de desconexión. | Cancelar mantiene el acceso; Confirmar elimina la conexión de la aplicación de agente a nivel de cuenta de Runner. La configuración de herramientas del proyecto es separada. |
Conectar una aplicación de agente
- Abre Proyecto → Aplicaciones y desplázate a Aplicaciones de agente.
- Busca la aplicación o elige una categoría.
- Selecciona la tarjeta de la aplicación para abrir Detalles de la aplicación.
- Lee su descripción e inspecciona cada herramienta disponible.
- Desactiva cualquier herramienta que Runner no deba usar en este proyecto.
- Ingresa las credenciales del proveedor requeridas o selecciona Conectar y autorizar.
- Completa el paso del proveedor. Si tu navegador bloquea la ventana de autorización, permite el elemento emergente para Runner e intenta de nuevo.
- Vuelve al diálogo y confirma que dice Conectado.
- Selecciona Gestionar más tarde para revisar el acceso a herramientas o desconectar la aplicación.
El diálogo de conexión indica que las credenciales del proveedor se envían a través del servicio de conexión y no se almacenan en Runner. Aún así, debes tratar cada credencial como un secreto e ingresarla solo en los campos de credencial de la aplicación.
Cambiar acceso a herramientas
- Selecciona Gestionar en la aplicación conectada.
- Encuentra la herramienta que deseas cambiar.
- Activa o desactiva su cambio.
- Espera Herramienta habilitada o Herramienta deshabilitada.
- Si Runner muestra Error al actualizar herramienta, deja el diálogo abierto, verifica el cambio actual después de que se actualice, e intenta de nuevo solo si el estado guardado es claro.
Desactivar una herramienta limita el uso de esa herramienta por parte de Runner. No elimina datos creados previamente en el servicio externo.
Reparar o desconectar una conexión
Si el catálogo ya no muestra una conexión utilizable, abre la aplicación e inicia Conectar o Conectar y autorizar de nuevo, luego confirma Conectado.
Para eliminar el acceso, selecciona Gestionar → Desconectar, revisa la confirmación y selecciona Confirmar. Esto elimina la conexión de la aplicación de agente de la cuenta con sesión iniciada, no solo el acceso a herramientas del proyecto actual. Si la desconexión falla, Runner mantiene el estado conectado; no asumas que la cuenta externa fue eliminada.
Si faltan aplicaciones de agente
- La función puede no estar habilitada para el espacio de trabajo.
- Borra la búsqueda y establece la categoría en Todas.
- Actualiza Aplicaciones si el catálogo nunca sale de su estado de carga.
- Una aplicación individual puede informar que aún no está disponible para conectar.
- Si la lista de herramientas falla, selecciona Reintentar dentro de Detalles de la aplicación.
- No se debe prometer ninguna entrada de catálogo específica hasta que aparezca en el espacio de trabajo actual.