Symbioza

npx add-mcp 'https://symbioza.dev/mcp'

Um job para executar. Um limite para respeitar.

Use o Symbioza para trabalho GPU conteinerizado que tem um fim definido e arquivos para retornar. Seu agente prepara o job; o Symbioza gerencia a computação.

Envie uma carga de trabalho. Pule a busca por máquina.

Bom para jobs GPU finitos

Treinamento, avaliação e inferência em lote com seu contêiner, comando, dados acessíveis e um contrato de saída claro.

Escolha uma ferramenta diferente para serviços ao vivo

Este fluxo de trabalho não é um servidor web persistente, uma estação de trabalho interativa ou uma promessa de inferência de baixa latência. É um job que executa e termina.

O CONTRATO DO JOB

VOCÊ DEFINE O trabalho + limite

NÓS CUIDAMOS Da execução na nuvem

Declare requisitos de compatibilidade genuínos. Seu agente não precisa escolher um provedor ou procurar por uma GPU.

Torne cada etapa explícita.

Use as ferramentas expostas pelo seu cliente conectado como autoridade atual do esquema.

Ferramenta	O que seu agente deve fazer
describeDataset	Inspecionar uma URL de dataset acessível e preparar seus metadados. Verificar se a URL é autorizada e adequada para o job.
estimateExecution NENHUMA COMPUTAÇÃO RESERVADA	Enviar a especificação pretendida do job, sem necessidade de limite de gastos. Mostrar a estimativa e qualquer coisa faltante, depois pedir o limite e estimar novamente com ele. Sem nada medido sobre o job, não é uma cotação: dá o preço de cada hora de execução. Uma estimativa não é um preço fixo ou uma reserva.
submitJob ETAPA PAGA	Revisar o job e o limite com o usuário, depois enviar com o resumo da estimativa e o identificador de solicitação exigidos pela ferramenta. Crédito pré-pago é necessário.
getStatus / listJobs	Salvar o identificador de execução e verificar o progresso depois na mesma conta. A sessão original do cliente não precisa permanecer aberta.
listSecrets	Ler os nomes e tipos dos segredos salvos do usuário, nunca um valor. Anexar um conjunto pelo nome nos segredos do job. Quando o acesso estiver faltando, dar ao usuário o link de configuração do Symbioza que a estimativa retorna, nunca um que você compôs, e continuar assim que o conjunto estiver listado.
getArtifact	Inspecionar arquivos disponíveis e estado de entrega. Baixar as saídas e verificar seus hashes. Verificar se a cobrança ainda é provisória.
cancelJob	Solicitar cancelamento quando necessário. A computação usada ainda pode ser cobrada, dentro do limite total de gastos do job.

Detalhes do conector e da submissão

O Symbioza executa um job GPU conteinerizado em uma máquina de nuvem alugada sob um teto rígido em dólares e coleta artefatos disponíveis. Um agente envia uma imagem, um comando e um orçamento por meio de um conector MCP. O Symbioza seleciona a computação, executa o job e relata a entrega da saída e a cobrança separadamente. A recuperação depende da política do job, da computação disponível, do orçamento restante e do suporte compatível a checkpoints.

Conector: https://symbioza.dev/mcp.

Três campos obrigatórios: image, command e budgetUsd, que é obrigatório para enviar e opcional para estimar: estime primeiro, depois peça ao usuário. O bloco gpu é opcional: todo job executa em uma máquina GPU que o Symbioza dimensiona. Declare-o apenas para gpu.minCudaVersion ou um piso comprovado.

Envie a especificação revisada com specDigest da estimativa e um clientRequestId estável. Uma especificação alterada precisa de uma nova estimativa. Mantenha o mesmo clientRequestId para cada reenvio da mesma submissão: um reenvio retorna o job original, independentemente do que aconteceu com ele. Para executar novamente um job que falhou, foi cancelado ou se perdeu, envie retryOf definido como o executionId desse job, com um novo clientRequestId.

Não peça ao usuário para prever o tempo de execução. O limite é derivado do orçamento e da taxa da máquina reservada, com um teto de 48 horas (172800 segundos). O orçamento geralmente é o primeiro a limitar. maxRuntimeSeconds é opcional e pode definir um teto mais curto.

Uma nova tentativa em uma máquina maior deve caber no budgetUsd restante e na política do job. Com pinHost, nenhuma segunda máquina é comprada. Recuperação e conclusão não são garantidas.

A submissão paga exige saldo pré-pago. Recarregue após revisar sua estimativa. O crédito pode ser adicionado em qualquer valor inteiro em dólares dentro dos limites do Symbioza. Quando o coversThisJob da estimativa for falso, shortfallUsd é o crédito que o job ainda precisa e topupUrl é pré-preenchido com ele: dê ao usuário esse link como retornado. Um checkout que foi aberto não é crédito; estime novamente antes de enviar.

Credenciais nunca vão em env, que é configuração não sensível armazenada em texto claro com o job. O usuário as salva como Segredos em symbioza.dev/app/secrets; anexe um conjunto pelo nome em secrets. listSecrets mostra apenas nomes e tipos. Quando o acesso estiver faltando, estimateExecution e submitJob retornam um link de configuração do Symbioza: dê ao usuário esse link, nunca componha um, e continue apenas quando listSecrets mostrar o conjunto.

O que o agente deve manter em mente.

O orçamento cobre todo o job.

Novas tentativas compartilham o mesmo limite total de gastos. A recuperação depende da política, da computação disponível e do orçamento restante; um job pode parar sem concluir.

Checkpointing pertence à carga de trabalho.

Salvar um checkpoint só é útil quando seu comando pode carregar o checkpoint salvo. Não descreva cada nova tentativa como uma retomada contínua.

A submissão é separada da estimativa.

Peça ao usuário para revisar o job antes de gastar. A interação de revisão depende do cliente MCP; não presuma que todo cliente tem a mesma tela de aprovação.

Mantenha credenciais fora da especificação.

Nunca peça ao usuário para colar chaves de API, tokens de acesso, senhas ou credenciais de nuvem no chat. As variáveis de ambiente do job são para configuração não sensível: elas, comandos, links e caudas de log podem ser retidos. Credenciais pertencem aos Segredos salvos do usuário em symbioza.dev/app/secrets, anexadas a um job pelo nome. Um segredo salvo é armazenado criptografado e nenhuma página, API ou ferramenta retorna seu valor; um job que o anexa recebe os valores em forma clara, e a máquina que executa esse job pode tecnicamente lê-los. Valores salvos são removidos da saída impressa de um job apenas por correspondência exata, e arquivos que o job escreve não são escaneados. Nunca forneça chaves privadas SSH. Leia o Aviso de privacidade antes de enviar dados.