# AI-ügynökök és MCP Építesz egy AI-ágenszt, amely valódi asztrológiai számításokat végez ahelyett, hogy hallucinálna? Az **AstroWay** csatlakozik a **Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral** modellekhez — MCP-n, `llms.txt`-en vagy közvetlen HTTP-hívásokon keresztül. Három integrációs módszer közül választhatsz az ágens típusától függően: - **`llms.txt`** — discovery-fájlok olyan ágensek számára, amelyek olvasni tudják a dokumentációt (Cursor IDE, Windsurf, a böngészőben futó Claude, egyéni RAG-csövek LangChain/LlamaIndex használatával). - **MCP-szerver** — zero-code megoldás a Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) és bármely MCP-kompatibilis kliens (beleértve a GPT-t is az OpenAI Realtime API-n keresztül). - **HTTP API** — közvetlen hívás saját ágensből vagy keretrendszerből (LangChain, LlamaIndex, AutoGen, CrewAI). ## `llms.txt` — discovery AI-ágensek számára Az oldal két gépi olvasható fájlt szolgáltat [llms.txt](https://llmstxt.org/) formátumban: - **[`/llms.txt`](https://api.astroway.info/llms.txt)** — a dokumentáció összes oldalának indexe, csoportosítva szekciók szerint (API Reference, Use Cases, Examples, Products). Kicsi, belefér bármelyik context window-ba. - **[`/llms-full.txt`](https://api.astroway.info/llms-full.txt)** — az összes dokumentáció egyetlen plain-text fájlban. Offline vektoradatbázis indexeléséhez vagy egyszeri context-be töltéshez alkalmas. ### Mikor használd | Forgatókönyv | Fájl | |---|---| | Cursor/Windsurf „olvasd el az AstroWay docs-ot és segíts az integrációban” | `/llms.txt` (az ágens magától behozza a szükséges részeket) | | Saját RAG-cső / vektoradatbázis FAQ-bot számára | `/llms-full.txt` (egy fetch — az egész corpus) | | Böngészőben futó Claude/ChatGPT: „itt van az API-nk, építs egy klienst” | `/llms-full.txt` beillesztése a promptba | | Termelési ágens, amely tényleges hívásokat hajt végre | MCP-szerver vagy HTTP API (lásd lent) | ### Példa: pull a saját ágensedbe ```ts const docs = await fetch('https://api.astroway.info/llms-full.txt').then(r => r.text()); const systemPrompt = `You are an integration assistant for AstroWay API. Documentation: ${docs} When the user asks how to do X, return a working code snippet using their API key.`; ``` ## MCP-szerver (ajánlott a Claude Desktop számára) A Model Context Protocol (MCP) nyílt szabvány eszközök csatlakoztatására AI-modellekhez. Az AstroWay MCP-szerver 25 eszközt biztosít számításokhoz és interpretációkhoz. ### Beállítás a Claude Desktop számára Add hozzá a `claude_desktop_config.json` fájlhoz: ```json { "mcpServers": { "astroway": { "command": "npx", "args": ["@astroway/mcp"], "env": { "ASTROWAY_API_KEY": "aw_live_your_key_here" } } } } ``` A Claude Desktop újraindítása után 25 asztrológiai eszközt fog látni. ### Mit tud az MCP-szerver | Eszköz | Mit csinál | |---|---| | `natal_chart` | Natális térkép számítása | | `synastry` | Szinasztría két ember között | | `daily_horoscope` | Napi horoszkóp | | `interpret_natal` | Natális térkép AI-értelmezése | | `human_design` | Teljes HD-térkép | | `transits` | Aktuális tranzitok | A teljes lista 25 eszközt tartalmaz, amelyek lefedik a főbb számításokat és AI-értelmezéseket. ### Példa párbeszéd a Claude-dal > **Felhasználó:** Készíts egy natális térképet annak a személynek, aki 1990. július 14-én született 14:30-kor Kijevben. Mit jelent a Nap Rákban a 10. házban? > > **Claude:** *Használja a `natal_chart` eszközt a számításhoz, majd az `interpret_placement`-et az értelmezéshez. Visszaadja a bolygók valós adatait és egy értelmes interpretációt.* ## HTTP API AI-ágensek számára, amelyek nem támogatják az MCP-t — használd közvetlenül az HTTP API-t. ### Tartalomgeneráláshoz ```ts // Az AI-ágens meghívja a /interpret/natal endpointot natális interpretációhoz const r = await fetch('https://api.astroway.info/v1/interpret/natal', { method: 'POST', headers: { 'X-Api-Key': process.env.ASTROWAY_API_KEY!, 'Content-Type': 'application/json', }, body: JSON.stringify({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, }), }); const result = await r.json(); // result.text — kész AI-értelmezés // result.disclaimer — megjelenítendő disclaimer ``` ```python r = requests.post( 'https://api.astroway.info/v1/interpret/natal', headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']}, json={ 'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.4501, 'longitude': 30.5234, }, ) result = r.json() # result['text'] — kész AI-értelmezés # result['disclaimer'] — megjelenítendő disclaimer ``` ```bash frame="terminal" curl -X POST https://api.astroway.info/v1/interpret/natal \ -H "X-Api-Key: $ASTROWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "date": "1990-07-14", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.4501, "longitude": 30.5234 }' ``` ```php 'https://api.astroway.info/v1/']); $r = $aw->post('interpret/natal', [ 'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')], 'json' => [ 'date' => '1990-07-14', 'time' => '14:30:00', 'timezoneOffset' => 3, 'latitude' => 50.4501, 'longitude' => 30.5234, ], ]); $result = json_decode($r->getBody(), true); // $result['text'] — kész AI-értelmezés // $result['disclaimer'] — megjelenítendő disclaimer ``` ### Számításokhoz + saját LLM ```ts // 1. Szerezd be a nyers adatokat a /chart endpointon keresztül (olcsóbb — 20 credit) const chart = await fetch('https://api.astroway.info/v1/chart', { ... }); const data = await chart.json(); // 2. Add át az adatokat a saját LLM-ednek const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`; const llmResponse = await myLLM.generate(prompt); ``` ## Forgatókönyvek ### Személyes asztrológiai asszisztens MCP-szerver + Claude/ChatGPT. A felhasználó kérdez — az ágens számol és értelmez. Költség: Free tarif személyes használatra. ### Tartalomalkotó bot közösségi média számára Napi horoszkópok generálása 12 csillagjegy számára a `/horoscope/daily` endpointon keresztül. 12 kérés naponta = 240 credit. A Free tarif nagy tartalékkal rendelkezik. ### AI-coaching platform `/interpret/natal` + `/interpret/transits` minden ügyfél számára. 100 ügyfél/nap = 10 000 credit/nap. Pro tarif.