回答 API

Olostepの/v1/answersエンドポイントを通じて、自然言語でウェブを検索し、AIによる回答とデータを希望するJSON形式で返すことができます。これにより、製品を実世界のデータとソースに基づかせたり、データポイントやスプレッドシートを充実させることができます。

質問をしたり、AIに充実させたいデータポイントを与えます
オプション: 戻り値として欲しいJSON構造を指定します

このエンドポイントは次のことを行います:

ウェブ上でデータを検索し、クリーンアップし、検証して返します
回答を生成するために使用されたソースを返します
データが検証できない場合はNOT_FOUND値で不確実性を処理します

APIの詳細については、回答エンドポイントAPIリファレンスを参照してください。デフォルトでは、一般的なウェブインデックスとコスト効率の良いLLMバリデーターを使用しています。エンタープライズ顧客は、業界固有の独自ウェブインデックス、専用のプライベートデータ（電話番号やメールアドレスを含む）、および特定のユースケースに最適なカスタムLLMモデルにアクセスできます。アクセスについてはお問い合わせください: info@olostep.com

ユースケース

この回答エンドポイントは次の用途に使用できます:

AIアプリケーションを実世界のデータと事実に基づかせる
採用、金融、コンサルティング、営業のためにスプレッドシートやデータポイントを充実させる

以下は、回答エンドポイントによって強化されたAI搭載のスプレッドシートのデモです: https://www.olostep.com/demos/spreadsheet-enrich

インストール

pip install olostep

npm install olostep

# curlはmacOS、Linux、Windowsでデフォルトで利用可能です

npm install node-fetch

pip install requests

使用方法

質問をして、出力をガイドするためにJSONスキーマを渡します。jsonパラメータを渡さない場合、APIはresultフィールド内に回答テキストを含むjsonオブジェクトを返します。

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="J.K.ローリングの最新の本は何ですか？",
    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: 'J.K.ローリングの最新の本は何ですか？',
  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": "J.K.ローリングの最新の本は何ですか？",
    "json": {"book_title": "", "author": "", "release_date": ""}
  }'

olostep answer "J.K.ローリングの最新の本は何ですか？" \
  --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: 'J.K.ローリングの最新の本は何ですか？',
    json: { book_title: '', author: '', release_date: '' }
  })
})
console.log(await res.json())

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "J.K.ローリングの最新の本は何ですか？",
  "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))

レスポンス

他のOlostepエンドポイントと同様に、answerオブジェクトがレスポンスとして返されます。answerオブジェクトにはidやresultなどのいくつかのプロパティがあります。

{
  "id": "answer_9bi0sbj9xa",
  "object": "answer",
  "created": 1760327323,
  "metadata": {},
  "task": "J.K.ローリングの最新の本は何ですか？",
  "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/"
    ]
  }
}

jsonパラメータに従ってフォーマットされた要求された回答はresponse.result.json_contentにあり、ソースのリストはresponse.result.sourcesにあります。文字列化されたJSONを解析して構造化データにアクセスできます。

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

ソースの例:

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

jsonパラメータを渡さない場合、APIはresultフィールド内に回答テキストを含むjsonオブジェクトを返します。

{
  "result": "J.K.ローリングの最新の本はThe Hallmarked Manです。"
}

柔軟な`json`パラメータ

空の値を持つJSONオブジェクトをスキーマとして提供するか、欲しいデータを記述する文字列を提供します。
エージェントが自信を持てない場合、そのフィールドにはNOT_FOUNDが返されます。

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="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: 'React 30はいつリリースされますか？',
  jsonFormat: { release_date: '' },
})

console.log(answer.json_content)

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "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 "React 30はいつリリースされますか？" --json-format '{"release_date":""}'

この場合、次のように返されます:

{
  "release_date": "NOT_FOUND"
}

ストレージ

回答のために保存されたファイルはデフォルトで7日間保持されます。POST /v1/answersでstorageオブジェクトを渡すことで、より長く、または無期限に保持できます。この設定は回答結果とそれを構築するために取得されたページをカバーします。

パラメータ	タイプ	デフォルト	説明
`storage.expires_in`	`string`	`7d`	保存されたファイルを保持する期間。`7d`、`10d`、`30d`、`60d`、`90d`、`180d`、`365d`、または`never`（無期限）のいずれか。

storageを省略するか、expires_inなしでstorageを送信すると、7dが使用されます。作成レスポンスとGET /v1/answers/{answer_id}の両方に有効な値が含まれます:

"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": "PostgreSQLの最新の安定版は何ですか？",
    "storage": { "expires_in": "30d" }
  }'

無効な値は400を返します:

{
  "type": "invalid_request_error",
  "message": "Invalid storage.expires_in. Allowed values: \"7d\", \"10d\", \"30d\", \"60d\", \"90d\", \"180d\", \"365d\", \"never\".",
  "code": "invalid_storage_expires_in"
}

価格

回答は1リクエストあたり20クレジットのコストがかかります。

開始する

機能

残高と請求書

ユースケース

インストール

使用方法

レスポンス

柔軟な`json`パラメータ

ストレージ

価格

​ユースケース

​インストール

​使用方法

​レスポンス

​柔軟なjsonパラメータ

​ストレージ

​価格

ユースケース

インストール

使用方法

レスポンス

柔軟な`json`パラメータ

ストレージ

価格