FXMacroData के साथ मिथुन अनुप्रयोग बनाएंः REST, MCP और A2A

गूगल का मिथुन फ़ंक्शन कॉल मॉडल अनुरोध उपकरण देता है, जो मिथुन को मैक्रो अनुप्रयोगों के लिए उपयोगी बनाता है जिन्हें सामान्य बाजार टिप्पणी के बजाय वर्तमान डेटा की आवश्यकता होती है। इस गाइड के अंत तक, आपके पास एक मिथुन ऐप बनाने के लिए एक व्यावहारिक खाका होगा जो रिलीज़ कैलेंडर, संकेतक इतिहास, एफएक्स स्पॉट संदर्भ, सीओटी पोजिशनिंग, कमोडिटी और सत्र की स्थिति के लिए प्रतिक्रिया देने से पहले एफएक्समैक्रोडाटा को कॉल करता है।

पूर्व शर्तें

• गूगल एआई स्टूडियो या वर्टेक्स एआई जेमिनी एपीआई कुंजी।
• संरक्षित अंत बिंदु परिवारों के लिए एक FXMacroData एपीआई कुंजी.
• एक बैकएंड रनटाइम जहां रहस्य सुरक्षित रूप से संग्रहीत किया जा सकता है.
• नीचे दिए गए उदाहरणों के लिए पायथन 3.11 या नया।
• एक विशिष्ट उपयोगकर्ता कार्यप्रवाह, जैसे "अगली USD घटना जोखिम पर मुझे जानकारी दें" या "EUR/USD मैक्रो संदर्भ को सारांशित करें।"

यह लेख मिथुन एपीआई फ़ंक्शन कॉल पर केंद्रित है, सेवानिवृत्त नहीं Google वार्तालाप क्रियाओं पर क्रियाएँ सतह. यदि आप बाद में एक आवाज अनुप्रयोग चाहते हैं, तो इसका मतलब है कि एक वास्तविक एंड्रॉइड ऐप बनाना और फिर ऐप क्रियाओं या ऐप कार्यों का मूल्यांकन करना। आज वेब, बैकएंड या विश्लेषक सहायक के लिए, मिथुन फ़ंक्शन कॉलिंग प्रत्यक्ष मार्ग है।

1. सही Google सतह चुनें

गूगल के पास कई समान नाम वाले सतह हैं। वे विनिमेय नहीं हैं। FXMacroData के लिए, उपयोगी विभाजन इस तरह दिखता हैः

इस गाइड के बाकी के जेमिनी एपीआई का उपयोग करता है. आप अभी भी उसी डेटा को उजागर कर सकते हैं के माध्यम से FXMacroData MCP MCP-अभिज्ञ ग्राहकों के लिए, लेकिन एक मिथुन एपीआई अनुप्रयोग आमतौर पर स्पष्ट कार्य घोषणाओं और अपने स्वयं के बैकएंड में एक डिस्पेंसर की आवश्यकता होती है।

2. वास्तुकला का स्केच

एक मिथुन एप्लिकेशन को मैक्रो मानों को याद रखने के लिए मॉडल से नहीं पूछना चाहिए. एप्लिकेशन को मिथुन को यह तय करने देना चाहिए कि कौन सा डेटा फ़ंक्शन कॉल करना है, फिर उस फ़ंक्शंस कॉल को FXMacroData पर रूट करें.

यह विभाजन जिम्मेदारियों को स्पष्ट रखता है. मिथुन व्याख्या संभालता है. FXMacroData संरचित मैक्रो और FX डेटा प्रदान करता है. आपका बैकएंड क्रेडेंशियल्स, लॉगिंग और उत्पाद गार्डरील को संभालती है.

3. एक उपयोगकर्ता नौकरी से शुरू करें

हर अंत बिंदु के साथ शुरू नहीं करते. एक व्यापारियों या विश्लेषकों वास्तव में उपयोग करेंगे एक कार्यप्रवाह के साथ प्रारंभ करेंः

Help a user understand the next major USD release, recent inflation context,
and whether EUR/USD has relevant spot-market context.

उस कार्यप्रवाह को केवल कुछ FXMacroData क्षमताओं की आवश्यकता होती हैः

• रिलीज कैलेंडर आगामी घटनाओं के लिए।
• अमरीकी डालर में मुद्रास्फीति हाल के मैक्रो संदर्भ के लिए इतिहास।
• EUR/USD जोड़ी संदर्भ के लिए स्पॉट इतिहास.
• वैकल्पिक USD COT स्थिति जब संकेत भीड़ के बारे में पूछता है.

4. डेटा कॉल के लिए जुड़वां कार्यों को परिभाषित करें

