Solución de problemas

Cada rechazo lleva un código y una frase que dice qué hacer. Cuando tiene que actuar una persona, lleva además un enlace a la página que lo resuelve.

El resultado de una herramienta MCP pone el código en code, junto a instruction. En /p/ un error llega como error.code y error.instruction, y la consulta de una llamada terminada que falló trae error_code. La API de la consola responde con error.code y error.request_id.

Encuentra la llamada

• Cada llamada tiene un call_id que empieza por sp_c_. Abre https://my.sallyport.cloud/activity?call=<call_id> para verla.
• La llamada muestra Agente, Conexión, Versión de la clave, Regla, Registro y una Cronología de lo ocurrido.
• Escribe a Configuración, Soporte con el call_id y, para un error de la API de la consola, con su request_id.

Mira exactamente qué envió el agente y qué volvió

Abre Actividad, elige la llamada y pulsa Abrir la solicitud y la respuesta completas. La llamada aparece tal como fue, sin nada oculto.

• La solicitud: método, dirección completa, cada cabecera y el cuerpo. Para SSH el comando, para archivos la ruta y el contenido, para una base de datos la sentencia y sus valores, para el correo el mensaje entero.
• Una cabecera que el agente envió en el lugar de la clave, como su propio PRIVATE-TOKEN, sigue en la lista con su valor, tachada y marcada Sustituida por la clave de la conexión, no enviada. La clave que añadió Sallyport nunca aparece.
• La respuesta: estado, cada cabecera y el cuerpo. Una respuesta larga se carga entera hasta 1 MiB, y Descargar la respuesta completa la guarda toda.
• Las solicitudes se guardan lo mismo que el historial de llamadas, 180 días por defecto. Las respuestas y los cuerpos de solicitud de más de 1 MiB se guardan 30 días, y después la llamada lo indica.

Falta un servicio en las herramientas del agente

• Pide al agente que llame a list_access. Muestra cada servicio que el agente puede usar y qué espera a una persona.
• Una clave nueva llega a cada agente activo de su espacio de trabajo y su entorno. Un agente de Pruebas nunca ve una clave de Producción.
• Una conexión quitada de la lista Acceso de un agente sigue quitada. Devuélvela con Añadir conexión.
• Con más de 40 herramientas, las herramientas de los servidores MCP remotos salen de la lista. El agente las encuentra con search_tools y las ejecuta con call.
• Un host fuera de la lista funciona con http_request. La primera llamada devuelve un enlace donde añades su clave.

Códigos de respuesta

Cuando el servicio no respondió

UPSTREAM_ERROR con un reason significa que no llegó respuesta. side_effect es none cuando nada llegó al servicio y unknown cuando pudo llegar.

Errores de petición que corrige una persona

La mayoría de los motivos de BAD_REQUEST los corrige el agente, y el texto le dice cómo. Estos necesitan a una persona:

• not_https con console_url: la dirección de la conexión empieza por http://. Cámbiala a https:// en la página de la conexión.
• mcp_binding, database_binding o email_binding: una llamada por /p/ apunta a un servidor MCP, a una base de datos o a un buzón. Llama a sus herramientas en el endpoint MCP. sftp_operation: una llamada de archivos no nombra una sola operación con claridad; detail dice qué cambiar.
• missing_host: la conexión cubre todos los hosts de un servicio, así que la llamada debe nombrar uno. En /p/, pon el host justo después del ID de la conexión.

Errores de la API de la consola

• FORBIDDEN nombra el rol que necesita en details.required_role. Exportar el registro requiere un propietario, o un administrador o auditor de toda la organización sin un rol más limitado en ningún espacio de trabajo.
• Una clave API no puede responder una tarjeta: una decisión necesita a una persona.
• VALIDATION_FAILED nombra cada campo incorrecto en details.fields.
• AUTH_FAILED significa que la sesión terminó o que la clave API fue revocada.

Cambia una clave de servicio sin cortes

• Crea una clave nueva en el proveedor mientras la actual sigue funcionando.
• Abre la clave en Claves, pulsa Rotar clave, pega el valor nuevo y pulsa Guardar la clave nueva.
• Haz una llamada a través de Sallyport. Cuando funcione, revoca la clave antigua en el proveedor.