API Risposte

Attraverso l’endpoint Olostep /v1/answers puoi cercare sul web con linguaggio naturale e restituire 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 indietro

Farà:

Cercare, pulire, validare e restituire i dati trovati sul Web
Restituire le fonti utilizzate per generare la risposta
Gestire l’incertezza con valori NOT_FOUND quando i dati non possono essere verificati

Per i dettagli dell’API, vedi la Documentazione dell’Endpoint Risposte. Di default utilizziamo un indice web generico e un validatore LLM a basso costo. I clienti aziendali hanno accesso a indici web proprietari specifici per l’industria, 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 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 alimentato dall’endpoint Risposte: https://www.olostep.com/demos/spreadsheet-enrich

Installazione

pip install olostep

npm install olostep

# curl è disponibile di default su macOS, Linux e Windows

npm install node-fetch

pip install requests

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)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

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

console.log(answer.json_content)
console.log(answer.sources)

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Qual è l'ultimo libro di J.K. Rowling?",
    "json": {"book_title": "", "author": "", "release_date": ""}
  }'

olostep answer "Qual è l'ultimo libro di J.K. Rowling?" \
  --json-format '{"book_title":"","author":"","release_date":""}'

const res = await fetch('https://api.olostep.com/v1/answers', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer <YOUR_API_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    task: 'Qual è l'ultimo libro di J.K. Rowling?',
    json: { book_title: '', author: '', release_date: '' }
  })
})
console.log(await res.json())

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Qual è l'ultimo libro di J.K. Rowling?",
  "json": {"book_title": "", "author": "", "release_date": ""}
}
headers = {"Authorization": "Bearer <YOUR_API_KEY>", "Content-Type": "application/json"}

response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

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 serializzato 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="Quando verrà rilasciato React 30?",
    json_format={"release_date": ""},
)

print(answer.json_content)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

const answer = await client.answers.create({
  task: 'Quando verrà rilasciato React 30?',
  jsonFormat: { release_date: '' },
})

console.log(answer.json_content)

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Quando verrà rilasciato React 30?", 
  "json": {
    "release_date": ""
  }
}
headers = {
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "application/json"
}
response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

olostep answer "Quando verrà rilasciato React 30?" --json-format '{"release_date":""}'

Questo restituirebbe:

{
  "release_date": "NOT_FOUND"
}

Archiviazione

I file archiviati per una risposta vengono conservati per 7 giorni di default. Passa un oggetto storage su POST /v1/answers per conservarli più a lungo o indefinitamente. L’impostazione copre il risultato della risposta e le pagine recuperate per costruirla.

Parametro	Tipo	Default	Descrizione
`storage.expires_in`	`string`	`7d`	Quanto tempo conservare i file archiviati. Uno tra `7d`, `10d`, `30d`, `60d`, `90d`, `180d`, `365d`, o `never` (indefinito).

Omettendo storage, o inviando storage senza expires_in, si utilizza 7d. Sia la risposta di creazione che GET /v1/answers/{answer_id} includono il valore in vigore:

"storage": { "expires_in": "30d" }

cURL

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Qual è l'ultima versione stabile di PostgreSQL?",
    "storage": { "expires_in": "30d" }
  }'

Un valore non valido restituisce 400:

{
  "type": "invalid_request_error",
  "message": "Valore non valido per storage.expires_in. Valori consentiti: \"7d\", \"10d\", \"30d\", \"60d\", \"90d\", \"180d\", \"365d\", \"never\".",
  "code": "invalid_storage_expires_in"
}

Prezzi

Le risposte costano 20 crediti per richiesta.

Inizia

Funzionalità

Saldo e Fatturazione

Casi d’uso

Installazione

Utilizzo

Risposta

Parametro `json` flessibile

Archiviazione

Prezzi

​Casi d’uso

​Installazione

​Utilizzo

​Risposta

​Parametro json flessibile

​Archiviazione

​Prezzi

Casi d’uso

Installazione

Utilizzo

Risposta

Parametro `json` flessibile

Archiviazione

Prezzi