मिथुन फ़ंक्शन कॉल तब सबसे अच्छा काम करता है जब फ़ंक्शंस संकीर्ण, स्पष्ट रूप से नामित और मॉडल के लिए चुनना आसान हो। यहाँ रिलीज़-कैलेंडर कॉल के लिए एक कॉम्पैक्ट घोषणा हैः

{
  "name": "fxmacro_calendar",
  "description": "Fetch the FXMacroData macro release calendar for a currency.",
  "parameters": {
    "type": "object",
    "properties": {
      "currency": {
        "type": "string",
        "description": "Currency code such as usd, eur, gbp, jpy, aud, cad."
      }
    },
    "required": ["currency"]
  }
}

एक बड़े कैटलॉग के बजाय एक छोटा प्रारंभिक सेट जोड़ें। एक मजबूत पहले संस्करण को आमतौर पर इन कार्यों की आवश्यकता होती हैः

आप बाद में कमोडिटी, दर अंतर, वक्र, समाचार, केंद्रीय बैंक की प्रेस विज्ञप्ति और भविष्यवाणियों के लिए विस्तार कर सकते हैं। पहला संस्करण पर्याप्त छोटा होना चाहिए ताकि उपकरण का चयन अनुमानित हो।

5. डिस्पेंचर सर्वर पक्ष रखें

आपका डिस्पैचर वह भाग है जो जेमिनी के फ़ंक्शन नाम और तर्क को FXMacroData REST कॉल में मैप करता है. इस कोड को एक बैकएंड में रखें, सार्वजनिक ब्राउज़र जावास्क्रिप्ट में नहीं.

import os
import requests

API_BASE = "https://fxmacrodata.com/api/v1"

def call_fxmacrodata(name, args):
    if name == "fxmacro_calendar":
        path = f"/calendar/{args['currency'].lower()}"
        params = {}
    elif name == "fxmacro_forex":
        path = f"/forex/{args['base'].lower()}/{args['quote'].lower()}"
        params = {k: args[k] for k in ("start_date", "end_date") if k in args}
    else:
        raise ValueError(f"Unsupported function: {name}")

    api_key = os.environ.get("FXMACRODATA_API_KEY")
    if api_key:
        params["api_key"] = api_key
    response = requests.get(f"{API_BASE}{path}", params=params, timeout=30)
    response.raise_for_status()
    return response.json()

महत्वपूर्ण विवरण क्रेडेंशियल हैंडलिंग है। सार्वजनिक उदाहरणों में क्वेरी-पैरामीटर पैटर्न दिखाना चाहिए, लेकिन एक उत्पादन मिथुन ऐप को गुप्त प्रबंधक या पर्यावरण चर से कुंजी पढ़नी चाहिए और इसे कभी भी प्रॉम्प्ट में नहीं डालना चाहिए।

6. मिथुन को उपकरण मांगने दें, फिर परिणाम वापस फ़ीड करें

सटीक मिथुन एसडीके कोड परियोजना के अनुसार भिन्न होगा, लेकिन लूप का एक ही आकार हैः

from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

tools = [types.Tool(function_declarations=[calendar_declaration])]
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Show the next USD releases and explain the EUR/USD risk.",
    config=types.GenerateContentConfig(tools=tools),
)

for part in response.candidates[0].content.parts:
    if part.function_call:
        result = call_fxmacrodata(part.function_call.name, dict(part.function_call.args))
        # Send result back as a function response, then ask Gemini to finalize.

उत्पादन में, आप इसे एक लूप में लपेटेंगेः मॉडल प्रतिक्रिया प्राप्त करें, किसी भी फ़ंक्शन कॉल निष्पादित करें, फ़ंక్షన్ प्रतिक्रियाओं को जोड़ें, और अंतिम उत्तर के लिए मिथुन से पूछें। मॉडल को प्रासंगिक FXMacroData टूल का प्रयास करने तक लाइव मैक्रो प्रश्नों का उत्तर नहीं देना चाहिए।

7. एक प्रणाली निर्देश जोड़ें जो उत्तरों को जमीनी बनाती है

सिस्टम निर्देश में डेटा पदानुक्रम स्पष्ट होना चाहिए:

You are a macro research assistant. Use FXMacroData tools before answering
questions about live, recent, historical, calendar, FX, COT, commodity,
or structured macro data. If FXMacroData returns no data, say that clearly.
Do not invent values or timestamps. Keep financial wording informational
and avoid investment advice.

यह निर्देश बनाए रखने के लिए पर्याप्त संक्षिप्त है और सबसे आम विफलता मोड को रोकने के लिए काफी विशिष्ट हैः एक मॉडल डेटा की जांच के बिना एक विश्वसनीय मैक्रो सारांश लिख रहा है।

8. मिथुन के बगल में REST और MCP पथ जोड़ें

