Este é o manual operacional: o que você clica, em que ordem, e o que a coisa que você acabou de clicar realmente faz. Ele pressupõe que você decidiu experimentar a plataforma e quer que o semestre corra bem, em vez de lhe vender algo. Se você ainda não decidiu, a página de visão geral é uma leitura mais curta.
1. Antes de começar
O que você precisa
- Um navegador. Nada é instalado, por você ou por seus estudantes. Chrome, Edge, Firefox ou Safari recentes.
- Um endereço de email institucional. Você pode entrar com qualquer coisa, mas
reivindicar ou criar um curso exige verificação em relação a um domínio acadêmico
(
.edu,.edu.tw,.ac.jpe similares). Endereços pessoais como Gmail não são aceitos para essa etapa. - Um aplicativo autenticador no seu telefone. A autenticação de dois fatores é obrigatória para contas de professor — veja abaixo.
- Cerca de duas horas para a configuração inicial de um curso: aproximadamente uma hora escrevendo as instruções do assistente e uma hora enviando material.
Criando uma conta
Acesse uedu.tw/signin e entre com Google, Apple,
GitHub, uma chave de acesso ou email e senha. Se sua instituição tiver seu próprio ponto de entrada
(yourschool.uedu.tw), use-o em vez disso — é a mesma plataforma com a marca da sua
instituição, e toda conta e curso funciona de forma idêntica em qualquer uma das opções.
Toda conta com direitos de professor, assistente de ensino ou administrador deve ativar a 2FA, e outros recursos permanecem restritos até que ela seja configurada. O motivo é direto: uma conta de professor pode ler o diálogo dos estudantes. Configure-a durante a mesma sessão em que a reivindicação do seu curso é aprovada, e guarde os códigos de recuperação em algum lugar que não seja o mesmo telefone.
Idioma da interface e fusos horários
- A interface está disponível em 16 idiomas; o seletor fica no cabeçalho e a configuração acompanha sua conta. Os estudantes escolhem a própria independentemente de você.
- Os estudantes conversam com o assistente no idioma em que escreverem, independentemente do idioma da interface.
- Os horários são armazenados em UTC e exibidos no fuso horário local de cada visualizador. Um prazo que você definir às 23:59 no seu horário aparece corretamente para um estudante em outro país — você não precisa calcular um deslocamento, e não deve tentar fazê-lo.
2. Obtenção de um curso
Um curso é a unidade da qual tudo depende: o assistente, o material, as atividades avaliativas, as análises. Há duas formas de obter um, e ambas terminam em uma breve revisão humana que confirma que você é o docente que afirma ser.
Path A — reivindicar um curso existente
Se o catálogo da sua instituição tiver sido importado, seu curso provavelmente já está no sistema e você o reivindica, em vez de criá-lo.
- Na barra lateral: Teaching toolkit → Course setup → Claim a course.
- Pesquise por instituição, período e nome ou código do curso e, em seguida, reivindique a entrada correspondente.
- Verifique sua identidade: digite seu e-mail institucional, receba um código de seis dígitos e digite-o. O código é válido por 15 minutes, e há um período de espera de cinco minutos entre os envios.
- Envie: seu nome, sua unidade e, opcionalmente, um documento que dê suporte à reivindicação (certificado de docência, carta de designação, uma captura de tela do seu horário — PDF, DOC, DOCX, JPG ou PNG, até 5 MB). Opcional, mas acelera a revisão.
- Aguarde o e-mail de aprovação. Você pode acompanhar o andamento em My claim requests.
Path B — criar um novo curso
Se o catálogo não tiver o seu curso — o que é o caso normal para uma instituição que não nos enviou um — crie-o. Mesmo passo de verificação, mesma revisão.
- Obrigatório: nome do curso, instituição, período. Todo o resto pode ser editado depois.
- Cole seu plano de ensino no campo de descrição. Se fizer isso, o sistema elabora a partir dele um conjunto inicial de instruções do assistente, o que é um ponto de partida muito melhor do que uma caixa vazia. Este é o campo opcional de maior valor no formulário.
O curso é criado como privado por padrão, com um código de entrada de seis caracteres. Nada fica visível para ninguém até que você forneça esse código. O e-mail de aprovação contém o link de entrada do estudante.
3. Redigindo o assistente
As instruções do assistente — o seu prompt de sistema — são a única configuração que determina se os estudantes o consideram útil. Trata-se de texto livre em qualquer idioma, não é código e pode ser editado a qualquer momento durante o semestre.
Onde
Teaching toolkit → Teacher console → seu curso → Teacher dashboard → Course management → Course settings.
O que colocar nele
Quatro elementos, nesta ordem, cobrem a maior parte do que importa:
- Papel. "Você é o assistente de ensino para Introduction to Political Theory, um curso de graduação do primeiro ano."
- Fatos do curso. Nível, textos principais, o que foi coberto até agora, tudo o que, de outro modo, o assistente poderia supor incorretamente.
- Como responder. Profundidade, exemplos desenvolvidos, quando fazer uma pergunta de esclarecimento, em que idioma responder se você quiser um fixo.
- Limites. O que ele deve recusar ou redirecionar — "não escreva o ensaio para o estudante", "para perguntas administrativas sobre prazos, diga que eles devem me perguntar".
Os assistentes do curso respondem diretamente por padrão. Isso é deliberado: um estudante preso às 1 a.m. precisa de uma resposta, e o questionamento indireto constante por um assistente do curso soa como evasão. O questionamento socrático está disponível como um modo explícito (capítulo 6), e o companheiro de aprendizagem independente, Aida, é socrático por projeto. Escolha o comportamento que você quer em vez de herdar um.
Erros comuns
- Longo demais. Duas mil palavras de instruções produzem comportamento pior do que trezentas bem escolhidas. Escreva menos e então adicione regras quando você vir algo de que não goste no diálogo real.
- Regras contraditórias. "Nunca dê respostas" mais "seja útil e completo" se resolve de forma imprevisível. Decida qual prevalece e diga isso.
- Fatos que pertencem ao material. Não cole o conteúdo da sua lista de leitura no prompt. Envie os textos de leitura (capítulo 4) — então ele poderá citá-los.
- Escrevê-lo uma vez. Leia uma amostra de diálogo real na segunda semana e revise. É a melhoria mais rápida disponível, e quase ninguém faz isso.
4. Adicionando seu próprio material
O material enviado é o que transforma um modelo geral em um assistente de curso. Quando a pergunta de um estudante se relaciona a algo que você enviou, os trechos relevantes são recuperados e usados, e a resposta cita o arquivo e a página para que o estudante possa conferi-la com a fonte.
Como fazer
- Painel do professor → base de conhecimento de IA → upload. PDF, DOCX e PPTX são os formatos normais.
- O processamento é executado em segundo plano; um arquivo grande fica utilizável em minutos, não instantaneamente.
- Envie as leituras com as quais os estudantes realmente trabalham — slides de aula, capítulos que você tem direito de distribuir, suas próprias anotações, exemplos resolvidos antigos.
- PDFs escaneados sem camada de texto. Um capítulo de livro fotografado é uma imagem no que diz respeito à recuperação. Se você conseguir selecionar texto no seu visualizador de PDF, ele funcionará; se não conseguir, execute OCR primeiro.
- Material que você não pode distribuir. O upload é distribuição para a sua turma. A responsabilidade pelos direitos autorais é sua, exatamente como ocorre no LMS da sua instituição.
O que isso possibilita posteriormente
- Respostas fundamentadas e citadas em diálogo.
- Elaboração de quizzes e folhas de exercícios a partir do seu conteúdo real, em vez do conhecimento geral do modelo.
- O grafo de conhecimento do curso, que extrai conceitos e suas relações do material e depois acompanha quais conceitos cada estudante demonstrou compreender. Ele não pode ser gerado sem material enviado.
Os parâmetros exatos de recuperação — chunk size, embedding model, top-k — estão documentados para as seções de métodos em a nota metodológica de recuperação (chinês).
5. Escolhendo um modelo
A maioria dos cursos nunca acessa esta página e fica bem. Leia este capítulo apenas se você tiver um motivo específico para isso.
| Opção | Precisa de uma chave de API? | Quando usá-la |
|---|---|---|
| Padrão da plataforma (nível gratuito) | Não | Tudo, a menos que você tenha um motivo em contrário. Ativado automaticamente em todos os cursos; é o que os estudantes recebem se você não mudar nada. |
| Modelos avançados da OpenAI | Sim — a própria chave OpenAI do seu curso | Cursos cujas perguntas realmente precisam de raciocínio mais pesado: matemática baseada em provas, revisão complexa de código, trabalho analítico profundo. |
| Modelos Anthropic ou xAI | Sim — uma chave para esse provedor | Quando você especificamente quiser um provedor diferente, inclusive como ponto de ensino sobre diferenças entre modelos. |
A configuração fica em Modelos e chaves de API no painel do docente. As chaves são por curso, e o uso de uma chave é cobrado nessa conta pelo provedor. Os modelos avançados só ficam selecionáveis para os estudantes depois que uma chave válida estiver em vigor; sem uma, o curso simplesmente funciona no padrão gratuito.
A classificação de nível cognitivo, a indexação de recuperação e o outro trabalho analítico sempre são executados na capacidade da plataforma, mesmo em um curso que forneça a própria chave. Sua chave paga apenas pelo que as conversas dos seus estudantes consomem.
6. Modos socrático e de debate
Dois modos opcionais, habilitados por curso e organizados em torno dos tópicos que você definir. Ambos são recursos do curso — não estão disponíveis nos assistentes pessoais que os estudantes constroem para si mesmos.
| Modo | O que o assistente faz | Funciona bem para |
|---|---|---|
| Diálogo socrático | Conduz com perguntas em vez de respostas, sobre um tópico que você definir, e continua exigindo razões. | Trabalho de formação de conceitos, ética, interpretação, qualquer situação em que a própria formulação do estudante seja o ponto central. |
| Debate | Defende uma posição para que o estudante tenha de responder a um interlocutor real em vez de a uma página em branco. | Prática de argumentação, preparação para seminário, exame de uma posição com a qual a turma concorda com facilidade demais. |
Como usá-los bem
- Dê a eles um espaço, não o curso inteiro. Uma única sessão socrática bem formulada, da qual os estudantes saibam que virá, é melhor do que deixar o modo ativo o semestre inteiro.
- Escreva o tópico como uma pergunta com uma discordância real nela. "A desobediência civil é alguma vez justificada em uma democracia funcional?" produz diálogo; "Discuta a desobediência civil" produz resumos.
- Diga aos estudantes o que o modo está fazendo. Um assistente que de repente se recusa a responder diretamente parece estar com problema, a menos que o estudante saiba que isso é deliberado.
- Não o use para consulta factual. Ser questionado sobre uma definição de que você precisa para terminar uma lista de exercícios é irritante, não educacional.
A avaliação pré e pós-diálogo em torno de sessões socráticas está disponível se você quiser uma medida de antes/depois em vez de uma impressão; o método está documentado em a nota socrática pré/pós (Chinese).
7. Admitindo estudantes
Os cursos são privados quando criados. Há quatro formas de acesso, e você pode usar mais de uma.
| Route | How it works | Best for |
|---|---|---|
| Join code | Six characters. The student enters it and is in immediately, no approval step. | The normal case. Put it on a slide in week one. |
| Enrolled list | You paste your roster of student numbers; a listed student who opens the course link joins automatically. | Large courses where you already have the official roster. |
| Request and approve | A student without the code requests access; you or a teaching assistant approves or declines. Both of you are notified by email. | Late joiners, auditors, students from another programme. |
| Public course | Anyone with the link joins with no code and no approval. | Open workshops and demonstrations. Not for a normal class. |
Notas práticas
- Faça a entrada em aula. Cinco minutos com o código na tela colocam quase todo mundo dentro. Defini-lo como tarefa de casa faz com que um quarto da turma se perca por semanas.
- Há um código QR para o mesmo link, que é a rota mais rápida em um auditório.
- Regenerar o código invalida imediatamente o antigo. Estudantes já no curso não são afetados; estudantes que ainda não se inscreveram precisam do novo código. Regere se um código vazar além da turma, não casualmente.
- Tentativas repetidas com código incorreto são limitadas por taxa por conta, de modo que um código parcial vazado não pode ser forçado por tentativa exaustiva.
- O código é visível apenas para professores e monitores — estudantes no curso não conseguem lê-lo na interface e repassá-lo.
- Você pode alternar um curso entre privado e público a qualquer momento.
8. Atividades ao longo do semestre
As ferramentas abaixo são todas opcionais. Um curso perfeitamente bom usa o assistente e nada mais. Acrescente uma coisa por vez; adicionar cinco na primeira semana é a maneira mais segura de abandonar todas elas até a quarta semana.
| Ferramenta | O que ela faz | O que você deve saber |
|---|---|---|
| Quizzes | Elabora perguntas a partir do seu material por tipo e dificuldade; você edita e publica. | Nada chega aos estudantes até que você publique. Trate o rascunho como uma primeira versão de um assistente capaz, não como uma avaliação concluída. |
| Worksheets | Folhas de exercícios estruturadas geradas a partir de material ou de uma transcrição de gravação da aula. Itens de múltipla escolha são corrigidos automaticamente; respostas abertas são pré-marcadas para sua confirmação. | A pré-marcação é uma sugestão. Você confirma ou altera cada nota de resposta aberta. |
| Discussion forum | Quadro do curso, com um esquema opcional de pontuação que pondera qualidade semântica e resposta dos colegas em vez da contagem de publicações. | Se você avaliar a participação, use isto em vez de contar publicações — veja o capítulo 10. |
| Surveys | Pesquisas na plataforma, com horários programados de abertura e encerramento. | Prefira estas a um formulário externo: as respostas permanecem dentro do mesmo arranjo de governança e consentimento que o restante do curso. |
| Assignments and gradebook | Entrega, correção e um gradebook para o qual as outras ferramentas alimentam dados. | Os prazos são inseridos no seu horário local e exibidos no de cada estudante. |
| Class recording | Captura de áudio, tela ou webcam durante a aula, com transcrições geradas depois. | O compartilhamento com estudantes está desativado a menos que você o ative. Informe sua turma de que você está gravando — essa é a regra da sua instituição, não a nossa, e ela se aplica. |
| Live classroom tools | Enquetes, um mural de perguntas, nuvens de palavras, contagens regressivas. | Úteis na sala, esquecíveis fora dela. Experimente uma aula antes de planejar um curso em torno delas. |
| Announcements and email | Avisos do curso com anexos e e-mail para toda a turma. | Os avisos são o canal confiável; os estudantes não leem de forma confiável mais nada . |
| Aida | Uma companheira de aprendizagem independente que funciona em todo o programa do estudante e é deliberadamente socrática. | Ela é do estudante, não sua. Você não a configura e você não a vê, e dizer isso aos estudantes vale a pena. |
9. Lendo a análise
Esta é a parte da plataforma que não existe em outros lugares, e também a parte mais facilmente lida em excesso. Ambas as metades dessa frase importam.
Análise em nível cognitivo
Toda mensagem de estudante é classificada automaticamente e de forma assíncrona, sem nenhuma ação sua, em relação à taxonomia revisada de Bloom — Recordar, Compreender, Aplicar, Analisar, Avaliar, Criar. Você vê a distribuição da turma, um perfil por estudante e como a média da turma se move ao longo do semestre.
- Leia a tendência, não o nível. Uma distribuição absoluta reflete principalmente sua área e o desenho da sua avaliação. Uma distribuição que muda depois que você altera algo é informativa.
- Espere muito de Compreender. É isso que parece pedir a um assistente de disciplina, em todo curso que vimos. Isso não é uma constatação sobre seus estudantes.
- Método e suas limitações: a nota metodológica sobre o nível cognitivo (chinês). Se você estiver publicando, leia primeiro o capítulo 9 do manual de pesquisa.
Grafo de conhecimento
Conceitos e relações extraídos do seu material enviado, com a cobertura demonstrada de cada estudante sobreposta. Seu uso prático é identificar lacunas antes da semana de revisão: conceitos no seu mapa que quase nunca são tocados em diálogos. Requer material enviado (capítulo 4).
Portfólios de aprendizagem
Uma visualização por estudante ao longo de conversas, avaliações e participação. Os estudantes podem exportar os próprios.
- Contagens de mensagens não são engajamento. Um estudante que fez três perguntas excelentes pode ter aprendido mais do que outro que fez quarenta.
- A classificação é uma saída do modelo. Ela é consistente e útil em agregado; não é uma verdade fundamental sobre uma mensagem individual, e nunca deve ser a única base de uma decisão sobre um estudante individual.
- A ausência de diálogo não é ausência de aprendizagem. Alguns estudantes não usam assistentes. Isso é permitido.
10. Avaliação: a única regra
Você controla tanto a nota quanto os dados. A plataforma impõe exatamente uma proibição aqui e deixa o restante ao seu julgamento profissional.
A participação em pesquisa — assinar um consentimento de pesquisa, permitir que os dados sejam usados em um estudo — é completamente separada das notas da disciplina. Um estudante que recusa, ou que se retira no meio do semestre, ainda frequenta, ainda usa o assistente e ainda é avaliado exatamente como antes; apenas os dados dele são excluídos. Oferecer pontos por assinar um termo de consentimento, ou exigir participação para cursar a disciplina, é uma violação grave da ética em pesquisa, e nenhum recurso da plataforma ou formulação pode sugerir o contrário. Sob a assimetria de poder entre professor e estudante, "voluntário" com uma nota atrelada não é voluntário.
Avaliar o uso de IA é sua decisão
Exigir que os estudantes usem o assistente e contar isso para a nota é o mesmo tipo de decisão que avaliar a frequência ou a contribuição em seminário: isso pertence à sua autonomia de ensino, e a plataforma nem proíbe nem exige isso. Nosso papel é fornecer os dados e os sinais de qualidade; o que você conta, e como, é decisão sua.
Contagens de mensagens e de palavras são trivialmente inflacionáveis, e um esquema baseado nelas ensina os estudantes a inflacioná-las. Sempre que possível, avalie algo que a plataforma já tenha ajustado pela qualidade:
- Pontuação do fórum — crédito ponderado combinado com reação dos pares, avaliação semântica da qualidade e verificações de originalidade, o que desconta automaticamente o enchimento.
- Qualidade do diálogo socrático — avaliada pela substância das contribuições e não pelo número delas.
- Distribuição por nível cognitivo — mais próxima do engajamento intelectual do que qualquer medida de volume, embora veja as ressalvas no capítulo 9.
Dois lembretes práticos
- Anuncie com antecedência. Se o uso de IA contar para a nota, coloque o esquema no plano de ensino na primeira semana. Isso é transparência normal de avaliação e evita a maioria das disputas.
- A avaliação muda os dados. Se mais tarde você quiser publicar sobre esta disciplina, o comportamento produzido por um incentivo de nota não é o mesmo fenômeno que o uso espontâneo. Declare isso em seus métodos, ou controle isso.
11. Assistentes de ensino
Assistentes de ensino compartilham a condução de uma disciplina. Há dois níveis, e a diferença é inteiramente em relação aos dados.
| Papel | Pode fazer | Requisito |
|---|---|---|
| Assistente de ensino | Executar as ferramentas da disciplina, aprovar solicitações de ingresso, gerenciar membros, corrigir trabalhos. | 2FA, como toda conta de equipe. |
| Assistente de ensino sênior | Tudo acima, além de exportar dados da disciplina. | 2FA, além de assinar um termo de confidencialidade antes que qualquer exportação seja possível. |
- Conceda o nível sênior apenas a pessoas que realmente precisem lidar com dados de estudantes — tipicamente um assistente de pesquisa em um estudo, não um corretor.
- O acesso é por disciplina. Um assistente de ensino em uma disciplina não vê nada de outra.
- Remova as pessoas quando o semestre terminar. Nada faz isso por você.
12. Quando as coisas dão errado
| Sintoma | Geralmente porque | Correção |
|---|---|---|
| Estudantes dizem que o código não funciona | O código foi regenerado depois de você o ter divulgado, ou eles estão digitando um caractere de aparência semelhante. | Verifique o código atual no gerenciamento do curso e compartilhe novamente. O alfabeto
do código omite deliberadamente os caracteres que as pessoas confundem — 0, 1,
I, L e O nunca aparecem em um código, então um estudante
que acha que vê um O está olhando para um D ou um Q. |
| O assistente ignora suas instruções | O prompt é longo demais, ou contém duas regras que se contradizem. | Corte-o pela metade e remova a contradição. Teste com a pergunta exata que apresentou problema. |
| As respostas nunca citam o seu material | Nada foi enviado, ainda está processando, ou o PDF não tem camada de texto. | Verifique a lista da base de conhecimento; execute OCR em arquivos digitalizados. |
| O grafo de conhecimento não será gerado | Nenhum material enviado. | Envie o material primeiro — ele é gerado a partir do seu conteúdo, não do título do curso. |
| As análises estão vazias | Ainda não há diálogo suficiente, ou a turma ainda não começou a usar o assistente. | Aguarde. A análise de nível cognitivo é assíncrona e precisa de volume antes que uma distribuição signifique alguma coisa. |
| O e-mail de verificação nunca chega | Filtragem de spam, ou um gateway de e-mail institucional. | Verifique o spam, depois reenvie após o período de espera. Se ainda falhar, envie-nos um e-mail — podemos ver se ele foi enviado. |
| Estudantes encontram um erro com sua própria chave de API | A chave é inválida, expirou ou está sem cota. | Substitua-a em Models and API keys. O modelo padrão gratuito permanece disponível aos estudantes o tempo todo, então a turma não fica bloqueada enquanto você resolve isso. |
| Você perdeu seu dispositivo de 2FA | Acontece. | Use um código de recuperação. Se não tiver nenhum, envie-nos um e-mail a partir do seu endereço institucional verificado. |
Qualquer coisa que não esteja nesta tabela: [email protected]. Inclua o nome do curso e o que você esperava que acontecesse. Não há sistema de abertura de chamados e nenhum tempo de resposta garantido — uma descrição precisa obtém uma resposta mais rápida do que uma urgente.
13. Lista de verificação da primeira semana
- Conta criada e 2FA ativado, códigos de recuperação guardados em outro lugar.
- Curso reivindicado ou criado, aprovação recebida.
- Instruções do assistente redigidas — função, fatos do curso, como responder, limites.
- Leituras centrais enviadas, e uma pergunta de teste feita por você para confirmar que o assistente as cita .
- Sua política de IA escrita no plano de ensino, incluindo se o uso é avaliado.
- Código de entrada em um slide, e cinco minutos do tempo de aula reservados para os estudantes entrarem.
- Uma nota em seu calendário para a segunda semana: leia vinte conversas reais e revise as instruções.
Planejando publicar a partir do curso? Leia o manual de pesquisa antes do início do semestre — coletar qualquer coisa além do uso ordinário da plataforma exige tempo de preparação, e essa é a única coisa que não pode ser corrigida retrospectivamente. Precisa convencer um colega ou um departamento primeiro? O manual de divulgação foi escrito para essa conversa.
Something in this handbook wrong, out of date, or missing? Write to [email protected] and say which chapter.
All handbooks · AI teaching overview · Publications · Research governance · uedu.tw
Uedu is developed by Chia-Kai Chang, Assistant Professor at the Center for General Education, National Central University, Taiwan, and is adopted by institutions beyond it. This handbook is available in English · 繁體中文 · 简体中文 · 日本語 · 한국어 · Tiếng Việt · Bahasa Indonesia · Bahasa Melayu · ไทย · Türkçe · Deutsch · Français · Español · Português · Italiano · Ελληνικά. The English version is the reference text. The platform interface itself is available in 16 languages.