Arengo per gli assistenti AI

Come collegarlo

Arengo usa il Model Context Protocol, lo standard con cui gli assistenti AI chiamano strumenti esterni. Nelle impostazioni del tuo assistente aggiungi un connettore o un server MCP remoto e incolla questo indirizzo. Non serve un account, ma ogni chiamata a uno strumento richiede una chiave gratuita, che per ora rilasciamo a mano: i dettagli sono più sotto, in «Limiti».

Per chi sviluppa: trasporto HTTP streamable, senza sessione, solo POST, risposte in JSON. Ogni strumento è in sola lettura.

Gli strumenti

• get_party_position

  La posizione documentata di un partito su uno dei 15 temi degli otto pilastri, da −5 a +5, con le fonti.

• list_party_positions

  Tutte le posizioni documentate di un partito, tema per tema.

• compare_parties_on_pillar

  I partiti messi in fila su un tema, da un estremo all'altro.

• get_party_statement_stances

  Che cosa ha detto un partito sulle affermazioni del test, con la citazione, la data e il documento del partito.

• get_pillar

  Che cosa misura un tema, a quale pilastro appartiene e che cosa vogliono dire i suoi due estremi.

• search_bills

  Cerca tra i disegni di legge di Camera e Senato.

• get_bill

  Un disegno di legge: titolo ufficiale, camera, collegamento alla scheda ufficiale e dove lo colloca Arengo sui pilastri.

• get_methodology

  Come Arengo calcola le posizioni e la vicinanza tra te e i partiti.

• get_glossary_term

  Il significato dei termini che usiamo.

Cosa contiene

• Le posizioni dei partiti sui 15 temi degli otto pilastri, lette da Arengo nei programmi, nelle mozioni e negli interventi in aula, con il documento che sta dietro ogni numero.
• I disegni di legge dai dati aperti della Camera dei deputati e del Senato della Repubblica: numero, titolo ufficiale e collegamento alla scheda della camera.
• Il metodo con cui Arengo calcola le posizioni e il glossario dei suoi termini.

Cosa resta fuori

• Nessun dato personale. Profili, risposte al test, commenti e voti di chi usa Arengo non passano da qui, nemmeno sommati.
• Le schede dei parlamentari e le singole votazioni restano fuori per ora. Alcuni dei loro campi vengono, o potrebbero ancora venire, da Openpolis, che concede i suoi dati solo per usi non commerciali.
• Per un disegno di legge scritto a partire da un titolo di Openpolis mancano sia il riassunto sia la collocazione sui pilastri. Torneranno quando li rifaremo dal titolo ufficiale.
• Nessun consiglio di voto. Gli strumenti danno dati e fonti. Una posizione che nessun documento sostiene risulta "none", senza numero, e non va raccontata come una posizione di centro.

Licenza e attribuzione

Ogni risposta porta le sue fonti numerate, un collegamento alla pagina di Arengo di ciò che cita e questa riga, che va mostrata ogni volta che usi i dati:

Le licenze indicate sono quelle che le due camere dichiarano sui propri siti e valgono per i loro dati: la Camera pubblica i suoi in CC BY-SA 4.0, il Senato in CC BY 3.0.

Il collegamento serve a chi legge per controllare la fonte da sé.

Limiti

Senza chiave puoi collegarti ed elencare gli strumenti, ma ogni chiamata a uno strumento richiede una chiave: senza, ricevi un errore 401.

Ogni chiave ha un limite giornaliero: 1000 chiamate al giorno con la chiave gratuita, 20.000 con quella per le redazioni. Il conto riparte a mezzanotte, ora di Roma.

La chiave va nell'intestazione Authorization, come Bearer, oppure in X-Api-Key.

Per ora le chiavi le rilasciamo a mano, una per volta, e non costano nulla.

Chi supera il limite riceve un errore 429 con il tempo di attesa.