FXMacroData: REST, MCP 및 A2A로 쌍둥이 앱을 구축

구글의 쌍둥이 함수 호출 모델이 도구를 요청할 수 있게 해 주며, 이는 일반 시장 코멘트 대신 현재 데이터를 필요로 하는 매크로 앱에 Gemini를 유용하게 만듭니다. 이 가이드의 끝으로, 응답하기 전에 출시 캘린더, 지표 역사, FX 스팟 컨텍스트, COT 위치, 상품 및 세션 상태를 위해 FXMacroData를 호출하는 Gemini 앱을 구축하는 실용적인 청사진을 갖게됩니다.

필수 조건

• 구글 AI 스튜디오나 베르텍스 AI 제미니 API 키
• 보호된 엔드포인트 가족을 위한 FXMacroData API 키
• 비밀이 안전하게 저장될 수 있는 백엔드 런타임
• 파이썬 3.11 또는 최신 버전은 아래 예제에서 사용 됩니다.
• 특정 사용자 작업 흐름, 예를 들어 "다음 USD 이벤트 위험에 대해 설명" 또는 "EUR/USD 거시적 맥락을 요약".

이 기사는 젠미니 API 기능 호출에 초점을 맞추고, 은퇴하지 않습니다 구글 대화 동작에 대한 동작 표면. 나중에 음성 앱을 원한다면 실제 안드로이드 앱을 만들고 앱 액션이나 앱 함수를 평가해야 합니다. 웹, 백엔드 또는 분석 보조자라면, 제미니 함수 호출은 직접적인 방법입니다.

1. 올바른 구글 표면을 선택

구글은 여러 개의 비슷한 이름의 표면을 가지고 있습니다. 그들은 상호 교환 할 수 없습니다. FXMacroData에 대한 유용한 분할은 다음과 같습니다:

이 가이드의 나머지 부분은 제미니 API를 사용합니다. FXMacroData MCP MCP에 익숙한 클라이언트, 하지만 Gemini API 앱은 일반적으로 명시적인 함수 선언과 자신의 백엔드에서 디스파이저가 필요합니다.

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()

중요한 세부 사항은 인증서 처리입니다. 공개 예제에서는 질의 매개 변수 패턴을 표시해야 하지만 생산 Gemini 앱은 비밀 관리자 또는 환경 변수에서 키를 읽어야 하며 결코 프롬프트에 넣지 않아야합니다.

6. 쌍둥이에게 도구를 요청하고 그 결과를 돌려주도록 하자

정확한 제미니 SDK 코드는 프로젝트마다 다르지만 루프는 같은 형태를 가지고 있습니다.

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"
    }
  }
}

A2A는 다시 다른 계층이다. MCP는 에이전트 또는 모델 호스트를 도구 및 데이터 리소스로 연결합니다. A2 A는 독립적 인 에이전트를 서로 연결합니다, 일반적으로 한 에이전트가 다른 에이전트로 작업을 발견, 메시지 또는 위임해야 할 때. FXMacroData는 먼저 데이터 / 도구 계층에 속합니다. 나중에 다른 에이젠트가 호출 할 수있는 전용 FXMacrData 연구 에이전트에 노출하면 A2a 래퍼가 유용합니다.

Gemini 앱을 직접 만들 때 Gemini 함수 호출을 사용하십시오. 호스트가 이미 원격 MCP 서버에 연결하는 방법을 알고있을 때 MCP를 사용하십시오 . 응용 프로그램이 정확히 어떤 엔드포인트로 호출해야하는지 알 때 REST을 사용하세요. 통합 경계가 앱에서 데이터가 아닌 에이전트에서 에이전트로있을 때 A2A를 사용하세요

9. 실용적 인 첫 화면 을 만들 것

가장 빠른 유용한 제품은 빈 채팅 상자가 아닙니다. 첫 화면을 집중된 브리핑 작업 흐름으로 만들십시오:

이것은 제미니에 한정된 작업을 제공하고 사용자에게 감사 가능한 답을 제공합니다. 또한 깨끗한 업그레이드 경로를 만듭니다: 추가 상품 상품화폐에 대해서는 추가합니다. 외환 세션 시점 컨텍스트를 위해, 정책 해석을 위해 중앙은행 보도자료를 추가합니다.

10. 생산 체크리스트

• 저장 GEMINI_API_KEY 그리고 FXMACRODATA_API_KEY 서버 쪽에서만
• 원자 키를 로그하지 않고도 도구 이름, 논증 및 응답 상태를 로그합니다.
• "데이터 사용이 불가능하다"를 반환합니다.
• FXMacroData 호출이 응답을 지원하는 사용자 표시
• 거시적 맥락과 거래 자문을 분리합니다.
• 캐시 안정 호출은 적절한 경우
• 공개된 예제를 생산 URL에 보관하세요.

