Comment Historia utilise une collection, en termes simples. Chaque ligne ci-dessous décrit ce que fait le code aujourd’hui.
Quand un élève pose une question, le serveur d’Historia envoie des mots-clés à l’API de recherche publique ou à la recherche du catalogue de chaque archive adaptée à la question, et lit ce qui revient : titres, auteurs, dates, descriptions et liens.
Pour vérifier une citation, ou pour indiquer quelle page lire dans un long document, il peut aussi récupérer le texte ou le fichier public que l’archive publie pour ce seul document, comme un texte OCR ou une transcription. Il n’explore pas les sites et ne suit pas les liens de page en page.
Des liens seulement. L’élève est envoyé sur la page de l’archive elle-même pour le document. Historia n’héberge, n’intègre et ne republie ni images ni fichiers. La seule exception concerne les films d’archives de la Library of Congress, des National Archives et de l’Internet Archive, lus dans la page depuis les serveurs de l’archive elle-même, et seulement après que l’élève a appuyé sur lecture.
Archives interrogées aujourd’hui : Library of Congress · Chronicling America · Smithsonian Institution · Digital Public Library of America · Internet Archive · OpenAlex · Semantic Scholar · Europe PMC · ERIC · National Archives Catalog (NARA) · The National Archives (UK) · Gallica · Wellcome Collection · The Metropolitan Museum of Art · Art Institute of Chicago · Old Bailey Online · GovInfo · CourtListener · legislation.gov.uk · World Digital Library · DigitalNZ · Wikisource · Hansard · Deutsches Textarchiv
Chaque résultat affiche le nom de l’archive et le dépôt indiqué par la notice de l’archive elle-même. Le titre, l’auteur, la date et le lien sont copiés de la réponse de l’archive. L’IA ne les écrit jamais.
Une citation est copiée du texte de l’archive par sa position en caractères, puis vérifiée de nouveau sur le serveur avant d’être affichée. Elle apparaît toujours avec sa notice et un lien vers celle-ci.
Une référence mise en forme par Historia pour un élève nomme le dépôt et donne le lien de la notice.
Pour qu’une recherche répétée n’interroge pas de nouveau une archive, Historia garde quatre choses pendant sept jours : la réponse d’une archive à une recherche (les champs renvoyés et le texte qui les accompagnait), la réponse finale à une question (titres, liens et courtes citations), le fait que le lien d’une notice s’ouvre encore, et les indications de pages d’un document. Au bout de sept jours, la recherche suivante interroge de nouveau l’archive.
Aucune image ni aucun fichier n’est stocké. Un fichier lu pour les indications de pages est lu puis abandonné ; seuls les numéros de page, le nombre de correspondances et une courte ligne de texte autour de chacune sont gardés.
Pour demander une purge, écrivez à thehistoria.company@gmail.com en nommant votre service. Nous supprimons ces copies de la base de données à la main.
Les requêtes des serveurs d’Historia indiquent Historia et une adresse de contact dans l’en-tête User-Agent. Les recherches envoient Historia/1.0 (historia.organization@gmail.com). La recherche d’indications de pages envoie Historia/1.0 (thehistoria.company@gmail.com) where-to-look.
Une recherche envoie quelques requêtes à chaque archive adaptée à sa question, en même temps. Les recherches générales sur loc.gov sont limitées à quatre par recherche. Des requêtes identiques simultanées sont envoyées une seule fois et partagées, et une recherche identique à une recherche en cours attend celle-ci au lieu d’interroger de nouveau. Semantic Scholar est interrogé au plus une fois toutes les 1,1 seconde depuis chaque serveur.
Aucune requête n’attend plus de 60 secondes. Une requête refusée n’est pas renvoyée, sauf celles de Semantic Scholar au sein de la même recherche. Une erreur de votre service est enregistrée avec son nom d’hôte et son code de statut seulement.
Écrivez à thehistoria.company@gmail.com, de préférence depuis l’adresse de votre établissement. Nous pouvons cesser d’envoyer des requêtes à votre service, interroger moins souvent, modifier la façon dont vos résultats sont signalés ou crédités, ou effacer ce qui est en cache chez nous pour votre service. Chacun de ces changements se fait à la main, et nous répondons pour dire quand c’est fait.
Si vous acceptez, Historia affiche un petit bandeau signalé, « Ressources pédagogiques de partenaires », sous les résultats d’archives quand la recherche d’un élève correspond aux thèmes que vous choisissez. Il porte votre mention de crédit telle que vous la donnez et un lien qui ouvre votre propre site.
C’est un lien seulement : rien de vous n’est copié ni intégré. Il n’apparaît jamais parmi les notices d’archives ni à leur place, affiche au plus trois liens et n’apparaît pas quand rien ne correspond.
Nous ne l’ajoutons qu’après un accord écrit, et le retirons à votre demande. Les partenaires approuvés figurent sur la page presse.
Écrivez à thehistoria.company@gmail.com. Une personne vous répond.