Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

Attraverso l’endpoint Olostep /v1/answers puoi cercare sul web utilizzando il linguaggio naturale e ottenere risposte e dati potenziati dall’AI nella forma JSON che desideri. Questo ti permette di basare i tuoi prodotti su dati e fonti del mondo reale, arricchire punti dati o fogli di calcolo.
  • Fai una domanda o fornisci all’AI un punto dati che vuoi arricchire
  • Opzionale: specifica la struttura JSON che vuoi ricevere
Il sistema:
  • Cerca, pulisce, valida e restituisce i dati trovati sul Web
  • Restituisce le fonti utilizzate per generare la risposta
  • Gestisce l’incertezza con valori NOT_FOUND quando i dati non possono essere verificati
Per i dettagli dell’API, consulta la Riferimento API dell’Endpoint Risposte. Per impostazione predefinita utilizziamo un indice web generico e un validatore LLM economico. I clienti aziendali hanno accesso a indici web proprietari specifici per settore, dati privati esclusivi (inclusi numeri di telefono ed email) e modelli LLM personalizzati più adatti al loro caso d’uso. Contattaci per l’accesso: info@olostep.com

​
Casi d’uso

L’endpoint delle risposte può essere utilizzato per:
  • Basare le applicazioni AI su dati e fatti del mondo reale
  • Arricchire fogli di calcolo e punti dati per Reclutamento, Finanza, Consulenza e Vendite
Ecco una demo di un foglio di calcolo potenziato dall’AI grazie all’endpoint Risposte: https://www.olostep.com/demos/spreadsheet-enrich

​
Installazione

pip install olostep

​
Utilizzo

Fai una domanda e passa uno schema JSON per guidare l’output. Puoi anche non passare il parametro json e l’API restituirà un oggetto json con il testo della risposta all’interno del campo result. 
from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Qual è l'ultimo libro di J.K. Rowling?",
    json_format={"book_title": "", "author": "", "release_date": ""},
)

print(answer.json_content)
print(answer.sources)

​
Risposta

Come altri endpoint Olostep, riceverai un oggetto answer in risposta. L’oggetto answer ha alcune proprietà come id e result. 
{
  "id": "answer_9bi0sbj9xa",
  "object": "answer",
  "created": 1760327323,
  "metadata": {},
  "task": "Qual è l'ultimo libro di J.K. Rowling?",
  "result": {
    "json_content": "{\"book_title\":\"The Hallmarked Man\",\"author\":\"J.K. Rowling (as Robert Galbraith)\",\"release_date\":\"2 September 2025\"}",
    "json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/answer_9bi0sbj9xa.json",
    "sources": [
      "https://strikefans.com/the-books/",
      "https://www.facebook.com/groups/496943608606523/posts/1136830134617864/",
      "https://robert-galbraith.com/strike-books/",
      "https://www.novelsuspects.com/series-list/robert-galbraith-cormoran-strike-series-in-order/",
      "https://www.reddit.com/r/books/comments/1na833a/jk_rowlings_new_strike_novel_900_pages_of_romance/",
      "https://www.harrypotter.com/writing-by-jk-rowling",
      "https://stories.jkrowling.com/book-news/",
      "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
      "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
      "https://www.jkrowling.com/news/"
    ]
  }
}
La risposta richiesta, formattata secondo il parametro json, si trova in response.result.json_content e l’elenco delle fonti in response.result.sources. Puoi analizzare il JSON stringificato per accedere ai dati strutturati. 
{
  "book_title": "The Hallmarked Man",
  "author": "J.K. Rowling",
  "release_date": "2 settembre 2025"
}
Esempio di fonti: 
[
    "https://www.harrypotter.com/writing-by-jk-rowling",
    "https://stories.jkrowling.com/book-news/",
    "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
    "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
    "https://www.jkrowling.com/news/"
]
Quando non passi il parametro json, l’API restituirà un oggetto json con il testo della risposta all’interno del campo result. 
{
  "result": "L'ultimo libro di J.K. Rowling è The Hallmarked Man."
}

​
Parametro json flessibile

  • Fornisci un oggetto JSON con valori vuoti come schema, o una stringa che descrive i dati che desideri.
  • Se l’agente non è sicuro, restituisce NOT_FOUND per quel campo.
from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="quanto ha raccolto Olostep?",
    json_format={"amount": ""},
)

print(answer.json_content)
Questo restituirebbe: 
{
  "amount": "NOT_FOUND"
}

​
Prezzi

Le risposte costano 20 crediti per richiesta.