O que main faz?
Motor de roteamento de grafos leve que permite que estruturas de modelos localizadas transfiram tarefas em caso de falha.
Visão Geral
Este skill implementa um mecanismo de roteamento baseado em grafo para modelos de linguagem locais (como os fornecidos pelo Ollama). Ele organiza as tarefas em nós interconectados, onde cada nó pode conter um prompt, um modelo específico ou uma lógica de decisão. Quando um nó falha (por exemplo, saída inválida, timeout ou falha na validação), o motor redireciona automaticamente o fluxo para um nó de fallback ou reinicia a partir de um ponto anterior, sem intervenção manual.
Como Funciona
- Definição do Grafo: O usuário define um grafo direcionado onde cada nó representa uma etapa do workflow.
- Execução: O motor percorre o grafo, executando cada nó com o modelo local apropriado.
- Tratamento de Falhas: Se um nó retorna erro ou resultado inesperado, o motor consulta arestas de fallback definidas no grafo.
- Redirecionamento: A tarefa é enviada para o nó de fallback configurado, que pode usar um modelo diferente ou uma estratégia alternativa.
Exemplo de Uso
# workflow.yaml
nodes:
- id: classificacao
model: llama3.2
prompt: "Classifique o texto como 'positivo' ou 'negativo'."
- id: fallback_classificacao
model: mistral
prompt: "Classifique novamente o texto, considere respostas ambíguas."
edges:
- from: classificacao
to: fallback_classificacao
on_failure: true
Plataformas Suportadas
- Claude Code
- Cursor
- Codex CLI
- Qualquer agente que suporte execução de scripts Python ou YAML
Instalação
Clone o repositório:
git clone https://github.com/seu-usuario/ollama-workflows.git
cd ollama-workflows
pip install -r requirements.txt
Configuração
Defina as variáveis de ambiente:
OLLAMA_HOST(opcional): URL do servidor Ollama (padrão:http://localhost:11434)WORKFLOW_DEFAULT_MODEL(opcional): Modelo padrão para nós não especificados
Licença
MIT