Ir al contenido

Configuración

Cada espacio de trabajo tiene su propia copia de estos parámetros. Aparecen en Settings, agrupados bajo los encabezados que se indican a continuación. Para leerlos o cambiarlos, se necesita settings.manage. Para saber cómo usar la página, consulta Configuración del espacio de trabajo.

Los parámetros secretos se cifran antes de almacenarse y no se pueden volver a leer después de guardarlos. Su valor se muestra como Configured (not viewable).

Clave Para qué sirve Predeterminado Secreto
GOOGLE_API_KEY Los modelos de Google Gemini y los embeddings de Google para las bases de conocimiento Sí
OPENAI_API_KEY Los modelos de OpenAI y los embeddings de OpenAI Sí
ANTHROPIC_API_KEY Los modelos Claude de Anthropic Sí
OPENCODE_API_KEY Los modelos que se ofrecen mediante OpenCode Go Sí
VERTEX_AI_SERVICE_ACCOUNT_JSON Una cuenta de servicio de Google Cloud para ejecutar Claude y Gemini mediante Vertex AI en tu propio proyecto Sí
VERTEX_AI_PROJECT_ID El proyecto de Google Cloud para Vertex AI. Si se deja en blanco, se lee de la cuenta de servicio.
VERTEX_AI_LOCATION La región de Vertex AI, por ejemplo, us-central1 o europe-west4 us-central1
EMBEDDING_PROVIDER Quién crea el índice de búsqueda de las bases de conocimiento: google (clave de API), vertex (cuenta de servicio) u openai google
EMBEDDING_MODEL El modelo de embeddings. Debe pertenecer al proveedor anterior. text-embedding-004
Clave Para qué sirve Predeterminado Secreto
TWILIO_ACCOUNT_SID Tu cuenta de Twilio, para WhatsApp
TWILIO_AUTH_TOKEN Tu token de autenticación de Twilio, para WhatsApp Sí
GOOGLE_CHAT_SERVICE_ACCOUNT_JSON La cuenta de servicio que usa tu app de Google Chat Sí
GOOGLE_CHAT_PROJECT_NUMBER El número del proyecto de Google Cloud donde está configurada tu app de Chat. Las solicitudes de Google Chat se verifican con él. Se completa automáticamente cuando guardas el JSON de la cuenta de servicio, si la cuenta de servicio puede leer su proyecto (por ejemplo, con roles/browser); si no, escríbelo. Consulta Google Chat.
GOOGLE_CHAT_WAITING_MESSAGE El texto que se muestra en Google Chat mientras el agente trabaja Un mensaje en español que indica que puede tardar unos minutos
GOOGLE_CHAT_WAITING_IMAGE_URL Una imagen o un GIF que se muestra con el mensaje de espera
CLOUD_RUN_SERVICE_ACCOUNT_JSON Una cuenta de servicio que usan las herramientas personalizadas para llamar a servicios de Cloud Run protegidos por IAM Sí
INTEGRATION_KEYS_ENFORCED Exige una clave de integración en las conexiones de voz. WhatsApp, Google Chat, Slack y Telegram se verifican con el mecanismo de su plataforma. Cámbialo con el interruptor Key Enforcement en Integrations. Consulta Claves de integración. true
TRANSCRIPTION_MODEL El modelo de Speech-to-Text de Google Cloud para los mensajes de voz: latest_long, latest_short o chirp_2 latest_long
TRANSCRIPTION_LANGUAGE_CODES Los idiomas que se transcriben, separados por comas es-ES,en-US
E2B_API_KEY E2B, para que los agentes ejecuten código en una zona de pruebas Sí
E2B_DOMAIN Un dominio de E2B autoalojado. Déjalo en blanco para usar e2b.dev.
Clave Para qué sirve Predeterminado Secreto
WORKSPACE_TIMEZONE La zona horaria del espacio de trabajo, como nombre IANA, por ejemplo, America/Mexico_City UTC
SYSTEM_NAME Un nombre visible para el sistema. Por el momento, los agentes no lo usan.
DEFAULT_LANGUAGE Un idioma predeterminado. Por el momento, los agentes no lo usan. english
Clave Para qué sirve Predeterminado Secreto
LANGCHAIN_API_KEY Tu clave de LangSmith. Si está configurada, las ejecuciones de los agentes se registran en tu cuenta de LangSmith. Sí
LANGCHAIN_ENDPOINT El extremo de la API de LangSmith https://api.smith.langchain.com
LANGCHAIN_PROJECT El proyecto de LangSmith al que van los seguimientos default
LANGSMITH_WORKSPACE_ID Un ID de espacio de trabajo de LangSmith. Por el momento, no se usa.
Clave Para qué sirve Predeterminado Secreto
conversations.retention_days Cuántos días se conserva el historial de conversaciones en Conversations, de 1 a 3,650 365

