Documentation Index
Fetch the complete documentation index at: https://docs.getsupervisor.ai/llms.txt
Use this file to discover all available pages before exploring further.
Usa la tool schedule_call_tool con la acción
scheduleCall
para reservar una llamada futura en la agenda del agente.
Necesitas un agente de voz habilitado con disponibilidades publicadas.
Autentícate con una API Key (tools:execute) y agrega el header
X-Workspace-Id.
Ejecutar desde el SDK
import { createClient } from "@getsupervisor/agents-studio-sdk";
const client = createClient({
baseUrl: process.env.API_BASE_URL!,
workspaceId: process.env.WORKSPACE_ID!,
apiKey: process.env.API_KEY!,
});
const response = await client.tools.execute(
"schedule_call_tool",
{
agentId: "11111111-2222-3333-4444-555555555555",
action: "scheduleCall",
args: {
proposed_datetime_iso: "2025-07-02T15:00:00-06:00",
notes: "Confirmar demo con el equipo comercial",
metadata: {
customerId: "cust-789",
priority: "high",
},
},
},
{
idempotencyKey: `schedule-${Date.now()}`,
}
);
console.log(response.result.referenceId, response.result.scheduledFor);
Respuesta esperada
{
"status": "ok",
"result": {
"status": "scheduled",
"scheduledFor": "2025-07-02T21:00:00.000Z",
"referenceId": "sch_01J8XT8Q9R0S1T2U3V4W"
},
"metadata": {
"proposedAt": "2025-07-02T21:00:00.000Z",
"scheduledStart": "2025-07-02T21:00:00.000Z",
"scheduledEnd": "2025-07-02T21:15:00.000Z",
"scheduledStartLocal": "2025-07-02T15:00:00-06:00",
"scheduledEndLocal": "2025-07-02T15:15:00-06:00",
"timezone": "America/Mexico_City",
"windowSource": "agent_schedule",
"windowDayOfWeek": 3
}
}
Validaciones clave
proposed_datetime_iso: cadena ISO 8601 con zona horaria.notes: cadena opcional para compartir contexto con el agente.metadata: objeto plano opcional; se fusiona con la metadata de la
conexión.- Límite de búsqueda: el planificador intenta encontrar disponibilidad hasta 30 días después de la fecha propuesta.
Si no se encuentra disponibilidad en el horizonte configurado obtendrás
400 Unable to find an available window. Ajusta la fecha propuesta
o amplía los horarios del agente.
