Solução de problemas

Toda recusa traz um código e uma frase que diz o que fazer. Quando uma pessoa precisa agir, ela traz também um link para a página que resolve.

O resultado de uma ferramenta MCP põe o código em code, ao lado de instruction. Em /p/ um erro chega como error.code e error.instruction, e a consulta de uma chamada encerrada que falhou traz error_code. A API do console responde com error.code e error.request_id.

Encontre a chamada

• Toda chamada tem um call_id que começa com sp_c_. Abra https://my.sallyport.cloud/activity?call=<call_id> para vê-la.
• A chamada mostra Agente, Conexão, Versão da chave, Regra, Registro e uma Linha do tempo do que aconteceu.
• Escreva para Configurações, Suporte com o call_id e, para um erro da API do console, com o request_id.

Veja exatamente o que o agente enviou e o que voltou

Abra Atividade, escolha a chamada e clique em Abrir o pedido e a resposta completos. A chamada aparece como foi, sem nada escondido.

• O pedido: método, endereço completo, cada cabeçalho e o corpo. Para SSH o comando, para arquivos o caminho e o conteúdo, para um banco de dados a instrução e seus valores, para e-mail a mensagem inteira.
• Um cabeçalho que o agente enviou no lugar da chave, como o próprio PRIVATE-TOKEN, continua na lista com o valor, riscado e marcado Substituído pela chave da conexão, não enviado. A chave que o Sallyport adicionou nunca aparece.
• A resposta: status, cada cabeçalho e o corpo. Uma resposta longa carrega inteira até 1 MiB, e Baixar a resposta completa salva tudo.
• Os pedidos ficam guardados o mesmo tempo que o histórico de chamadas, 180 dias por padrão. As respostas e os corpos de pedido acima de 1 MiB ficam 30 dias, e depois disso a chamada avisa.

Falta um serviço nas ferramentas do agente

• Peça ao agente para chamar list_access. Ele lista cada serviço que o agente pode usar e o que espera por uma pessoa.
• Uma chave nova vai para todo agente ativo do seu espaço de trabalho e do seu ambiente. Um agente em Teste nunca vê uma chave de Produção.
• Uma conexão tirada da lista Acesso de um agente continua fora. Devolva-a com Adicionar conexão.
• Acima de 40 ferramentas, as ferramentas dos servidores MCP remotos saem da lista. O agente as encontra com search_tools e as executa com call.
• Um host fora da lista funciona por http_request. A primeira chamada devolve um link onde você adiciona a chave dele.

Códigos de resposta

Quando o serviço não respondeu

UPSTREAM_ERROR com um reason significa que nenhuma resposta voltou. side_effect é none quando nada chegou ao serviço e unknown quando pode ter chegado.

Erros de requisição que uma pessoa corrige

A maioria dos motivos de BAD_REQUEST o próprio agente corrige, e o texto diz como. Estes precisam de uma pessoa:

• not_https com console_url: o endereço da conexão começa com http://. Troque para https:// na página da conexão.
• mcp_binding, database_binding ou email_binding: uma chamada por /p/ aponta para um servidor MCP, um banco de dados ou uma caixa de correio. Chame as ferramentas dele no endpoint MCP. sftp_operation: uma chamada de arquivos não nomeia uma única operação com clareza; detail diz o que mudar.
• missing_host: a conexão cobre todos os hosts de um serviço, então a chamada precisa nomear um. Em /p/, ponha o host logo depois do ID da conexão.

Erros da API do console

• FORBIDDEN nomeia o papel necessário em details.required_role. Exportar o registro exige um proprietário, ou um administrador ou auditor da organização inteira sem papel mais restrito em nenhum espaço de trabalho.
• Uma chave de API não pode responder a um cartão: uma decisão precisa de uma pessoa.
• VALIDATION_FAILED nomeia cada campo errado em details.fields.
• AUTH_FAILED significa que a sessão terminou ou que a chave de API foi revogada.

Troque uma chave de serviço sem interrupção

• Crie uma chave nova no provedor enquanto a atual ainda funciona.
• Abra a chave em Chaves, toque em Trocar chave, cole o valor novo e toque em Salvar a nova chave.
• Faça uma chamada pelo Sallyport. Quando ela funcionar, revogue a chave antiga no provedor.