File size: 4,723 Bytes
6f09332
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
b0c2285
6f09332
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
import os
import traceback
from dotenv import load_dotenv
from langchain_openai import ChatOpenAI # Atualizado para importação mais recente
from langchain_core.messages import SystemMessage, HumanMessage, AIMessage # Importa tipos de mensagem
import gradio as gr

# Carrega a chave do .env (bom para desenvolvimento local)
load_dotenv()

# Obtém a chave da API via variável de ambiente (essencial para Hugging Face Spaces Secrets)
# Certifique-se de configurar a Secret 'OPENROUTER_API_KEY' no seu Space
api_key = os.getenv("OPENROUTER_API_KEY")

# Verifica se a chave está disponível
if not api_key:
    print("⚠️ Aviso: Variável OPENROUTER_API_KEY não encontrada. Verifique as Secrets do seu Space.")
    llm = None
else:
    # Define as variáveis que o LangChain espera
    os.environ["OPENAI_API_KEY"] = api_key # Langchain usa essa variável
    os.environ["OPENAI_API_BASE"] = "https://openrouter.ai/api/v1" # OpenRouter base URL

    # Instancia o modelo
    try:
        llm = ChatOpenAI(
            # Você pode experimentar outros modelos otimizados para código se disponíveis via OpenRouter
            model="deepseek/deepseek-r1:free",
            temperature=0.5 # Talvez uma temperatura mais baixa seja melhor para explicações técnicas
        )
    except Exception as e:
        print(f"❌ Erro ao instanciar o modelo LLM: {e}")
        llm = None

# --- Mensagem de Sistema (Instrução para o Tutor de Python) ---
system_prompt = (
    "Você é um Assistente de Tutor para um curso de introdução e intermediário de Python. "
    "Seu papel é auxiliar os alunos a:\n"
    "- Entender conceitos fundamentais e avançados de Python (variáveis, tipos de dados, loops, funções, classes, módulos, etc.).\n"
    "- Explicar o funcionamento de trechos de código Python.\n"
    "- Ajudar a identificar e depurar erros comuns em códigos Python (erros de sintaxe, lógica, exceções).\n"
    "- Sugerir boas práticas de programação em Python.\n"
    "- Indicar recursos úteis para estudo (documentação oficial, tutoriais específicos, etc.).\n\n"
    "Responda de forma clara, didática, passo a passo e paciente. Ao analisar código com erro, explique a causa provável do erro e sugira como corrigi-lo, em vez de apenas fornecer a solução pronta. Incentive o aluno a pensar. "
    "Mantenha o foco estritamente em Python e conceitos de programação relacionados. Se a pergunta for muito fora de escopo, informe educadamente que você só pode ajudar com Python."
)

# --- Função para o Chatbot (sem alterações na lógica interna) ---
def responder(message, history):
    """
    Processa a mensagem do usuário, mantém o histórico e retorna a resposta do LLM.
    """
    if not llm:
        return "❌ Erro: A configuração da API ou do modelo LLM falhou. Verifique as configurações e a chave API."

    try:
        messages = [SystemMessage(content=system_prompt)]
        for human_msg, ai_msg in history:
            messages.append(HumanMessage(content=human_msg))
            messages.append(AIMessage(content=ai_msg))
        messages.append(HumanMessage(content=message))

        resposta = llm.invoke(messages)
        return resposta.content

    except Exception as e:
        print(f"❌ Erro durante a chamada do LLM:\n{traceback.format_exc()}")
        return f"❌ Desculpe, ocorreu um erro ao processar sua solicitação. Verifique a entrada ou tente novamente."

# --- Interface Gradio para o Tutor de Python ---

# !!! Lembre-se de atualizar o arquivo 'bot_avatar.png' no seu repo se desejar !!!
bot_avatar_path = "bot_avatar.png"
user_avatar_path = None

app = gr.ChatInterface(
    fn=responder,
    chatbot=gr.Chatbot(
        label="Chat com o Tutor",
        avatar_images=(user_avatar_path, bot_avatar_path),
        height=600
    ),
    textbox=gr.Textbox(
        placeholder="Digite sua dúvida sobre Python ou cole um trecho de código...",
        label="Sua Mensagem",
        scale=7
    ),
    title="Assistente-Tutor de Python 🐍",
    description="Precisa de ajuda com Python? Pergunte sobre conceitos, peça para explicar código, auxílio com erros e mais!",
    examples=[
        "Qual a diferença entre lista e tupla em Python?",
        "Como funciona um loop `for` com `range`?",
        "Me explique o que é programação orientada a objetos em Python.",
        "Meu código `print('Olá' + 5)` está dando TypeError, por quê?",
        "Como posso ler o conteúdo de um arquivo de texto?",
        "O que significa o erro 'IndentationError'?"
    ]
    # Botões padrão (Retry, Undo, Clear) serão adicionados automaticamente
)

# --- Lançamento da Aplicação ---
if __name__ == "__main__":
    app.launch()