Configuración del espacio de trabajo
Settings contiene las claves y los valores predeterminados que usan tus agentes. Cada espacio de trabajo tiene su propia configuración, así que agrégalas en el espacio de trabajo donde están los agentes. Para leer y cambiar la configuración, se necesita settings.manage.
Para ver todas las claves, consulta la referencia de configuración.
Qué contiene la página
Sección titulada «Qué contiene la página»| Sección | Para qué sirve |
|---|---|
| Appearance | Tema claro, oscuro o del sistema. Es tu preferencia personal, no una configuración del espacio de trabajo. |
| System Health | Cuántos proveedores de IA tienen una clave, cuántos parámetros de configuración existen y cuáles de los obligatorios faltan |
| Webchat Appearance | Los colores del botón, de las burbujas de mensajes, del avatar y de acento del chat web del espacio de trabajo |
| Identity Provider (SSO) | El inicio de sesión único de este espacio de trabajo. Consulta Inicio de sesión único. |
| API Keys | Las claves de los proveedores de modelos, Vertex AI y el proveedor de embeddings para las bases de conocimiento |
| Integrations | Las credenciales de los canales (Twilio, Google Chat), la transcripción de voz, la zona de pruebas de código y la aplicación obligatoria de claves de integración |
| General Settings | La zona horaria y los valores predeterminados de visualización |
| Observability | El seguimiento con LangSmith |
| Conversations | Cuánto tiempo se conserva el historial de conversaciones |
| mcp | Las apps de OAuth para los servidores MCP de Google Workspace, GitHub, Slack y HubSpot |
| evaluation | El modelo juez de las evaluaciones y el muestreo del tráfico real |
La página también tiene tarjetas para vincular la CLI de VirtuAI y para los clientes de A2A.
Agrega las claves que necesitas
Sección titulada «Agrega las claves que necesitas»Solo necesitas las claves de lo que usan tus agentes:
| Para | Claves |
|---|---|
| Google Gemini | GOOGLE_API_KEY o las claves de Vertex AI que se indican más abajo |
| OpenAI | OPENAI_API_KEY |
| Anthropic Claude | ANTHROPIC_API_KEY o las claves de Vertex AI que se indican más abajo |
| Gemini o Claude mediante Vertex AI | VERTEX_AI_SERVICE_ACCOUNT_JSON y, de forma opcional, VERTEX_AI_PROJECT_ID y VERTEX_AI_LOCATION |
| Bases de conocimiento | EMBEDDING_PROVIDER y EMBEDDING_MODEL, además de la clave de ese proveedor |
TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN. El número de WhatsApp se elige en Telephony > Messaging. |
|
| Google Chat | GOOGLE_CHAT_SERVICE_ACCOUNT_JSON y GOOGLE_CHAT_PROJECT_NUMBER, que se completa a partir de él cuando es posible |
| Voz | ELEVENLABS_API_KEY |
OPENAI_API_KEY, ANTHROPIC_API_KEY y GOOGLE_API_KEY tienen la insignia Required, y System Health muestra como faltantes las que están vacías. Puedes ignorar las de los proveedores que no usas.
Cuando guardas una clave de modelo, VirtuAI verifica su formato, por ejemplo, que una clave de OpenAI comience con sk-. No llama al proveedor, así que una clave con el formato correcto puede ser incorrecta de todos modos. Prueba un agente después de agregar una.
Cómo se manejan los secretos
Sección titulada «Cómo se manejan los secretos»Los parámetros de configuración marcados como secretos en la referencia de configuración se cifran antes de almacenarse. Una vez guardado, un secreto se muestra como Configured (not viewable): nadie puede volver a leerlo, ni siquiera los administradores. Para cambiarlo, selecciona Edit e ingresa un valor nuevo.
Los demás parámetros, como TWILIO_ACCOUNT_SID o los colores, se almacenan como valores sin cifrar y se muestran en la página.
Consulta la descripción general de seguridad.