orq:shell executa comandos em um sandbox Linux isolado. Um sandbox é criado sob demanda para a resposta e reutilizado nas chamadas de shell seguintes da mesma resposta; assim, os arquivos e o diretório de trabalho são mantidos entre os comandos.
Início rápido
Os exemplos usam a configuração de cliente da Visão geral das server tools./bin/sh; portanto, pipes, redirecionamentos, cadeias com && e scripts de várias linhas se comportam como em um terminal. A imagem de sandbox do Toqan Router é Debian Linux com Python 3.13 e os coreutils padrão; um provedor de sandbox on-premise pode usar uma imagem diferente.
A ferramenta retorna stdout, stderr e um objeto outcome. Um comando concluído tem outcome.type definido como exit, com o exit_code. Uma falha do sandbox tem outcome.type definido como error, com a mensagem em um campo error de nível superior e sem código de saída. Uma saída que excede o tamanho configurado termina com [output truncated].
Configuração
O sandbox dura apenas a resposta atual. Containers entre solicitações não são compatíveis.
Disponibilidade e uso
O deployment precisa ter um provedor de sandbox configurado. Pode ser um provedor de sandbox em nuvem ou on-premise que implemente a interface de sandbox do Toqan Router. O Shell não tem cobrança separada como server tool nesta versão. Cada comando tentado aparece emusage.server_tool_use.shell_commands, incluindo chamadas bloqueadas por max_uses.
