Antworten-API

Über den Olostep-Endpunkt /v1/answers kannst du das Web mit natürlicher Sprache durchsuchen und KI-gestützte Antworten und Daten in der gewünschten JSON-Form zurückerhalten. Dies ermöglicht es dir, deine Produkte auf reale Daten und Quellen zu stützen, Datenpunkte oder Tabellen zu bereichern.

Stelle eine Frage oder gib der KI einen Datenpunkt, den du anreichern möchtest
Optional: Gib die JSON-Struktur an, die du zurückhaben möchtest

Es wird:

Die Daten im Web suchen, bereinigen, validieren und zurückgeben
Die Quellen zurückgeben, die zur Generierung der Antwort verwendet wurden
Unsicherheiten mit NOT_FOUND-Werten handhaben, wenn Daten nicht verifiziert werden können

Für API-Details siehe die Antworten-Endpunkt-API-Referenz. Standardmäßig verwenden wir einen generischen Webindex und einen kosteneffizienten LLM-Validator. Unternehmenskunden haben Zugang zu proprietären branchenspezifischen Webindizes, exklusiven privaten Daten (einschließlich Telefonnummern und E-Mails) und benutzerdefinierten LLM-Modellen, die am besten für ihren Anwendungsfall geeignet sind. Kontaktiere uns für den Zugang: info@olostep.com

Anwendungsfälle

Der Antworten-Endpunkt kann verwendet werden, um:

KI-Anwendungen auf reale Daten und Fakten zu stützen
Tabellen und Datenpunkte für Recruiting, Finanzen, Beratung und Vertrieb zu bereichern

Hier ist eine Demo einer KI-gestützten Tabelle, die vom Antworten-Endpunkt unterstützt wird: https://www.olostep.com/demos/spreadsheet-enrich

Installation

pip install olostep

npm install olostep

# curl ist standardmäßig auf macOS, Linux und Windows verfügbar

npm install node-fetch

pip install requests

Verwendung

Stelle eine Frage und übergebe ein JSON-Schema, um die Ausgabe zu leiten. Du kannst auch den json-Parameter nicht übergeben, und die API wird ein JSON-Objekt mit dem Antworttext im result-Feld zurückgeben.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Was ist das neueste Buch von 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: 'Was ist das neueste Buch von 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": "Was ist das neueste Buch von J.K. Rowling?",
    "json": {"book_title": "", "author": "", "release_date": ""}
  }'

olostep answer "Was ist das neueste Buch von 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: 'Was ist das neueste Buch von 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": "Was ist das neueste Buch von 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))

Antwort

Wie bei anderen Olostep-Endpunkten erhältst du ein answer-Objekt als Antwort. Das answer-Objekt hat einige Eigenschaften wie id und result.

{
  "id": "answer_9bi0sbj9xa",
  "object": "answer",
  "created": 1760327323,
  "metadata": {},
  "task": "Was ist das neueste Buch von J.K. Rowling?",
  "result": {
    "json_content": "{\"book_title\":\"The Hallmarked Man\",\"author\":\"J.K. Rowling (als 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/"
    ]
  }
}

Deine angeforderte Antwort, formatiert gemäß dem json-Parameter, befindet sich in response.result.json_content und die Liste der Quellen in response.result.sources. Du kannst das String-JSON parsen, um auf die strukturierten Daten zuzugreifen.

{
  "book_title": "The Hallmarked Man",
  "author": "J.K. Rowling",
  "release_date": "2. September 2025"
}

Beispielquellen:

[
    "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/"
]

Wenn du den json-Parameter nicht übergibst, wird die API ein JSON-Objekt mit dem Antworttext im result-Feld zurückgeben.

{
  "result": "Das neueste Buch von J.K. Rowling ist The Hallmarked Man."
}

Flexibler `json`-Parameter

Gib ein JSON-Objekt mit leeren Werten als Schema an oder eine Zeichenkette, die die gewünschten Daten beschreibt.
Wenn der Agent sich nicht sicher ist, gibt er NOT_FOUND für dieses Feld zurück.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Wann wird React 30 veröffentlicht?",
    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: 'Wann wird React 30 veröffentlicht?',
  jsonFormat: { release_date: '' },
})

console.log(answer.json_content)

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Wann wird React 30 veröffentlicht?", 
  "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 "Wann wird React 30 veröffentlicht?" --json-format '{"release_date":""}'

Dies würde zurückgeben:

{
  "release_date": "NOT_FOUND"
}

Speicherung

Gespeicherte Dateien für eine Antwort werden standardmäßig 7 Tage lang aufbewahrt. Übergebe ein storage-Objekt bei POST /v1/answers, um sie länger oder unbegrenzt aufzubewahren. Die Einstellung deckt das Antwortergebnis und die Seiten ab, die zur Erstellung abgerufen wurden.

Parameter	Typ	Standard	Beschreibung
`storage.expires_in`	`string`	`7d`	Wie lange die gespeicherten Dateien aufbewahrt werden sollen. Eine von `7d`, `10d`, `30d`, `60d`, `90d`, `180d`, `365d` oder `never` (unbegrenzt).

Das Weglassen von storage oder das Senden von storage ohne expires_in verwendet 7d. Sowohl die Erstellungsantwort als auch GET /v1/answers/{answer_id} enthalten den aktuellen Wert:

"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": "Was ist die neueste stabile Version von PostgreSQL?",
    "storage": { "expires_in": "30d" }
  }'

Ein ungültiger Wert gibt 400 zurück:

{
  "type": "invalid_request_error",
  "message": "Ungültiges storage.expires_in. Erlaubte Werte: \"7d\", \"10d\", \"30d\", \"60d\", \"90d\", \"180d\", \"365d\", \"never\".",
  "code": "invalid_storage_expires_in"
}

Preisgestaltung

Antworten kosten 20 Credits pro Anfrage.

Loslegen

Funktionen

Kontostand & Abrechnung

Anwendungsfälle

Installation

Verwendung

Antwort

Flexibler `json`-Parameter

Speicherung

Preisgestaltung

​Anwendungsfälle

​Installation

​Verwendung

​Antwort

​Flexibler json-Parameter

​Speicherung

​Preisgestaltung

Anwendungsfälle

Installation

Verwendung

Antwort

Flexibler `json`-Parameter

Speicherung

Preisgestaltung