Code Interpreter

Visão geral

O Code Interpreter estende ambientes de codificação baseados em Python com análise de dados integrada, permitindo que desenvolvedores executem scripts, visualizem resultados e prototipem soluções dentro de plataformas compatíveis. Com a integração no SquadOS, seus agentes ganham acesso a um ambiente de execução Python isolado na nuvem — podem rodar código, ler e gravar arquivos, executar comandos de terminal e obter resultados em tempo real, sem precisar de infraestrutura própria.

• Documentação na Composio: docs.composio.dev/toolkits/codeinterpreter

Autenticação

Esta ferramenta utiliza sem autenticação (NO_AUTH) para conectar.

Campo	Obrigatório	Descrição
N/A	Não	Esta ferramenta não exige credenciais.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Code Interpreter.
3. Clique no card para abrir o modal de detalhes e em Ativar — a ferramenta vai direto para a lista de ativas, sem etapa de login. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Criar sandbox

CODEINTERPRETER_CREATE_SANDBOX

Cria um sandbox para executar código Python em uma célula de Jupyter Notebook. Útil para agentes que precisam se comunicar, executar código, ver saídas, ler e gravar arquivos, entre outros. Funciona como um computador pessoal na nuvem. Use a pasta /home/user para leitura e gravação de arquivos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
keep_alive	integer	Não	Tempo em segundos para manter o sandbox ativo após a criação. Padrão: 300 segundos (5 minutos). Deve ser entre 0 e 3600.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Executar código

CODEINTERPRETER_EXECUTE_CODE

Executa código Python em um sandbox e retorna qualquer resultado, stdout, stderr e erro. Use a pasta /home/user para leitura e gravação de arquivos. Evite usar plt.show(), pois o código é executado remotamente. Para saída de imagens ou gráficos, prefira salvar em arquivos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
timeout	integer	Não	Timeout em segundos para a execução do código.
keep_alive	integer	Não	Tempo em segundos para manter o sandbox ativo após a execução. Padrão: 300 segundos (5 minutos). Deve ser entre 0 e 3600.
sandbox_id	string	Não	ID do sandbox onde o código será executado. Tente usar um ID de sandbox existente do contexto para acessar a sessão de modificação anterior. Se não encontrado, pode ser omitido e um novo sandbox será criado.
code_to_execute	string	Sim	Código Python a ser executado em uma única célula. Se um arquivo precisar ser salvo, deve ser salvo no diretório /home/user/. Ao final do código, é recomendado incluir um print de mensagem de sucesso.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter arquivo

CODEINTERPRETER_GET_FILE_CMD

Obtém um arquivo do sandbox e o retorna. Os arquivos devem ser lidos a partir da pasta /home/user.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
timeout	integer	Não	Timeout em segundos para o comando ser executado.
file_path	string	Sim	Caminho absoluto (no sandbox) do arquivo a obter. Deve começar com /home/user/.
sandbox_id	string	Sim	ID do sandbox onde o arquivo foi criado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Executar comando de terminal

CODEINTERPRETER_RUN_TERMINAL_CMD

Executa um comando no terminal e retorna stdout, stderr e o código de erro. Use a pasta /home/user para leitura e gravação de arquivos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
command	string	Sim	Comando a ser executado no terminal.
timeout	integer	Não	Timeout em segundos para o comando ser executado.
keep_alive	integer	Não	Tempo em segundos para manter o sandbox ativo após a execução. Padrão: 300 segundos (5 minutos).
sandbox_id	string	Não	ID do sandbox onde o código será executado. Tente usar um ID de sandbox existente do contexto para acessar a sessão de modificação anterior. Se não encontrado, pode ser omitido e um novo sandbox será criado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de arquivo

CODEINTERPRETER_UPLOAD_FILE_CMD

Faz o upload de um arquivo para o ambiente sandbox. Os arquivos devem ser enviados para a pasta /home/user.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file	object	Sim	Arquivo a ser enviado, contendo o nome do arquivo e o conteúdo codificado em base64.
overwrite	boolean	Não	Indica se o arquivo deve ser sobrescrito caso já exista.
sandbox_id	string	Sim	ID do sandbox para onde o arquivo será enviado.
destination_path	string	Sim	Caminho de destino absoluto no sandbox onde o arquivo será salvo. Deve começar com /home/user/. O nome do arquivo de file será acrescentado se destination_path for um diretório.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.