Skip to main content

​
Manual de usuario — Agents Studio

Bienvenido a Agents Studio, la plataforma para crear, gestionar y operar agentes conversacionales (texto y voz). Esta guía está orientada al usuario final (operación y administración) y complementa la referencia técnica de la API.

​
Tabla de contenidos

  1. Introducción
  2. Get Started (agente de voz)
  3. Secciones del sitio
  4. Mantenimiento con Copilot Chat
  5. Gestión de versiones
  6. Instrucciones: objetivo de negocio
  7. Voces: cómo cambiarlas
  8. API Keys y seguridad
  9. Webhooks e integraciones
  10. Time to value: tu primer agente en 5 minutos

​
Introducción

Agents Studio permite automatizar interacciones complejas mediante agentes de IA capaces de mantener conversaciones naturales por voz y texto. Puedes construir desde asistentes de soporte hasta campañas salientes, con control de versiones, flujos y trazabilidad.

​
Get Started (agente de voz)

Para un paso a paso completo, usa:

​
Secciones del sitio

​
Agentes

Ruta: /agents Es la central de mando de tu fuerza de trabajo digital:
  • Listado de agentes: visualiza agentes, estado y métricas.
  • Creación: crea agentes de chat o voz.
  • Gestión: ajusta personalidad (blueprint), instrucciones, tools y workflow.

​
Personalidad (Blueprint) y voz

Aquí defines la identidad del agente:
  • Nombre y rol (quién es).
  • Objetivo (qué debe lograr).
  • Voz (solo agentes de voz): selecciona una voz alineada a tu marca.
En la API, la voz se guarda como voiceId dentro del blueprint de la versión.

​
Instrucciones

Las instrucciones guían el comportamiento del agente con reglas de negocio concretas. Úsalas para matizar sin reescribir toda la personalidad. Ejemplo:
“Si el cliente pregunta por precios, no des una cifra exacta; ofrece enviar una cotización.”

​
Campañas

Ruta: /dashboard/batches Gestiona comunicaciones masivas (por ejemplo, listas de contactos para llamadas salientes):
  • Crear campaña: sube contactos y asigna un agente.
  • Monitoreo: revisa progreso y errores.
  • Resultados: correlaciona filas con ejecuciones cuando el sistema exponga agentExecutionId.
Referencia API:

​
Llamadas

Ruta: /dashboard/calls Historial completo de interacciones para auditoría y mejora continua:
  • Listado: filtra por fecha, agente y otros criterios.
  • Reproducción: escucha grabaciones si están disponibles.
  • Detalles: revisa transcripción, métricas y metadatos.
El recurso Calls es de solo lectura: proviene de Speech Analytics.
Referencia API:

​
Marketplace

Ruta: /dashboard/marketplace Acelera la implementación con recursos preconstruidos:
  • Plantillas: agentes base para casos comunes.
  • Herramientas: integraciones/capacidades adicionales.
Si trabajas con plantillas del catálogo (vía API), consulta también:

​
Logs

Ruta: /dashboard/logs Monitoreo para operaciones y depuración:
  • Stream en vivo: observa eventos conforme ocurren.
  • Pausa/Reanuda: analiza sin perder contexto.
  • Diagnóstico: identifica errores de configuración, credenciales o integraciones.
Identificadores útiles para soporte:
  • toolExecutionId: correlación de ejecuciones de tools (resultado ok/queued/error).
  • executionId: correlación de llamadas con procesos internos.

​
Mantenimiento con Copilot Chat

Agents Studio integra un asistente tipo Copilot Chat para ayudarte a iterar:
  • Personalidad: refina rol, objetivo y tono.
  • Instrucciones: reescribe reglas para hacerlas más claras o concisas.
  • Workflow: sugiere mejoras de flujo y validaciones.
Sugerencias de uso:
  • Pide cambios concretos (“hazlo más formal”, “reduce repetición”, “agrega preguntas obligatorias”).
  • Revisa siempre antes de publicar.

​
Gestión de versiones

Agents Studio usa un modelo de versiones para iterar con seguridad.

​
Estados

  • draft: versión editable.
  • active: versión publicada (la vigente en producción).
  • archived: versiones históricas.

​
Publicar

Publicar promueve una versión draft a active y archiva la anterior. También puede permitir re-publicar una active para forzar sincronización cuando aplique.

​
Restaurar (rollback)

Flujo recomendado:
  1. Ubica la versión histórica.
  2. Clónala (versión) para crear una versión nueva draft (snapshot).
  3. Ajusta lo mínimo necesario.
  4. Publica.

​
Instrucciones: objetivo de negocio

Las instrucciones son texto corto (con prioridad por order) para guiar el comportamiento del agente. Objetivo de negocio:
  • Reducir errores recurrentes.
  • Estandarizar tono por campaña.
  • Asegurar cumplimiento (guardrails).
  • Alinear el agente con cambios operativos.
Buenas prácticas:
  • Cortas, accionables y medibles.
  • Prioriza guardrails arriba.
  • Desactiva instrucciones obsoletas (no pierdas historial).

​
Voces: cómo cambiarlas

Flujo recomendado:
  1. Abre o crea una versión draft.
  2. Selecciona una nueva voz.
  3. Publica.
Referencia de catálogo (API):

​
API Keys y seguridad

Para integrar Agents Studio con tus sistemas, usa API Keys con el principio de menor privilegio (scopes mínimos).
  • Crea, rota y revoca llaves según tu política.
  • Evita exponer llaves en clientes públicos.
Referencia:

​
Webhooks e integraciones

Los webhooks notifican eventos importantes en tiempo real (ej. finaliza llamada, cambios de estado). Casos típicos:
  • Sincronizar CRM.
  • Enviar alertas (Slack/Teams).
  • Disparar automatizaciones post-llamada.
Referencia API:

​
Time to value: tu primer agente en 5 minutos

  1. Crea un agente de voz desde /agents.
  2. Define personalidad (rol, objetivo, saludo) y selecciona voz.
  3. Agrega 3–5 instrucciones críticas de negocio.
  4. Publica.
  5. Realiza una llamada de prueba.
  6. Revisa Logs (/dashboard/logs) y Calls (/dashboard/calls) para validar.

Get Started de voz

Pasos detallados para publicar y probar.

Calls (API)

Consulta programática de llamadas (solo lectura).