일반적인 질문

제미니가 FXMacroData를 사용할 수 있나요?

예. 제미니 앱은 FXMacroData REST 엔드포인트를 함수 선언으로 노출시키고, 서버 측 디스파셔에서 그 함수를 호출하고, 귀환된 매크로 데이터를 제미니와 연결하여 토착된 답변을 제공할 수 있습니다.

FXMacroData로 Gemini 앱을 만드는 가장 빠른 방법은 무엇일까요?

작은 집합의 제미니 함수를 선언하고 백엔드 디스파셔를 통해 실행하고, 서버 측 인증서로 FXMacroData REST 엔드포인트를 호출하고, 최종 답변을 작성하기 전에 매크로 데이터를 제미니와 반환합니다.

MCP 통합과 같나요?

MCP는 호스트가 이미 원격 MCP 서버를 지원할 때 가장 좋습니다. Gemini 함수 호출은 Gemini 앱을 직접 만들고 명시적인 함수 선언과 디스펜서가 필요할 때 유용합니다.

A2A와 어떻게 다른가요?

A2A는 독립 에이전트 서비스 간의 통신을 위한 것입니다. FXMacroData의 제미니 앱은 일반적으로 REST, MCP 또는 제미니와 함수 호출을 통해 앱에서 데이터에 액세스하는 것으로 시작되며 에이전트로 대리인으로 시작되지 않습니다.

안드로이드 앱이 필요해요?

아니. 당신은 안드로이드 없이 유용한 쌍둥이 API 앱을 만들 수 있습니다. 안드로이스 앱 액션 또는 앱 함수는 FXMacroData가 실제 안드로이드 앱을 배포하면 나중에 관련됩니다.

출처 및 시행 참조

이 가이드의 구현 패턴은 아래의 공개 Gemini, FXMacroData 및 에이전트 프로토콜 문서에 근거합니다.

• 제미니 API 함수 호출 문서 도구 선언 및 함수 응답에 대한
• Google 대화 행동의 일몰 통보에 대한 행동 왜 Google Actions 경로는 올바른 목표가 아닌지
• 에이전트2 에이전트의 프로토콜 문서 REST/MCP/Gemini/A2A 비교에서 설명된 에이전트-에전트 경계에서
• FXMacroData REST API 문서 엔드포인트 인증 및 생산 API 경로
• FXMacroData MCP 서버 문서 MCP가 가능한 클라이언트 및 원격 도구 탐색

관련 FXMacroData 가이드

이 문서는 FXMacroData AI 통합 클러스터의 일부입니다. 다른 호스트, 프로토콜 또는 구현 경로가 필요할 때 다음 안내서를 사용하십시오.

• FXMacroData를 위한 MCP 클라이언트를 구축 호스트가 원격 MCP 도구를 지원할 때
• FXMacroData MCP 서버 문서 정규 서버 엔드포인트와 VS 코드 스타일 구성에 대한
• FXMacroData로 ChatGPT 사용자 지정 GPT를 생성 표면이 제미니가 아닌 채트GPT일 때
• FXMacroData 엔드포인트 및 인증을 사용 디스파셔가 사용하는 REST API 인증 패턴에 대해
• FXMacroData를 Google Apps 스크립트 및 Google 시트와 함께 사용 제미니를 사용하지 않는 Google 워크스페이스 작업 흐름에 사용하실 수 있습니다.

당신이 만든

이제 FXMacroData 위에 Gemini 앱의 핵심 패턴을 가지고 있습니다. 작은 Gemini 함수 집합을 정의하고, 배스엔드에서 디스펜서를 유지하고, 생산 FXMacrodata REST 엔드포인트로 라우트 도구 호출을 하고, 귀환된 데이터를 다시 Gemini에 공급하여 토착된 답변을 제공합니다.

다음 유용한 단계는 "일일 USD 이벤트 위험" 또는 "EUR/USD 매크로 브리핑"과 같은 하나의 워크플로를 선택하고 더 많은 도구를 추가하기 전에 끝에서 끝으로 구축하는 것입니다. 좁고 신뢰할 수있는 쌍둥이 앱은 불확실한 답변을 생산하는 광범위한 도구 목록을 이길 것입니다.

더 넓은 에이전트 통합을 위해, 검토 MCP 서버 가이드결정론적 스크립트와 대시보드에서는 REST API 문서- 그래요