Cursiva

Devolve as regras do Cursiva para montar uma prova na conversa: como trabalhar, as regras do blueprint e das questões (as mesmas que a geração do Cursiva usa), o formato e os limites da create_exam, as regras de figura e de código quando a matéria aceita e as preferências do professor para a matéria. Chame antes de planejar uma prova, com a turma e com os tipos de questão que ela vai ter (types). Não grava nada.

get_exam_authoring_guide

Devolve o pedido completo que o professor montou no wizard (conteúdos, quantidades, tipos, dificuldade, pontuação, pesos, contexto, textos de apoio, anexos e imagens) e o roteiro para escrever a prova a partir dele. Chame quando chegar a mensagem do Concluir com o plan_id. Não gera nada.

get_exam_wizard_plan

Lê um anexo ou uma imagem que o professor mandou no wizard e devolve o conteúdo em texto. PDF com texto, DOCX e TXT são extraídos sem IA; imagem, foto e PDF escaneado são lidos pela IA do Cursiva, que devolve o texto escrito em text e o que a imagem mostra em description, e contam na cota do professor. Com readable false e reason quota, avise o professor e siga sem o arquivo.

read_wizard_attachment

Lê um arquivo que você não consegue abrir sozinho (imagem, foto de página, PDF escaneado) usando a IA do Cursiva, e devolve a transcrição do texto, a descrição do que as imagens mostram, um resumo, os temas, o ano indicado e quantas questões distintas o material sustenta, para você usar no blueprint da prova. Aceita JPEG, PNG, WebP e PDF. Usa a cota de IA do professor: chame só quando não conseguir ler o arquivo por conta própria, e uma vez por arquivo. Antes de pedir ao professor o conteúdo do material, use esta ferramenta.

read_material

Mostra quem é o professor conectado ao Cursiva: nome, e-mail, conta e escola em que está conectado, plano e níveis de ensino. Use quando o professor perguntar "quem sou eu no Cursiva?", "qual é o meu plano?" ou "em qual escola ou conta estou conectado?".

get_my_profile

Lista as matérias do professor, com o nome que ele vê no Cursiva. Chame esta ferramenta antes de pedir ao professor dados que o Cursiva já tem, como a matéria de uma prova. Use também quando ele perguntar "quais matérias eu dou?".

list_subjects

Lista as provas do professor, da mais recente para a mais antiga: título, turma, matéria, situação (gerando, rascunho, aguardando correção, em correção ou corrigida), data, número de questões e o link para abrir no Cursiva. Aceita filtros por turma, matéria e situação. Chame esta ferramenta antes de pedir ao professor dados que o Cursiva já tem, como as provas anteriores de uma turma. Use também para "quais provas ainda não corrigi?" (status aguardando_correcao). Ao listar, mostre o link "Abrir no Cursiva" de cada prova. Para ver as questões de uma prova, use get_exam.

list_exams

Lista as turmas ativas do professor: nome, matéria, nível de ensino, série, período, dias da semana e quantidade de alunos (nunca os nomes dos alunos). Chame esta ferramenta antes de pedir ao professor dados que o Cursiva já tem, como turma, série ou matéria. Use também quando ele perguntar "quais são as minhas turmas?".

list_classrooms

Mostra ao professor o plano (blueprint) da prova em um componente: uma linha por questão com tipo, tema, dificuldade e pontos, o total e o aviso de capacidade do material. Chame depois de ler o guia (get_exam_authoring_guide) e de montar o blueprint, em vez de escrever o plano em texto. O professor ajusta no componente e clica em Escrever questões; o plano final chega como mensagem dele. Só então escreva as questões. Não grava nada.

show_exam_plan

Uso interno do componente do wizard: cabeçalhos da escola da turma, preferências da matéria e o rascunho salvo.

get_exam_wizard_options

Uso interno do componente do wizard: abre (ou reaproveita) a captura de fotos pelo celular para um conteúdo.

request_photo_capture

Uso interno do componente do wizard: confere tipo e tamanho e devolve uma URL de envio direto ao armazenamento do Cursiva.

request_file_upload

Mostra a prova ao professor como ela vai sair impressa, com o gabarito marcado, e confere tudo o que create_exam confere, sem gravar nada. Chame depois de escrever as questões, com o mesmo payload de create_exam em exam. Para refazer só algumas questões, mande base_preview_id (o previewId da última prévia) e replace_questions com o número e a questão nova: as outras ficam como estão, com as edições do professor. Depois do wizard, mande plan_id em exam e, em cada questão, content (e image quando o plano marcar imagem): a prévia confere a prova contra o plano e aponta o que não bate. Problemas voltam por questão em problems; corrija e chame de novo. Nunca chame create_exam por conta própria depois da prévia: o professor salva pelo botão do componente.

preview_exam

Uso interno do componente do wizard: salva o rascunho de uma etapa no plano da prova. Não gera a prova.

save_exam_wizard_step