Quickstarts
LangChain quickstart
Wrap AeroSearch retrieve as a LangChain tool and get a 200 with citations.
Goal: call POST /v1/collections/{collection}/retrieve from a LangChain tool
shape and receive HTTP 200 with cited Chunks in under five minutes.
Set AEROSEARCH_BASE_URL to your Cell search host (without a route),
AEROSEARCH_API_KEY to a Project search key, and AEROSEARCH_COLLECTION to its Collection id.
Set AEROSEARCH_END_USER_TOKEN only when your server supplies a real end-user token.
Sample
# generated-from-contract: contracts/openapi/v1.yaml
# LangChain retriever tool shape — retrieve via searchCollectionPost adjacent path
# POST /v1/collections/col_help/retrieve (operationId retrieveCollection in OpenAPI)
import os
import json
import urllib.request
BASE = os.environ.get("AEROSEARCH_BASE_URL", "https://api.aerosearch.team").rstrip("/").removesuffix("/v1")
COLLECTION = os.environ.get("AEROSEARCH_COLLECTION", "col_help")
API_KEY = os.environ.get("AEROSEARCH_API_KEY", "ask_YOUR_PROJECT_SEARCH_KEY")
def aerosearch_retrieve(query: str) -> dict:
"""Callable a LangChain Tool would wrap."""
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
end_user_token = os.environ.get("AEROSEARCH_END_USER_TOKEN")
if end_user_token:
headers["X-AeroSearch-End-User-Token"] = end_user_token
req = urllib.request.Request(
f"{BASE}/v1/collections/{COLLECTION}/retrieve",
data=json.dumps({"query": query}).encode(),
method="POST",
headers=headers,
)
with urllib.request.urlopen(req) as res:
assert res.status == 200
return json.loads(res.read().decode())
# Usage:
print(json.dumps(aerosearch_retrieve("How do I rotate a key?")))
# from langchain_core.tools import tool
# @tool
# def search_company_knowledge(query: str) -> str:
# return json.dumps(aerosearch_retrieve(query))
Verify
From this repository, the local double verification executes the generated sample:
AEROSEARCH_BASE_URL=http://127.0.0.1:4418 AEROSEARCH_API_KEY=ask_search AEROSEARCH_COLLECTION=col_quickstart \
node tests/harness/quickstarts-daily/run.mjs langchain