एक अच्छा मिथुन एप्लिकेशन को हर नौकरी के लिए एक ही एकीकरण सतह का उपयोग करने की आवश्यकता नहीं है। डायरेक्ट REST अभी भी निर्धारक खींच के लिए बेहतर हैः

curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation?api_key=YOUR_API_KEY"

MCP बेहतर है जब होस्ट पहले से ही MCP खोज का समर्थन करता है. उदाहरण के लिए, एक संगत स्थानीय क्लाइंट इस पर इंगित कर सकता हैः

{
  "servers": {
    "FXMacroData": {
      "type": "http",
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

ए 2 ए एक अलग परत है। एमसीपी एक एजेंट या मॉडल होस्ट को टूल और डेटा संसाधनों से जोड़ता है। ए 2ए स्वतंत्र एजेंटों को एक दूसरे से जोड़ती है, आमतौर पर जब एक एजंट को किसी अन्य एजेंट सेवा को खोज, संदेश या कार्य सौंपने की आवश्यकता होती है। एफएक्समैक्रोडाटा पहले डेटा / टूल परत में आता है; एक ए 2 एम रैपर केवल तभी उपयोगी हो जाता है जब आप बाद में अन्य एजंटों को कॉल करने के लिए एक समर्पित एफएक्समेक्रोडाट अनुसंधान एजेंट को उजागर करते हैं।

जब आप स्वयं मिथुन एप्लिकेशन बना रहे हों तो मिथुन फ़ंक्शन कॉल का उपयोग करें। जब होस्ट पहले से ही जानता है कि दूरस्थ एमसीपी सर्वर से कैसे कनेक्ट करें तो एमसीईपी का उपयोग करना। जब आपका एप्लिकेशंस वास्तव में जानता है तो आरईएसटी का उपयोग किया जाए कि कौन सा एंडपॉइंट कॉल करना है। ए 2 ए का उपयोग केवल तभी करें जब एकीकरण सीमा एजेंट-टू-एजेंट हो, न कि ऐप-टू डेटा।

9. एक व्यावहारिक पहली स्क्रीन बनाएं

सबसे तेज़ उपयोगी उत्पाद एक खाली चैट बॉक्स नहीं है. पहली स्क्रीन को एक केंद्रित ब्रीफिंग वर्कफ़्लो बनाएंः

यह मिथुन को एक सीमित कार्य देता है और उपयोगकर्ता को एक ऑडिटेबल उत्तर देता है। यह एक साफ उन्नयन पथ भी बनाता हैः जोड़ें वस्तुएं वस्तु मुद्राओं के लिए, जोड़ें विदेशी मुद्रा सत्र समय संदर्भ के लिए, नीति व्याख्या के लिए केंद्रीय बैंक की प्रेस विज्ञप्ति जोड़ें।

10. उत्पादन की जाँच सूची

• स्टोर GEMINI_API_KEY और FXMACRODATA_API_KEY केवल सर्वर-साइड।
• कच्चे कुंजी लॉगिंग के बिना उपकरण नाम, तर्क और प्रतिक्रिया स्थिति लॉग करें.
• मिथुन को अंतराल भरने के बजाय "डेटा अनुपलब्ध" लौटाएं।
• उपयोगकर्ताओं को दिखाएँ कि FXMacroData कॉल ने उत्तर का समर्थन किया.
• व्यापारिक सलाह से मैक्रो संदर्भ को अलग करें।
• जहां उपयुक्त हो, कैश स्थिर कॉल करें।
• उत्पादन URL पर सार्वजनिक उदाहरण रखें.

सामान्य प्रश्न

क्या मिथुन FXMacroData का उपयोग कर सकते हैं?

जी हाँ. एक मिथुन एप्लिकेशन FXMacroData REST एंडपॉइंट्स को फ़ंक्शन घोषणाओं के रूप में उजागर कर सकता है, उन फ़ंक्शंस को सर्वर-साइड डिस्पैचर से कॉल कर सकता हैं, और लौटे मैक्रो डेटा को मिथुन को एक ग्राउंड उत्तर के लिए वापस खिला सकता है.

FXMacroData के साथ एक मिथुन एप्लिकेशन बनाने का सबसे तेज़ तरीका क्या है?

जेमिनी फ़ंक्शन का एक छोटा सेट घोषित करें, उन्हें बैकएंड डिस्पैचर के माध्यम से निष्पादित करें, सर्वर-साइड क्रेडेंशियल्स के साथ FXMacroData REST एंडपॉइंट्स को कॉल करें, और अंतिम उत्तर लिखने से पहले मैक्रो डेटा जेमनी को वापस करें.

क्या यह एक एमसीपी एकीकरण के समान है?

नहीं. MCP सबसे अच्छा है जब होस्ट पहले से ही दूरस्थ MCP सर्वर का समर्थन करता है. जब आप स्वयं एक मिथुन ऐप बना रहे हों और स्पष्ट फ़ंक्शन घोषणाओं के साथ-साथ एक डिस्पैचर की आवश्यकता हो तो मिथुन फ़ंक्शंस कॉलिंग उपयोगी है.

यह A2A से कैसे अलग है?

A2A स्वतंत्र एजेंट सेवाओं के बीच संचार के लिए है। FXMacroData पर एक मिथुन ऐप आमतौर पर REST, MCP, या मिथुन फ़ंक्शन कॉल के माध्यम से ऐप-टू-डेटा एक्सेस के रूप में शुरू होता है, न कि एजेंट-टू एजेंट प्रतिनिधि के रूप मे।

क्या आपको इसके लिए एंड्रॉयड ऐप की ज़रूरत है?

नहीं. आप Android के बिना एक उपयोगी मिथुन एपीआई एप्लिकेशन बना सकते हैं. यदि FXMacroData एक वास्तविक Android ऐप भेजता है तो Android ऐप क्रियाएँ या ऐप फ़ंक्शन बाद में प्रासंगिक हो जाते हैं.

स्रोत और कार्यान्वयन संदर्भ

इस गाइड में कार्यान्वयन पैटर्न सार्वजनिक मिथुन, FXMacroData, और एजेंट प्रोटोकॉल दस्तावेज नीचे आधारित हैः

• जेमिनी एपीआई फ़ंक्शन कॉल प्रलेखन उपकरण घोषणाओं और कार्य प्रतिक्रियाओं के लिए।
• Google वार्तालाप क्रियाओं पर कार्रवाई सूर्यास्त सूचना क्यों पुराने गूगल क्रिया पथ सही लक्ष्य नहीं है के लिए.
• एजेंट2एजेंट प्रोटोकॉल दस्तावेज REST/MCP/Gemini/A2A तुलना में वर्णित एजेंट-एजेंट सीमा के लिए।
• FXMacroData REST एपीआई प्रलेखन एंडपॉइंट ऑथेंटिकेशन और उत्पादन एपीआई पथ के लिए।
• FXMacroData MCP सर्वर प्रलेखन एमसीपी-सक्षम क्लाइंट और दूरस्थ उपकरण खोज के लिए।

संबंधित FXMacroData गाइड

यह लेख FXMacroData AI एकीकरण समूह का हिस्सा है. जब आपको एक अलग होस्ट, प्रोटोकॉल या कार्यान्वयन पथ की आवश्यकता हो तो इन साथी गाइडों का उपयोग करें:

• FXMacroData के लिए एक MCP क्लाइंट बनाएँ जब आपका होस्ट दूरस्थ MCP उपकरण का समर्थन करता है.
• FXMacroData MCP सर्वर प्रलेखन कैनोनिकल सर्वर एंडपॉइंट और वीएस कोड शैली विन्यास के लिए।
• FXMacroData के साथ एक चैटजीपीटी कस्टम जीपीटी बनाएँ जब लक्ष्य सतह चट्टान के बजाय चट्टानी है।
• FXMacroData अंत बिंदुओं और प्रमाणीकरण का उपयोग करें डिस्पेंसर द्वारा प्रयुक्त REST API क्रेडेंशियल पैटर्न के लिए।
• Google Apps स्क्रिप्ट और Google शीट के साथ FXMacroData का उपयोग करें एक Google कार्यक्षेत्र कार्यप्रवाह के लिए जो मिथुन की आवश्यकता नहीं है.

आपने जो बनाया

अब आपके पास FXMacroData के ऊपर एक मिथुन ऐप के लिए मूल पैटर्न हैः मिथुन कार्यों के एक छोटे से सेट को परिभाषित करें, अपने बैकएंड में डिस्पैचर रखें, उत्पादन FXMacrData REST एंडपॉइंट्स के लिए रूट टूल कॉल करें, और एक ग्राउंड उत्तर के लिए मिथुन को लौटाए गए डेटा को फ़ीड करें।

अगला उपयोगी कदम एक कार्यप्रवाह चुनना है, जैसे कि "दैनिक यूएसडी घटना जोखिम" या "यूआर / यूएसडी मैक्रो ब्रीफिंग", और इसे अंत से अंत तक बनाने से पहले अधिक उपकरण जोड़ना। एक संकीर्ण, विश्वसनीय मिथुन ऐप एक विस्तृत उपकरण सूची को हरा देगा जो अनिश्चित उत्तर उत्पन्न करता है।

व्यापक एजेंट एकीकरण के लिए, एमसीपी सर्वर गाइडनिर्धारक स्क्रिप्ट और डैशबोर्ड के लिए, REST एपीआई प्रलेखन.