exa-research

Exa リサーチ＆回答 API

クイックリファレンス

トピック	使用する場面	リファレンス
Answer API	引用付きのQ&A、根拠に基づく回答	answer-api.md
Deep Search	スマートなクエリ拡張、高品質な要約	deep-search.md
引用	出典の明示、検証	citations.md

基本パターン

Answer API（Python）

from exa_py import Exa

exa = Exa()

response = exa.answer(
    "What are the key features of Python 3.12?",
    text=True
)

print(response.answer)
for citation in response.citations:
    print(f"Source: {citation.url}")

ストリーミング回答

stream = exa.answer(
    "Explain the benefits of microservices architecture",
    stream=True
)

for chunk in stream:
    print(chunk.text, end="", flush=True)

# Access citations after streaming
print("\nSources:", stream.citations)

要約付きDeep Search

results = exa.search_and_contents(
    "latest developments in quantum computing",
    type="neural",
    num_results=10,
    summary=True,
    use_autoprompt=True  # Smart query expansion
)

for result in results.results:
    print(f"{result.title}")
    print(f"Summary: {result.summary}")

使用する場面

機能	使用例	出力
Answer API	引用が必要な直接的なQ&A	回答＋出典URL
Deep Search	クエリ拡張＋要約	強化された検索結果
Exa Research	非同期の長文レポート	構造化されたJSON/Markdown

よくある間違い

1. 長い回答でストリーミングを使用しない - 複雑な質問でユーザー体験を向上させるには、stream=Trueを使用します
2. 引用を無視する - 検証可能な回答にするため、必ずresponse.citationsを含めます
3. text=Trueを指定し忘れる - Answer APIはコンテンツへのアクセスが必要です。text=Trueを含めます
4. クエリが複雑すぎる - Answer APIは明確で焦点を絞った質問に最適です
5. 引用を検証しない - ユーザーに表示する前に、citation.urlが存在することを確認します