Cuando Perplexity Computer necesita conectarse a una API de terceros que no cuenta con un conector integrado, puedes proporcionar de forma segura tus propias credenciales de API. Tus claves se cifran y se almacenan, de modo que no se comparten en la trayectoria del agente (los prompts y las respuestas intercambiados con modelos de terceros) ni con el entorno aislado de la tarea. Proporcionar credenciales dentro de una tarea funciona en todos los clientes de Perplexity; la bóveda de credenciales, donde las guardas y administras, está disponible en la web.
Resumen
Algunas herramientas que quieres que Computer use aún no tendrán un conector integrado. Las credenciales personalizadas te permiten usar tu propia credencial de API para que Computer pueda autenticarse en ese servicio en tu nombre; por ejemplo, para enviar un correo electrónico transaccional, extraer datos de una API de análisis o consultar resultados deportivos de un proveedor de datos. Computer admite los métodos de autenticación que usan estas API: tokens, encabezados personalizados, parámetros de consulta y nombres de usuario y contraseñas. Si proporcionas un nombre de usuario y una contraseña, Computer los guarda como una credencial de Basic auth para poder autenticarse en la API de forma segura.
Cuando una tarea necesita credenciales, Computer te muestra un formulario seguro. Tu credencial se cifra y se inserta en las solicitudes API salientes a través de un proxy seguro, de modo que el valor sin procesar no se comparte con el agente ni con el entorno aislado de la tarea. Tú eliges durante cuánto tiempo debe conservarse una credencial: solo para esta tarea, guardada en tu bóveda personal para reutilizarla, o compartida con un proyecto para que tus compañeros también puedan usarla. Una credencial que añadas en una tarea permanece disponible durante toda la sesión de Computer, y puedes revocarla en cualquier momento. Si la guardas en tu bóveda personal, Computer la usa automáticamente cuando una tarea la necesita, porque las credenciales nuevas se configuran como Permitir siempre. Puedes cambiar una credencial a Pedir aprobación en tu bóveda de credenciales.
¿Por qué usar credenciales personalizadas?
Conecta servicios sin un conector integrado. Usa tu propia clave de API para una herramienta de terceros para que Computer pueda empezar a usarla de inmediato.
Mantén los secretos fuera de la vista del agente. Las credenciales se cifran y se inyectan a través de un proxy seguro, por lo que el valor sin procesar no se comparte con el agente ni con el entorno aislado.
Reutiliza las claves en todas tus tareas. Guarda una credencial en tu bóveda personal una sola vez y deja que Computer la reutilice en futuras tareas.
Comparte el acceso con un proyecto. Añade una credencial a un proyecto para que todos los miembros del equipo puedan usarla sin compartir la clave sin procesar.
Mantén el control. Para cada credencial guardada, puedes elegir si permites que Computer la use sin tu aprobación o si prefieres que Computer te pida aprobación antes de usarla en una tarea.
Antes de añadir una credencial personalizada, comprueba si el servicio ya cuenta con un conector integrado. Los conectores son la forma preferida de vincular un servicio de terceros, y Computer usará uno cuando esté disponible. Usa credenciales personalizadas para los servicios que todavía no tienen un conector.
Si el servicio tiene un conector integrado, ese conector también puede aparecer dentro de un plugin. Al conectarlo en cualquier lugar, queda conectado para tu cuenta en todas partes, y tu conexión y los ajustes de conectores de tu organización se aplican dentro de cada plugin. Consulta ¿Qué son los plugins?
Los tres ámbitos de credenciales
Las credenciales se presentan en tres ámbitos, según cuánto tiempo duran y quién puede usarlas:
Sesión (tarea única): se usa solo dentro de la tarea actual y no se guarda para reutilizarla.
Personal (bóveda de credenciales): se guarda en tu bóveda personal de credenciales y se puede reutilizar en tus propias tareas.
Proyecto (compartida): se guarda en un proyecto para que todos en el equipo puedan usarla.
Las secciones siguientes explican cómo funciona cada una.
Credenciales de sesión (tarea única)
Las credenciales de sesión son la opción más sencilla: proporcionas una clave para una tarea y no se guarda.
Se te solicita en la tarea. Cuando una tarea necesita una credencial, Computer muestra un formulario seguro para que la introduzcas. Rellena automáticamente los detalles que puede, como el host, el nombre y el tipo de credencial.
Se cifra y se enruta a través de un proxy. Tu credencial se cifra y se inyecta en las solicitudes salientes de la API a través de un proxy seguro, por lo que el valor sin procesar no se comparte con el agente ni con el entorno aislado.
Dura toda la tarea. Una vez añadida, la credencial está disponible durante el resto de esa tarea, incluidas las solicitudes de seguimiento.
No se guarda. Las credenciales de sesión no se almacenan para reutilizarse: si inicias una nueva tarea, se te volverá a solicitar. Tendrás la opción de guardar la credencial en tu bóveda si quieres reutilizarla en el futuro.
Figura 1 — El formulario seguro que Computer muestra en una tarea cuando necesita una credencial.
Credenciales personales (bóveda de credenciales)
Guarda una credencial en tu bóveda personal para reutilizarla en tus propias tareas sin tener que volver a introducirla cada vez.
Guárdala desde el formulario de la tarea. Cuando Computer te solicite una credencial, elige la opción de guardarla en tu bóveda de credenciales para reutilizarla en todas las tareas de Computer.
O añádela directamente. Ve a Configuración > Credential vault para añadir y administrar credenciales fuera de una tarea.
Elige cuándo te pregunta Computer. Las credenciales nuevas se configuran como Permitir siempre, así que Computer reconoce tu credencial guardada y la usa cuando una tarea la necesita. Si prefieres aprobar cada uso, cambia la credencial a Pedir aprobación en tu bóveda de credenciales.
Es privada. Las credenciales personales pertenecen a tu cuenta y no se comparten con nadie más.
Figura 2 — Credenciales guardadas en la bóveda de credenciales, cada una con su ajuste de aprobación.
Credenciales del proyecto (compartidas con un equipo)
Añade una credencial a un proyecto para que todos los que trabajan en ese proyecto puedan usarla; es útil para una clave compartida de la que depende tu equipo.
Añádela en el proyecto. En la barra lateral del proyecto, busca la sección Credential vault y selecciona Manage para añadir una credencial del proyecto.
Todos los miembros del proyecto pueden usarla. Todos los miembros del proyecto pueden usar la credencial en sus tareas, sin ver el valor sin procesar.
Los escritores la gestionan. Debes ser, como mínimo, escritor del proyecto para añadir o revocar una credencial del proyecto, siguiendo las mismas reglas de acceso que los conectores del proyecto.
Elige cuándo te pregunta Computer. Las credenciales de proyecto nuevas se configuran como Permitir siempre, así que Computer puede usarlas en una tarea sin preguntar. Cambia una credencial a Pedir aprobación si quieres que Computer te pregunte antes de cada uso.
Figura 3 — Credenciales del proyecto en la barra lateral del proyecto.
Administrar tus credenciales
Encuentra tu bóveda en Configuración > Credential vault. Tu bóveda personal de credenciales está en la configuración de tu cuenta. Si ves Plugins en la barra lateral, es posible que también puedas abrirla desde ahí: selecciona Añadir personalizado y luego Conecta tu propia API. Esa opción solo aparece cuando tu plan y la configuración de tu organización permiten conectores personalizados.
Añade, revisa o elimina claves. Abre la bóveda de credenciales para añadir una nueva credencial, revisar las que has guardado o eliminar una que ya no necesites.
Administra las credenciales del proyecto en el proyecto. Añade o revoca las credenciales de un proyecto desde la sección Credential vault de la barra lateral del proyecto. Debes ser, como mínimo, escritor del proyecto.
Límites y privacidad
Tu clave sin procesar permanece oculta. Las credenciales se cifran y se inyectan mediante un proxy seguro, por lo que el valor sin procesar no se comparte con el agente ni con el entorno aislado de la tarea.
Solo solicitudes de API. Se admiten credenciales personalizadas para las solicitudes de API que Computer puede enrutar a través del proxy seguro. Otros tipos de secretos, como las claves SSH, no se admiten por ahora.
Las credenciales guardadas usan Permitir siempre de forma predeterminada. Computer usa una credencial guardada personal o de proyecto en una tarea sin preguntar, a menos que cambies esa credencial a Pedir aprobación. Las credenciales guardadas antes de este cambio predeterminado conservan la configuración que ya tenían.
Las credenciales de sesión no se almacenan. Una credencial de sesión se usa solo dentro de esa sesión de Computer, puede revocarse en cualquier momento y no se guarda para reutilizarse en sesiones posteriores, a menos que elijas explícitamente guardarla en tu bóveda de credenciales.
Preguntas frecuentes
¿Cuál es la diferencia entre una credencial de sesión, una personal y una de proyecto?
Una credencial de sesión se usa solo en la tarea actual y no se guarda. Una credencial personal se guarda en tu bóveda de credenciales y se puede reutilizar en tus propias tareas. Una credencial de proyecto se guarda en un proyecto para que todos en ese equipo puedan usarla. Las credenciales guardadas se configuran como Permitir siempre de forma predeterminada, y puedes cambiar cualquiera de ellas a Pedir aprobación.
¿Debería usar un conector o una credencial personalizada?
Si el servicio cuenta con un conector integrado, usa el conector: es la forma preferida de conectar un servicio de terceros. Usa una credencial personalizada cuando no haya un conector disponible para la herramienta que necesitas.
¿Puede Computer ver mi clave API?
No. Tu credencial se cifra y se inyecta en las solicitudes salientes a través de un proxy seguro, por lo que el valor sin procesar no se comparte con el agente ni con el entorno aislado de la tarea. Si una API incluye tu credencial en su respuesta, por ejemplo al devolver las cabeceras de la solicitud, Computer puede ver esa respuesta.
¿Por qué Computer me pide que apruebe una credencial?
Computer solo pide tu aprobación cuando una credencial guardada personal o de proyecto está configurada como Pedir aprobación. Las credenciales nuevas se configuran como Permitir siempre, pero las que se guardaron antes de este cambio predeterminado conservan la configuración que ya tenían. Para dejar de recibir solicitudes de una credencial, selecciona Permitir siempre en la configuración de esa credencial en tu bóveda de credenciales.
¿Cómo reutilizo una credencial en una tarea futura?
Guárdala en tu bóveda de credenciales cuando Computer te lo solicite, o añádela directamente desde la bóveda. En tareas posteriores, Computer la reconoce y la usa, o te pregunta primero si la credencial está configurada como Pedir aprobación.
¿Dónde encuentro mi bóveda de credenciales?
Ve a Configuración > Credential vault. Si ves Plugins en la barra lateral, es posible que también puedas abrirla desde ahí: selecciona Añadir personalizado y luego Conecta tu propia API. Esa opción solo aparece cuando tu plan y la configuración de tu organización permiten conectores personalizados.
¿Pueden mis compañeros de equipo usar mis claves?
Sí, si las añades como credenciales del proyecto. Las credenciales personales son privadas para tu cuenta. Todos los miembros del proyecto pueden usar sus credenciales, y debes ser, como mínimo, escritor del proyecto para añadirlas o revocarlas.
¿Puedo almacenar otros secretos, como una clave SSH?
No. Las credenciales personalizadas admiten solicitudes de API que se enrutan a través del proxy seguro. Otros formatos de secreto, como las claves SSH, no se admiten por ahora.
¿El nombre de usuario y la contraseña son los mismos que uso para iniciar sesión en el sitio web de ese servicio?
No. Cuando proporcionas un nombre de usuario y una contraseña, Computer los guarda como una credencial de Basic auth para autenticarse en la API del servicio; no se trata de un inicio de sesión de uso general para acceder al sitio web de ese servicio. Las credenciales personalizadas solo se usan para autenticar solicitudes a la API, mediante tokens, encabezados personalizados, parámetros de consulta o Basic auth. Si no sabes con seguridad qué valor introducir, consulta la documentación de la API para ver cómo espera que se autentiquen las solicitudes.
Artículos relacionados
¿Necesitas más ayuda?
Contáctanos mediante Help > Contact Support. Incluye el enlace de la tarea si tu pregunta es sobre una tarea concreta de Computer.