| """Tool: identifica em qual fase de Design Thinking o usuário está. |
| |
| Útil para o agente DesignMind saber se deve guiar o usuário a continuar |
| na fase atual ou avançar para a próxima. |
| """ |
|
|
| _PHASES: dict[str, list[str]] = { |
| "empatizar": [ |
| "entender cliente", "entrevista", "pesquisa", "observar", |
| "por que cliente", "feedback negativo", "queixa", "dor do usuário", |
| "não sei o que clientes querem", "shadowing", "mapa de empatia", |
| ], |
| "definir": [ |
| "sintetizar", "padrão nos dados", "principal problema", |
| "ponto de vista", "point of view", "como definir", |
| "qual é o problema real", "insight", |
| ], |
| "idear": [ |
| "brainstorm", "ideias", "como gerar", "soluções possíveis", |
| "how might we", "criatividade", "alternativas", |
| ], |
| "prototipar": [ |
| "protótipo", "mvp", "esboço", "mockup", "construir versão", |
| "testar versão", "fazer rápido", "low fidelity", |
| ], |
| "testar": [ |
| "testar com cliente", "feedback do protótipo", "validar", |
| "experimentar", "piloto", "usabilidade", |
| ], |
| } |
|
|
|
|
| def run_design_phase_validator(user_description: str) -> str: |
| """Identifica fase atual do DT e dá orientação curta sobre próximo passo.""" |
| text = user_description.lower() |
|
|
| scores: dict[str, int] = {} |
| for phase, keywords in _PHASES.items(): |
| scores[phase] = sum(1 for kw in keywords if kw in text) |
|
|
| if all(v == 0 for v in scores.values()): |
| return ( |
| "FASE: indefinida. Recomendação: pergunte ao usuário em qual fase " |
| "ele está (empatizar, definir, idear, prototipar, testar) ou ajude " |
| "a começar pela fase 1 (Empatizar)." |
| ) |
|
|
| phase: str = max(scores, key=lambda k: scores[k]) |
|
|
| next_step: dict[str, str] = { |
| "empatizar": "Próximo passo: realizar 5-7 entrevistas qualitativas com clientes reais.", |
| "definir": "Próximo passo: usar formato Point of View [usuário] precisa de [necessidade] porque [insight].", |
| "idear": "Próximo passo: aplicar How Might We — meta de 30+ ideias antes de filtrar.", |
| "prototipar": "Próximo passo: construir protótipo descartável (storyboard, papel, mockup).", |
| "testar": "Próximo passo: testar com 5-7 usuários, observe COMPORTAMENTO, não pergunte opinião.", |
| } |
|
|
| return f"FASE identificada: {phase.upper()}. {next_step[phase]}" |
|
|
|
|
| design_phase_validator_tool: dict = { |
| "type": "function", |
| "function": { |
| "name": "design_phase_validator", |
| "description": ( |
| "Identifica em qual das 5 fases de Design Thinking (Empatizar, " |
| "Definir, Idear, Prototipar, Testar) o usuário está. Use SEMPRE " |
| "no início da conversa para orientar a próxima ação." |
| ), |
| "parameters": { |
| "type": "object", |
| "properties": { |
| "user_description": { |
| "type": "string", |
| "description": "Texto que o usuário enviou descrevendo onde está.", |
| } |
| }, |
| "required": ["user_description"], |
| "additionalProperties": False, |
| }, |
| }, |
| } |
|
|
