Pular para o conteúdo principal
A ferramenta 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.
O modelo fornece o comando. Ele é executado por meio de /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 em usage.server_tool_use.shell_commands, incluindo chamadas bloqueadas por max_uses.