Apps de OAuth que permiten que los agentes se conecten a servidores MCP en nombre de un usuario. Los URI de redireccionamiento de GitHub, Slack y HubSpot se derivan de tu dirección de VirtuAI.

Clave Para qué sirve Secreto
GOOGLE_MCP_CLIENT_ID El ID de cliente de OAuth para los servidores MCP de Google Workspace (tipo Aplicación web)
GOOGLE_MCP_CLIENT_SECRET Su secreto de cliente Sí
GOOGLE_MCP_REDIRECT_URI El URI de redireccionamiento registrado para ese cliente, por ejemplo, https://app.imvirtuai.com/api/oauth/google/callback
GITHUB_MCP_CLIENT_ID El ID de cliente de la app de OAuth de GitHub
GITHUB_MCP_CLIENT_SECRET Su secreto de cliente Sí
SLACK_MCP_CLIENT_ID El ID de cliente de la app de Slack
SLACK_MCP_CLIENT_SECRET Su secreto de cliente Sí
HUBSPOT_MCP_CLIENT_ID El ID de cliente de la app de HubSpot
HUBSPOT_MCP_CLIENT_SECRET Su secreto de cliente Sí
Clave Para qué sirve Predeterminado
EVAL_JUDGE_PROVIDER El proveedor del modelo que califica las respuestas de las evaluaciones, como gemini, openai o anthropic
EVAL_JUDGE_MODEL El modelo juez. Sin él, los casos que necesitan un juez se informan como sin calificación, no como fallidos.
EVAL_ONLINE_ENABLED Califica una muestra de conversaciones reales del chat web de forma programada. Consume tokens sin que nadie inicie una ejecución. El muestreo también debe estar en funcionamiento en tu implementación; consulta a soporte antes de depender de él. false
EVAL_ONLINE_SAMPLE_PERCENT El porcentaje de conversaciones recientes que se califica en cada ejecución, de 0 a 100 5
EVAL_ONLINE_DAILY_CAP La cantidad máxima de conversaciones que se califican por día 50
EVAL_ONLINE_SCORERS Los calificadores para el tráfico muestreado, separados por comas: groundedness, rubric, tone_policy, no_error groundedness

Se muestran como selectores de color, no como claves.

Clave Etiqueta Predeterminado
WEB_CHAT_BUTTON_COLOR Button Color #4f46e5
WEB_CHAT_USER_BUBBLE_COLOR User Bubble Color #6366f1
WEB_CHAT_AVATAR_BG_COLOR Avatar Background Color #4f46e5
WEB_CHAT_ACCENT_COLOR Accent Color #6366f1

Estos también son parámetros del espacio de trabajo, pero no se editan en las listas anteriores.

Clave Dónde se configura
TWILIO_WHATSAPP_NUMBER Se elige en Telephony > Messaging
conversations.sensitive_rules Qué categorías de datos sensibles se detectan. Todavía no tiene pantalla; consulta Datos sensibles.