OpenAI Agents SDK también está disponible en el sitio web de OpenAI Es una buena opción cuando un flujo de trabajo de negociación de divisas necesita un modelo para planificar, llamar a herramientas, rastrear su trabajo y hacer una pausa antes de los pasos de riesgo. calendarios de lanzamiento, el historial de anuncios, El valor de la moneda de referencia ¿ Qué ? El valor de las pérdidas contexto, El COT el posicionamiento, productos básicos, y Sesiones de divisas- ¿ Qué ?
https://mcp.fxmacrodata.com- ¿ Qué ?
El límite es importante. OpenAI debe razonar sobre la pregunta, elegir herramientas y escribir el resumen. FXMacroData debe responder preguntas de hecho sobre lo que se imprimió, lo que era esperado, lo programado y qué ruta de origen produjo cada fila. Los controles de riesgos deben seguir siendo deterministas código de aplicación, especialmente alrededor de Indicador de precios de los Estados Unidos¿ Qué ? Pago de los trabajadores no agrícolas¿ Qué ? Tasa de política de la Reserva Federal Las decisiones y las configuraciones de divisas basadas en la liberación.
En forma
Utilice esto para
Asistentes de investigación macro, informadores de riesgo de liberación, copilotos de escritorio, paquetes de evidencia y prototipos de herramientas comerciales con revisión humana.
Use Respuestas cuando
Su servicio debe recibir todas las llamadas de herramientas, validar las entradas, ejecutar las solicitudes de FXMacroData y decidir si continúa.
Utilice Agents SDK cuando
Quieres agentes reutilizables con herramientas, entregas, rastreo, barandillas, sesiones y pausas de aprobación.
Por qué OpenAI se adapta a los agentes de negociación de divisas
La pila de agentes actual de OpenAI ofrece a los desarrolladores dos rutas útiles. API de respuestas Es la interfaz de nivel inferior para las respuestas de modelos, herramientas incorporadas, llamadas de funciones, estado y datos externos.
Esto es relevante para el comercio de divisas porque la parte difícil no es definir el IPC, NFP, tasas de política o COT. La parte difícil es asegurarse de que el agente use las filas actuales, sepa qué eventos del calendario se confirman, nombre los huecos de datos y mantenga la interpretación separada de la ejecución.
Principio básico
Deja que OpenAI administre el lenguaje, la elección de herramientas y la orquestación. Deja que FXMacroData proporcione calendarios de lanzamiento, filas de anuncios, precios de divisas, COT, materias primas y pruebas de sesión. Deja a tu aplicación tener su propia aprobación y límites de riesgo comercial.
Forma del flujo de trabajo
1. Intención
Pida el riesgo de liberación, el contexto de pareja, la evidencia de posicionamiento o un paquete de investigación previo al comercio.
2. Ruta de viaje
Utilice Respuestas para un bucle controlado o Agents SDK para la orquestación de agentes recurrentes.
3. Las pruebas
Llame a FXMacroData con herramientas de función REST o MCP remoto desde el host canónico.
4. Repasar
Regresar hechos, interpretación, rutas de origen, marcas de tiempo, brechas de datos y un estado de revisión humana.
Respuestas, Agentes SDK, REST, o MCP?
| El derecho a elegir | Lo mejor para | Compromiso |
|---|---|---|
| API de respuestas | Bucles de aplicación personalizados donde ejecuta, valida, registra y continúa cada llamada de herramienta usted mismo. | Usted es dueño de la orquestación, la ramificación, y cada llamada de continuación. |
| Agentes SDK | Agentes de investigación FX reutilizables con instrucciones, herramientas de función, sesiones, rastreo, barandillas y pausas de aprobación. | Debes diseñar el alcance especialista y detener las condiciones claramente. |
| El resto de datos de FXMacroData | Aplicaciones del lado del servidor que poseen claves de API, reintentos, validación de esquemas, almacenamiento en caché y registros de auditoría. | Mantén los esquemas de envoltura y herramientas del punto final. |
| El MCP de FXMacroData | Flujos de trabajo remotos de OpenAI que deben descubrir las herramientas FXMacroData alojadas desde https://mcp.fxmacrodata.com- ¿ Qué ? |
Debe utilizar herramientas y aprobaciones permitidas para que el modelo vea solo la superficie del mercado necesaria. |
Los requisitos previos
- Una clave de API OpenAI para la API de Respuestas o el SDK de Agentes.
- Una clave de la API FXMacroData almacenada en la configuración del lado del servidor.
- Python 3.10 o más reciente.
- Un primer flujo de trabajo que es de solo lectura: calendario, anuncios, FX, COT, productos básicos o sesiones.
- Una regla clara de que ninguna salida del modelo coloca pedidos, cambia el riesgo o envía decisiones visibles al cliente sin aprobación determinista.
pip install -U openai openai-agents requests
export OPENAI_API_KEY="YOUR_OPENAI_API_KEY"
export FXMD_API_KEY="YOUR_FXMACRODATA_API_KEY"
Para las comprobaciones directas de REST, utilizar los puntos finales de producción FXMacroData y la autenticación de parámetros de consulta:
curl "https://api.fxmacrodata.com/v1/calendar/usd?api_key=YOUR_API_KEY"
curl "https://api.fxmacrodata.com/v1/announcements/usd/inflation?api_key=YOUR_API_KEY"
curl "https://api.fxmacrodata.com/v1/forex/eur/usd?api_key=YOUR_API_KEY"
curl "https://api.fxmacrodata.com/v1/cot/usd?api_key=YOUR_API_KEY"
Step 1: Wrap FXMacroData REST
Comience con un pequeño ayudante del lado del servidor. El modelo debe recibir rutas de puntos finales, filas devueltas y marcas de tiempo. No debe recibir credenciales en bruto.
import os
import requests
API_ROOT = "https://api.fxmacrodata.com/v1"
def fxmd_get(path: str, **params) -> dict:
params["api_key"] = os.environ["FXMD_API_KEY"]
response = requests.get(f"{API_ROOT}{path}", params=params, timeout=20)
response.raise_for_status()
return {
"source": f"/v1{path}",
"payload": response.json(),
}
Exponer sólo la superficie de la herramienta que el flujo de trabajo necesita. Para un agente de riesgo de liberación de USD, comience con herramientas de calendario y anuncio. Agregue FX, COT, productos básicos y sesiones después de que el contrato de salida sea estable.
Paso 2: Utilice las herramientas de función de API de respuestas
La llamada de función de OpenAI permite a un modelo solicitar datos de las herramientas que su aplicación define con el esquema JSON. En la ruta de la API de Respuestas, su aplicación recibe la llamada de la función, ejecuta FXMacroData, envía el resultado y luego le pide al modelo la respuesta final.
from openai import OpenAI
client = OpenAI()
tools = [{
"type": "function",
"name": "fxmacrodata_calendar",
"description": "Return scheduled macro releases for one currency.",
"parameters": {
"type": "object",
"properties": {"currency": {"type": "string", "enum": ["usd", "eur", "gbp", "jpy"]}},
"required": ["currency"],
"additionalProperties": False,
},
"strict": True,
}]
response = client.responses.create(
model="gpt-5.6",
tools=tools,
input="Brief the next USD macro release risk for EUR/USD."
)
El lado de la aplicación debe inspeccionar los elementos de salida, ejecutar la herramienta solicitada, añadir un function_call_output artículo, y llamar client.responses.create(...) Mantenga ese bucle limitado, registrado y limitado a datos de mercado de solo lectura.
import json
input_items = [{"role": "user", "content": "Brief next USD release risk."}]
response = client.responses.create(model="gpt-5.6", tools=tools, input=input_items)
for item in response.output:
if item.type == "function_call" and item.name == "fxmacrodata_calendar":
args = json.loads(item.arguments)
evidence = fxmd_get(f"/calendar/{args['currency']}")
input_items.append(item)
input_items.append({
"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(evidence),
})
Paso 3: Mueva el bucle en el SDK de Agentes
Moverse al Agents SDK cuando el mismo flujo de trabajo se ejecute repetidamente, cuando se desea que el ejecutor del SDK gestione las llamadas de herramientas, o cuando el flujo del trabajo necesite transferencias, rastreo, barandillas o estados de aprobación reutilizables.
from agents import Agent, Runner, function_tool
@function_tool
def fxmacrodata_calendar(currency: str) -> dict:
"""Return scheduled macro releases for one currency."""
return fxmd_get(f"/calendar/{currency.lower()}")
agent = Agent(
name="FX release risk analyst",
instructions=(
"Use FXMacroData tools for current facts. "
"Separate facts, interpretation, source paths, and data gaps."
),
tools=[fxmacrodata_calendar],
)
result = Runner.run_sync(agent, "Brief next USD release risk for EUR/USD.")
print(result.final_output)
No comience con un agente amplio que pueda navegar por la web, llamar a URL arbitrarias e invocar la ejecución del mercado al mismo tiempo.
Paso 4: Añadir MCP remoto de FXMacroData
Utilice MCP remoto cuando desee que la capa de herramientas de OpenAI descubra la superficie de herramentación de FXMacroData alojada. El punto final canónico de FX MacroData MCP es:
https://mcp.fxmacrodata.com
La API de Respuestas admite servidores MCP remotos a través de la interfaz integrada mcp Mantenga las aprobaciones activadas mientras se desarrolla, y restrinja las herramientas al flujo de trabajo que está probando.
response = client.responses.create(
model="gpt-5.6",
tools=[{
"type": "mcp",
"server_label": "fxmacrodata",
"server_url": "https://mcp.fxmacrodata.com",
"allowed_tools": ["release_calendar", "indicator_query", "forex"],
"require_approval": "always",
}],
input="Check the next USD release and current EUR/USD context."
)
REST y MCP pueden coexistir. REST es generalmente mejor para flujos de trabajo de propiedad de aplicaciones que necesitan esquemas estables, claves de caché, reintentos y registros de auditoría. MCP es generally mejor cuando el host debe descubrir un catálogo de herramientas compartidas y dejar que el modelo elija entre calendarios de lanzamiento, filas de indicadores, tasas de cambio, COT, commodity o herramienta de sesión.
Paso 5: Añadir controles de riesgos financieros
Para el trabajo de negociación de divisas, el modelo no debe ser la autoridad de riesgo final. Utilice el agente para reunir y explicar la evidencia. Utiliza código determinista para validar la salida, comprobar la frescura de los datos y decidir si un humano debe aprobar el siguiente paso.
Control mínimo
- Herramientas de solo lectura FXMacroData para la primera versión.
allowed_toolso listas de herramientas explícitas para cada flujo de trabajo.- Caps de bucle, tiempos de espera y registro de peticiones.
- Respuestas finales que separan los hechos extraídos de la interpretación.
- Las rutas de origen y las marcas de tiempo en cada informe de mercado.
- Aprobada por el ser humano antes de las alertas, cambios de asignación o enrutamiento de órdenes.
Un contrato de salida revisable mantiene el flujo de trabajo de escritorio claro:
{
"facts": [
{"source": "/v1/calendar/usd", "summary": "Next confirmed USD event..."}
],
"interpretation": "The event risk is concentrated before New York open.",
"missing_data": [],
"risk_state": "human_review_required",
"not_trade_advice": true
}
Preguntas frecuentes
¿Puede el SDK de Agentes OpenAI usar FXMacroData?
Sí. El Agents SDK puede utilizar FXMacroData a través de herramientas de funciones definidas por la aplicación que llaman https://api.fxmacrodata.comEl soporte MCP remoto de OpenAI también puede conectarse al servidor MCP FXMacroData alojado en https://mcp.fxmacrodata.com- ¿ Qué ?
¿Debería usar la API de Respuestas o el SDK de Agentes?
Utilice la API de Respuestas cuando su aplicación debe poseer cada llamada de herramienta y paso de continuación.
¿Debería OpenAI usar FXMacroData REST o MCP?
Utilice REST cuando el servidor posee credenciales, esquemas, intentos de reutilización, almacenamiento en caché y registros de auditoría. Utilice MCP cuando un host compatible con OpenAI deba descubrir un catálogo de herramientas FXMacroData compartido y llamar a herramienta seleccionadas con aprobaciones.
¿Puede este lugar operar automáticamente?
Este patrón es para investigación de solo lectura y soporte de decisión revisable. No permita que un modelo coloque operaciones, cambie el riesgo o active la ejecución sin controles deterministas y aprobación humana o política explícita.
Guías de FXMacroData relacionadas
- Documentación de la API de FXMacroData
- Documentación del servidor MCP de FXMacroData
- Cómo utilizar OpenAI Codex con FXMacroData para el comercio de divisas
- Cómo crear un GPT personalizado ChatGPT con FXMacroData
- Construir LangGraph FX Macro Agents con FXMacroData