AstroSage API：构建类似 AstroSage 的占星聊天应用或机器人

{
  "intent": "current_dasha_question",
  "needs_tool": true,
  "tool": "vedic_dasha",
  "cache_key": "user_123:vedic_dasha:2026-04-24:lahiri",
  "reason": "The user asked which dasha is active today."
}

User question:
{question}

Tool JSON:
{cached_or_fresh_json}

Instruction:
Answer only from the Tool JSON. If the JSON does not contain the requested fact, say what additional tool or birth detail is needed.

curl -G "https://api.freeastroapi.com/api/v2/geo/search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=Mumbai" \
  --data-urlencode "country=IN" \
  --data-urlencode "limit=5"

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/calculate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "year": 1994,
    "month": 8,
    "day": 11,
    "hour": 6,
    "minute": 42,
    "city": "Mumbai",
    "lat": 19.0760,
    "lng": 72.8777,
    "tz_str": "AUTO",
    "ayanamsha": "lahiri",
    "vargas": [1, 9, 10],
    "include_yogas": true,
    "include_panchang": true,
    "include_shadbala": true,
    "include_ashtakavarga": true,
    "dasha_levels": 3
  }'

You are an astrology assistant for a Vedic astrology app.
Use only the structured API facts below.
Do not invent planetary positions, dashas, Nakshatras, yogas, or compatibility scores.
If the needed fact is missing, ask for the missing input or say that this endpoint was not called.

User question:
{user_message}

FreeAstroAPI facts:
{json_from_relevant_endpoint}

You are currently in Moon Mahadasha and Saturn Antardasha.
The API dasha payload shows Moon as the active Mahadasha lord and Saturn as the active sub-period lord for the selected reference date.
This usually focuses the reading on emotional security, home, responsibility, and long-term discipline.
If you want, I can compare this dasha with your current Gochar timeline.

User interface
  -> Your backend chat route
  -> Intent classifier
  -> FreeAstroAPI endpoint call
  -> Structured payload store
  -> LLM response generation
  -> Chat answer with endpoint-backed facts

const API_BASE = "https://api.freeastroapi.com";

async function getVedicProfile(birthData: Record<string, unknown>) {
  const response = await fetch(`${API_BASE}/api/v2/vedic/calculate`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.FREEASTROAPI_KEY || "",
    },
    body: JSON.stringify({
      ...birthData,
      tz_str: "AUTO",
      ayanamsha: "lahiri",
      vargas: [1, 9, 10],
      include_yogas: true,
      include_panchang: true,
      include_shadbala: true,
      include_ashtakavarga: true,
      dasha_levels: 3,
    }),
  });

  if (!response.ok) {
    throw new Error(`FreeAstroAPI request failed: ${response.status}`);
  }

  return response.json();
}