Code Mode para agentes de IA

Um programa em vez de muitas chamadas

1. 1
   O agente lê a biblioteca

   code_mode_reference entrega as chamadas da biblioteca waiso na linguagem que ele escolher — todas as linguagens que o Waiso roda.

2. 2
   Ele escreve um programa

   Leitura e escrita: listar, filtrar, alterar, devolver um resumo.

3. 3
   O Waiso roda

   No sandbox do projeto (sem rede), como o token: cada chamada é verificada contra o escopo do token e o acesso do dono.

4. 4
   Só o desfecho volta

   O resultado do programa, os logs e writes — cada alteração que ele fez, em ordem, mesmo se parar no meio.

Não há nada para ligar: o Code Mode são duas ferramentas do mesmo servidor MCP, e o guia do próprio servidor orienta os agentes a preferi-las para qualquer trabalho de várias etapas. Você ainda pode pedir com palavras — “use o Code Mode” — e o agente escreve um programa como este.

import waiso

def main():
    paused = []
    for flow in waiso.api.flows.list()["flows"]:
        runs = waiso.api.runs.list(target=f"flow:{flow['id']}", status="failed", limit=50)
        if runs["total"] > 3:
            for s in waiso.api.schedules.list()["schedules"]:
                if s["target"].get("flowId") == flow["id"] and s["enabled"]:
                    waiso.api.schedules.update(s["id"], enabled=False)
                    paused.append(s["name"])
    return {"paused": paused}

Quando usar, e quando não

O Code Mode compensa quando o pedido envolve olhar muitas coisas e decidir: limpar execuções, pausar o que vive falhando, renomear um lote de scripts, montar um relatório entre flows. O agente gasta tokens no programa e na resposta curta, não em cada lista que ele leria. Para uma ação só — rodar este script, mostrar este flow — a ferramenta MCP dela é tão boa quanto e mais fácil de acompanhar.

O programa só alcança a plataforma, e só como o token: não tem rede, nem arquivos fora da execução, e uma chamada fora do escopo do token lança o erro da biblioteca. Um programa que fica em loop é parado no limite de tempo; o que ele alterou até ali continua listado.

Limites e o que você vê

Toda execução do Code Mode está em Execuções como Code Mode com o nome do token; abra para ver o programa, o resultado e uma tabela Alterações feitas. Cada alteração também está no registro de auditoria, com o token e a execução.