Vai al contenuto
← Torna alle guide

API esterna: agent AI e ricerca semantica

API esterna ›Agent e ricerca semantica
7 aprile 2026Aggiornato: 7 aprile 20264 min di lettura1 visualizzazioni
Come interrogare l'AI e cercare documenti semanticamente via API

AI e ricerca semantica via API

L'API esterna offre due endpoint avanzati per sfruttare l'intelligenza artificiale.

Ricerca semantica

POST /api/v1/dam/external/assets/semantic-search/

{
  "query": "contratti con penali in scadenza nel 2026",
  "category": "contratti",
  "limit": 10
}

Cerca documenti per significato, non solo per parole chiave. Richiede che il tenant abbia embedding configurati.

Agent query (RAG)

POST /api/v1/dam/external/agent/query/

{
  "question": "Quali contratti hanno penali superiori a 50.000 euro?",
  "include_sources": true
}

L'AI legge i documenti rilevanti e genera una risposta in linguaggio naturale con citazioni alle fonti. Ideale per:

  • Chatbot aziendali che rispondono su documenti
  • Agenti AI che analizzano portafogli contratti
  • Dashboard che generano riepiloghi automatici

AI on-demand

GET /api/v1/dam/external/assets/{id}/?ai_prompt=Riassumi le clausole penali

Chiedi all'AI di analizzare un documento specifico con un prompt personalizzato. La risposta viene aggiunta al campo ai_response nella risposta.

Requisito: tutti gli endpoint AI richiedono un connettore AI configurato nel tenant.