El equipo La información de los agentes de FXMacroData es útil cuando un flujo de trabajo de macro FX necesita varios agentes especializados en lugar de un solo prompt amplio. calendarios de lanzamiento, el historial de anuncios, El valor de la moneda de referencia contexto, El COT el posicionamiento, productos básicos, y Sesión de divisas datos.
El patrón más útil de CrewAI para las finanzas es un pequeño equipo de investigación: un agente busca pruebas, uno escribe la nota macro y uno revisa la salida para las fechas faltantes o las reclamaciones no respaldadas. Indicador de precios de los Estados Unidos¿ Qué ? Pago de los trabajadores no agrícolas, o Tasa de política de la Reserva Federal el briefing basado en filas reales de FXMacroData en lugar de memoria de modelo.
En forma
Utilice esto para
Equipos de investigación, notas de monitoreo de lanzamiento, listas de verificación de preparación de eventos, flujos de trabajo de llamada de herramientas y macro briefings revisados por humanos.
No empiece con
Un equipo con acceso a la web, herramientas de corredores con capacidad de escritura, o una instrucción para responder preguntas macro recientes sin una llamada de datos.
Mejor primera construcción
Un equipo de dos agentes de liberación de USD que llama a FXMacroData, redacta una sesión informativa y revisa la evidencia antes de la salida.
Por qué CrewAI encaja en la investigación de macro FX
Los marcos de documentación de CrewAI Flujos como un control estructurado y de estado del flujo de trabajo y Equipo de trabajo Los equipos de agentes de rol autónomos que completan tareas delegadas. que se divide bien para financiar: un flujo puede poseer el proceso determinista, mientras que un equipo realiza el trabajo de investigación y revisión dentro de un paso controlado.
Para la macro FX, el punto importante no es la autonomía del agente en sí mismo. El valor es la separación de roles. Un explorador de versiones debe buscar datos actuales. un analista debe interpretar solo la evidencia devuelta. Un revisor debe marcar valores obsoletos, antecedentes faltantes o afirmaciones no respaldadas antes de usar un briefing.
Flujo de trabajo de finanzas de CrewAI
1. Scout
Obtener calendarios, filas de lanzamiento, contexto de pares, COT, productos básicos o datos de sesión.
2. Analizar
Explicar la configuración utilizando sólo la evidencia de FXMacroData devuelta y los huecos explícitos.
3. Repasar
Verifique las fechas, valores, antecedentes, rutas de herramientas y advertencias de datos perdidos.
4. para
Devuelva sólo una nota de investigación, mantenga la ejecución, las órdenes y las acciones de cuenta fuera de la tripulación.
Para llevar: CrewAI coordina el flujo de trabajo en forma de personas; FXMacroData proporciona los hechos en los que el fluyo de trabajo puede confiar.
REST, herramientas de la tripulación o MCP: ¿Qué camino utilizar?
CrewAI puede utilizar herramientas ordinarias, una configuración MCP estructurada o una referencia directa al servidor MCP a través de la mcps el campo.
| Camino | Usarlo cuando | Lo que obtiene CrewAI | Nivel de control |
|---|---|---|---|
| Envase REST | Su aplicación posee credenciales, validación, reintentos y registros. | Una herramienta personalizada estrecha como fxmacrodata_calendar- ¿ Qué ? |
El más alto. |
| Herramientas de tripulación | Quieres que los agentes y tareas para llamar a las herramientas de Python. | Nombres de herramientas, descripciones y campos de entrada de Pydantic. | - ¿Qué es eso? |
| El MCP | Quieres que CrewAI descubra herramientas de un servidor MCP alojado. | Las herramientas de FXMacroData MCP a través de https://mcp.fxmacrodata.com- ¿ Qué ? |
Administrado por el anfitrión. |
| Flujo más tripulación | El proceso necesita estado, ramificación, aprobación o ejecuciones programadas. | Una concha determinista alrededor del equipo de investigación. | Control del flujo de trabajo de producción. |
Los requisitos previos
Necesitas Python, CrewAI, un proveedor de LLM configurado para CrewAI y un primer flujo de trabajo de solo lectura.
pip install crewai 'crewai[tools]' requests pydantic
pip install mcp
Para los ejemplos 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"
Paso 1: Defina las funciones de la tripulación
Qué hacer: Crear roles que coincidan con el proceso de investigación en lugar de generic "experto en finanzas" indica.
| Agente de la policía | Trabajo | Herramientas permitidas | Producción |
|---|---|---|---|
| Escaut de liberación | Busca las filas actuales y los eventos programados. | Calendario y herramientas de anuncio de FXMacroData. | El paquete de pruebas. |
| Analista de macro | Explicar la relevancia del mercado y el riesgo del escenario. | Paquete de pruebas, contexto de pareja, COT, productos básicos. | Esbozo de la reunión. |
| Revisor de pruebas | Compruebe las fechas, valores, antecedentes, rutas de origen y lagunas. | Pruebas de solo lectura y lista de verificación de validación. | Nota aprobada o razón de rechazo. |
Por qué es importante: Los roles claros reducen la posibilidad de que un agente invente evidencia y apruebe su propia respuesta.
Paso 2: Envuelva FXMacroData como una herramienta REST
Qué hacer: La documentación de herramientas de CrewAI muestra herramienta personalizada construida por subclases BaseTool y declarando un esquema de entrada Pydantic.
from crewai.tools import BaseTool
from pydantic import BaseModel, Field
import requests
class CalendarInput(BaseModel):
currency: str = Field(..., description="3-letter currency code")
class FXMacroCalendarTool(BaseTool):
name: str = "fxmacrodata_calendar"
description: str = "Fetch confirmed macro events from FXMacroData."
args_schema: type[BaseModel] = CalendarInput
def _run(self, currency: str) -> dict:
response = requests.get(
f"https://api.fxmacrodata.com/v1/calendar/{currency.lower()}",
params={"api_key": "YOUR_API_KEY"},
timeout=10,
)
response.raise_for_status()
return response.json()
Si el equipo sólo necesita el calendario USD, no le entregue un cliente HTTP amplio.
Un esquema compacto para esa herramienta se ve así:
{
"name": "fxmacrodata_calendar",
"description": "Fetch confirmed macro events from FXMacroData.",
"input_schema": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "3-letter currency code"
}
},
"required": ["currency"]
}
}
Paso 3: Hacer una investigación controlada
Qué hacer: las tareas de CrewAI pueden ejecutarse secuencial o jerárquicamente, y el contexto de la tarea permite que las tarea posteriores utilicen salidas anteriores.
from crewai import Agent, Task, Crew, Process
calendar_tool = FXMacroCalendarTool()
release_scout = Agent(
role="FX macro release scout",
goal="Fetch current FXMacroData evidence before analysis.",
backstory="You only use approved read-only data tools.",
tools=[calendar_tool],
allow_delegation=False,
)
reviewer = Agent(
role="Evidence reviewer",
goal="Reject unsupported or stale macro claims.",
backstory="You check dates, values, priors, and data gaps.",
)
research_task = Task(
description="Fetch USD macro events and summarize release risk.",
expected_output="Evidence pack with dates, indicators, and source paths.",
agent=release_scout,
)
review_task = Task(
description="Review the evidence pack for missing dates or values.",
expected_output="Approved briefing or clear rejection reason.",
agent=reviewer,
context=[research_task],
)
crew = Crew(
agents=[release_scout, reviewer],
tasks=[research_task, review_task],
process=Process.sequential,
)
result = crew.kickoff()
Por qué es importante: El revisor no está ahí para dar tono, está ahí a rechazar pruebas que faltan.
Paso 4: Conectar CrewAI con el MCP de FXMacroData
Qué hacer: Utilice MCP cuando desee que CrewAI descubra herramientas desde un servidor de herramienta alojado. mcps El sistema de control de los servidores MCP está basado en la información de los agentes y de las configuraciones de servidores de MCP estructuradas para un mayor control.
La referencia al MCP FXMacroData alojada más simple es:
from crewai import Agent
agent = Agent(
role="FX macro analyst",
goal="Use FXMacroData MCP tools for current macro evidence.",
backstory="You separate source data from interpretation.",
mcps=["https://mcp.fxmacrodata.com?api_key=YOUR_API_KEY"],
)
Para la configuración HTTP con transmisión explícita, use el objeto de servidor MCP estructurado de CrewAI:
from crewai.mcp import MCPServerHTTP
fxmd_mcp = MCPServerHTTP(
url="https://mcp.fxmacrodata.com?api_key=YOUR_API_KEY",
streamable=True,
cache_tools_list=True,
)
agent = Agent(
role="FX macro analyst",
goal="Analyze FXMacroData MCP results.",
backstory="You cite data gaps and timestamps.",
mcps=[fxmd_mcp],
)
Si el host solicita un archivo de configuración MCP genérico, la entrada canónica de FXMacroData es:
{
"servers": {
"FXMacroData": {
"type": "http",
"url": "https://mcp.fxmacrodata.com"
}
}
}
Utilice REST direct wrappers cuando su aplicación necesita una validación de petición estricta y registros. https://mcp.fxmacrodata.com- ¿ Qué ?
Paso 5: Añadir barreras de seguridad financieras
La documentación de seguridad de MCP de CrewAI es clara que los servidores de herramientas deben ser confiables, los transportes remotos deben usar HTTPS y los metadatos de herramentas pueden afectar el comportamiento del modelo.
Lista de verificación de las barandillas
- Conecte sólo a servidores de confianza de MCP y a las URL de producción de FXMacroData.
- Mantenga el primer conjunto de herramientas solo de lectura: calendario, anuncios, FX, COT, productos básicos y sesiones.
- Requerir fechas, valores reales, valores anteriores, rutas de puntos finales y notas de datos en la salida final.
- Establezca el contexto de la tarea explícitamente para que el revisor revise el paquete de pruebas antes de aprobar la sesión informativa.
- Mantenga la ejecución de corredores, acciones de cuentas y la colocación de órdenes fuera del conjunto de herramientas de CrewAI.
Required briefing contract:
1. FXMacroData tools used
2. Release dates and values
3. Prior and revised values where available
4. Market interpretation
5. Data gaps or stale-data warnings
6. No trade execution or account action
El patrón de producción práctico es simple: CrewAI puede coordinar el proceso de investigación, pero FXMacroData sigue siendo la fuente de la verdad y un humano o un sistema separado posee las decisiones más allá de la nota de investigación.
Preguntas frecuentes
¿Puede CrewAI usar FXMacroData?
Sí. Los agentes de CrewAI pueden utilizar herramientas REST personalizadas para los puntos finales de FXMacroData o conectarse al servidor MCP alojado de FX MacroData en https://mcp.fxmacrodata.com- ¿ Qué ?
¿Debería CrewAI reemplazar una fuente de datos macro?
No. CrewAI coordina agentes y tareas. FXMacroData debe seguir siendo la fuente de las filas de lanzamiento, calendarios, contexto de FX, COT, productos básicos, marcas de tiempo y brechas de datos.
¿Debería usar REST o MCP con CrewAI?
Utilice REST cuando su aplicación posee credenciales, validación, política de caché, intentos de reinicio y registros.
¿Necesito CrewAI Fluxes para la primera versión?
No necesariamente. Comience con un equipo pequeño y tareas secuenciales. Añada un flujo cuando el proceso necesite estado, ramificación, programación, aprobación u orquestación duradera alrededor del equipo.
Fuentes y referencias
- Introducción de la tripulación
- Documentación de los agentes de la tripulación
- Documentación de las tareas de la tripulación
- Documentación de las herramientas de CrewAI
- Resumen del MCP de CrewAI
- Transporte MCP HTTP transmitible por CrewAI
- Transporte de los equipos de tripulación de las SSE
- Consideraciones de seguridad del MCP de CrewAI
- Documentación de la API de FXMacroData
- Documentación de la MCP de FXMacroData
- Esquema de producción de FXMacroData y OpenAPI
Guías de integración de IA de FXMacroData relacionadas