Merge pull request #4 from madebygps/fix-spanish-naming

Spanish updates

Author: madebygps

examples/spanish/agent_mcp_local.py

@@ -46,13 +46,12 @@
 async def main() -> None:
     """Ejecuta un agente conectado a un servidor MCP local para registrar gastos."""
     async with (
-        MCPStreamableHTTPTool(name="Servidor MCP de Gastos", url=MCP_SERVER_URL) as mcp_server,
+        MCPStreamableHTTPTool(name="Expenses MCP Server", url=MCP_SERVER_URL) as mcp_server,
         ChatAgent(
             chat_client=client,
             instructions=(
                 "Ayudas a la gente con tareas usando las herramientas disponibles. "
                 f"La fecha de hoy es {datetime.now().strftime('%Y-%m-%d')}. "
-                "Responde en español."
             ),
             tools=[mcp_server],
         ) as agent,

examples/spanish/agent_mcp_remote.py

@@ -53,7 +53,6 @@ async def main() -> None:
             instructions=(
                 "Ayudas con preguntas sobre la documentación de Microsoft. "
                 "Usa las herramientas disponibles para buscar documentación relevante. "
-                "Responde en español."
             ),
             tools=[mcp_server],
         ) as agent,

examples/spanish/agent_middleware.py

@@ -5,11 +5,11 @@
  │
  ▼
  ┌─────────────────────────────────────────────┐
- │         Middleware de Agente                │
+ │         Agent Middleware                    │
  │  (temporización, bloqueo, registro)         │
  │                                             │
  │  ┌───────────────────────────────────────┐  │
- │  │       Middleware de Chat              │  │
+ │  │       Chat Middleware                 │  │
  │  │  (registro, conteo de mensajes)       │  │
  │  │                                       │  │
  │  │        ┌──────────────┐               │  │
@@ -18,7 +18,7 @@
  │  │               │ llamadas a funciones  │  │
  │  │               ▼                       │  │
  │  │  ┌──────────────────────────────────┐ │  │
- │  │  │   Middleware de Funciones        │ │  │
+ │  │  │   Function Middleware           │ │  │
  │  │  │  (registro, temporización)       │ │  │
  │  │  │                                  │ │  │
  │  │  │  get_weather(), get_date(), ...  │ │  │
@@ -49,7 +49,7 @@
 from agent_framework import (
     AgentMiddleware,
     AgentRunContext,
-    AgentRunResponse,
+    AgentResponse,
     ChatAgent,
     ChatContext,
     ChatMessage,
@@ -98,9 +98,9 @@
 
 
 def get_weather(
-    city: Annotated[str, Field(description="La ciudad para consultar el clima.")],
+    city: Annotated[str, Field(description="The city to get the weather for.")],
 ) -> dict:
-    """Devuelve datos del clima para una ciudad dada, un diccionario con temperatura y descripción."""
+    """Devuelve datos del clima para una ciudad dada, con temperatura y descripción."""
     logger.info(f"Obteniendo clima para {city}")
     if random.random() < 0.05:
         return {"temperature": 22, "description": "Soleado"}
@@ -109,12 +109,12 @@ def get_weather(
 
 
 def get_current_date() -> str:
-    """Obtiene la fecha actual del sistema y la devuelve como texto en formato AAAA-MM-DD."""
+    """Obtiene la fecha actual del sistema en texto con formato YYYY-MM-DD."""
     logger.info("Obteniendo fecha actual")
     return datetime.now().strftime("%Y-%m-%d")
 
 
-# ---- Middleware basado en funciones ----
+# ---- Function-based middleware ----
 
 
 async def timing_agent_middleware(
@@ -123,38 +123,38 @@ async def timing_agent_middleware(
 ) -> None:
     """Middleware de agente que registra el tiempo de ejecución."""
     start = time.perf_counter()
-    logger.info("[⏲️ Temporización][ Middleware de Agente] Iniciando ejecución del agente")
+    logger.info("[⏲️ Temporización][ Agent Middleware] Iniciando ejecución del agente")
 
     await next(context)
 
     elapsed = time.perf_counter() - start
-    logger.info(f"[⏲️ Temporización][ Middleware de Agente] Ejecución completada en {elapsed:.2f}s")
+    logger.info(f"[⏲️ Temporización][ Agent Middleware] Ejecución completada en {elapsed:.2f}s")
 
 
 async def logging_function_middleware(
     context: FunctionInvocationContext,
     next: Callable[[FunctionInvocationContext], Awaitable[None]],
 ) -> None:
-    """Middleware de función que registra las llamadas y resultados de funciones."""
+    """Middleware de función que registra llamadas y resultados."""
     logger.info(
-        f"[🪵 Registro][ Middleware de Función] Llamando a {context.function.name} con args: {context.arguments}"
+        f"[🪵 Registro][ Function Middleware] Llamando a {context.function.name} con args: {context.arguments}"
     )
 
     await next(context)
 
-    logger.info(f"[🪵 Registro][ Middleware de Función] {context.function.name} devolvió: {context.result}")
+    logger.info(f"[🪵 Registro][ Function Middleware] {context.function.name} devolvió: {context.result}")
 
 
 async def logging_chat_middleware(
     context: ChatContext,
     next: Callable[[ChatContext], Awaitable[None]],
 ) -> None:
-    """Middleware de chat que registra las interacciones con la IA."""
-    logger.info(f"[💬 Registro][ Middleware de Chat] Enviando {len(context.messages)} mensajes a la IA")
+    """Middleware de chat que registra interacciones con la IA."""
+    logger.info(f"[💬 Registro][ Chat Middleware] Enviando {len(context.messages)} mensajes a la IA")
 
     await next(context)
 
-    logger.info("[💬 Registro][ Middleware de Chat] Respuesta de la IA recibida")
+    logger.info("[💬 Registro][ Chat Middleware] Respuesta de la IA recibida")
 
 
 # ---- Middleware basado en clases ----
@@ -172,14 +172,14 @@ async def process(
         context: AgentRunContext,
         next: Callable[[AgentRunContext], Awaitable[None]],
     ) -> None:
-        """Verifica los mensajes en busca de contenido bloqueado y termina si lo encuentra."""
+        """Verifica mensajes con contenido bloqueado y termina si lo encuentra."""
         last_message = context.messages[-1] if context.messages else None
         if last_message and last_message.text:
             for word in self.blocked_words:
                 if word.lower() in last_message.text.lower():
-                    logger.warning(f"[❌ Bloqueo][ Middleware de Agente] Solicitud bloqueada: contiene '{word}'")
+                    logger.warning(f"[❌ Bloqueo][ Agent Middleware] Solicitud bloqueada: contiene '{word}'")
                     context.terminate = True
-                    context.result = AgentRunResponse(
+                    context.result = AgentResponse(
                         messages=[
                             ChatMessage(
                                 role=Role.ASSISTANT, text=f"Lo siento, no puedo procesar solicitudes sobre '{word}'."
@@ -192,7 +192,7 @@ async def process(
 
 
 class TimingFunctionMiddleware(FunctionMiddleware):
-    """Middleware de función que mide el tiempo de ejecución de cada llamada a función."""
+    """Middleware de función que mide el tiempo de ejecución de cada llamada."""
 
     async def process(
         self,
@@ -201,16 +201,16 @@ async def process(
     ) -> None:
         """Mide el tiempo de ejecución de la función y registra la duración."""
         start = time.perf_counter()
-        logger.info(f"[⌚️ Temporización][ Middleware de Función] Iniciando {context.function.name}")
+        logger.info(f"[⌚️ Temporización][ Function Middleware] Iniciando {context.function.name}")
 
         await next(context)
 
         elapsed = time.perf_counter() - start
-        logger.info(f"[⌚️ Temporización][ Middleware de Función] {context.function.name} tardó {elapsed:.4f}s")
+        logger.info(f"[⌚️ Temporización][ Function Middleware] {context.function.name} tardó {elapsed:.4f}s")
 
 
 class MessageCountChatMiddleware(ChatMiddleware):
-    """Middleware de chat que cuenta el número total de mensajes enviados a la IA."""
+    """Middleware de chat que cuenta el total de mensajes enviados a la IA."""
 
     def __init__(self) -> None:
         """Inicializa el contador de mensajes."""
@@ -224,14 +224,14 @@ async def process(
         """Cuenta los mensajes y registra el total acumulado."""
         self.total_messages += len(context.messages)
         logger.info(
-            "[🔢 Conteo][ Middleware de Chat] Mensajes en esta solicitud: %s, total hasta ahora: %s",
+            "[🔢 Conteo][ Chat Middleware] Mensajes en esta solicitud: %s, total hasta ahora: %s",
             len(context.messages),
             self.total_messages,
         )
 
         await next(context)
 
-        logger.info("[🔢 Conteo][ Middleware de Chat] Respuesta de chat recibida")
+        logger.info("[🔢 Conteo][ Chat Middleware] Respuesta de chat recibida")
 
 
 # ---- Configuración del agente ----
@@ -247,7 +247,6 @@ async def process(
     instructions=(
         "Ayudas a la gente a planificar su fin de semana. "
         "Usa las herramientas disponibles para consultar el clima y la fecha. "
-        "Responde en español."
     ),
     tools=[get_weather, get_current_date],
     middleware=[
@@ -281,10 +280,10 @@ async def extra_agent_middleware(
         context: AgentRunContext,
         next: Callable[[AgentRunContext], Awaitable[None]],
     ) -> None:
-        """Middleware a nivel de ejecución que solo aplica a esta ejecución específica."""
-        logger.info("[🏃🏽‍♀️ Middleware de Ejecución] Este middleware solo aplica a esta ejecución")
+        """Middleware de ejecución que solo aplica a esta ejecución específica."""
+        logger.info("[🏃🏽‍♀️ Execution Middleware] Este middleware solo aplica a esta ejecución")
         await next(context)
-        logger.info("[🏃🏽‍♀️ Middleware de Ejecución] Ejecución completada")
+        logger.info("[🏃🏽‍♀️ Execution Middleware] Ejecución completada")
 
     response = await agent.run(
         "¿Cómo estará el clima en Barcelona?",

examples/spanish/agent_supervisor.py

@@ -51,8 +51,8 @@
 
 
 def get_weather(
-    city: Annotated[str, Field(description="Ciudad para consultar el clima.")],
-    date: Annotated[str, Field(description="Fecha (YYYY-MM-DD) para la que se quiere el clima.")],
+    city: Annotated[str, Field(description="City to fetch the weather for.")],
+    date: Annotated[str, Field(description="Date (YYYY-MM-DD) to fetch the weather for.")],
 ) -> dict:
     """Devuelve datos meteorológicos para una ciudad y fecha dadas."""
     logger.info(f"Obteniendo el clima para {city} en {date}")
@@ -63,8 +63,8 @@ def get_weather(
 
 
 def get_activities(
-    city: Annotated[str, Field(description="Ciudad para consultar actividades.")],
-    date: Annotated[str, Field(description="Fecha (YYYY-MM-DD) para consultar actividades.")],
+    city: Annotated[str, Field(description="City to fetch activities for.")],
+    date: Annotated[str, Field(description="Date (YYYY-MM-DD) to fetch activities for.")],
 ) -> list[dict]:
     """Devuelve una lista de actividades para la ciudad y la fecha indicadas."""
     logger.info(f"Obteniendo actividades para {city} en {date}")
@@ -105,7 +105,7 @@ async def plan_weekend(query: str) -> str:
 
 
 def find_recipes(
-    query: Annotated[str, Field(description="Consulta del usuario o comida/ingrediente deseado")],
+    query: Annotated[str, Field(description="User query or desired meal/ingredient")],
 ) -> list[dict]:
     """Devuelve recetas (JSON) basadas en una consulta."""
     logger.info(f"Buscando recetas para '{query}'")

examples/spanish/agent_tool.py

@@ -44,7 +44,7 @@
 
 
 def get_weather(
-    city: Annotated[str, Field(description="Nombre de la ciudad")],
+    city: Annotated[str, Field(description="City name")],
 ) -> dict:
     """Devuelve datos meteorológicos para una ciudad: temperatura y descripción."""
     logger.info(f"Obteniendo el clima para {city}")

examples/spanish/agent_tools.py

@@ -46,7 +46,7 @@
 
 
 def get_weather(
-    city: Annotated[str, Field(description="La ciudad para consultar el clima.")],
+    city: Annotated[str, Field(description="City to fetch the weather for.")],
 ) -> dict:
     """Devuelve datos meteorológicos para una ciudad: temperatura y descripción."""
     logger.info(f"Obteniendo el clima para {city}")
@@ -63,8 +63,8 @@ def get_weather(
 
 
 def get_activities(
-    city: Annotated[str, Field(description="La ciudad para consultar actividades.")],
-    date: Annotated[str, Field(description="La fecha (YYYY-MM-DD) para consultar actividades.")],
+    city: Annotated[str, Field(description="City to fetch activities for.")],
+    date: Annotated[str, Field(description="Date (YYYY-MM-DD) to fetch activities for.")],
 ) -> list[dict]:
     """Devuelve una lista de actividades para una ciudad y fecha dadas."""
     logger.info(f"Obteniendo actividades para {city} en {date}")

examples/spanish/mcp_server.py

@@ -16,47 +16,47 @@
 from fastmcp import FastMCP
 
 logging.basicConfig(level=logging.WARNING, format="%(asctime)s - %(message)s")
-logger = logging.getLogger("GastosMCP")
+logger = logging.getLogger("ExpensesMCP")
 logger.setLevel(logging.INFO)
 
 SCRIPT_DIR = Path(__file__).parent
 EXPENSES_FILE = SCRIPT_DIR / "expenses.csv"
 
-mcp = FastMCP("Rastreador de Gastos")
+mcp = FastMCP("Expenses Tracker")
 
 
-class MetodoPago(Enum):
-    """Métodos de pago que puedes usar para gastos."""
+class PaymentMethod(Enum):
+    """Métodos de pago aceptados para gastos."""
 
     AMEX = "amex"
     VISA = "visa"
-    EFECTIVO = "efectivo"
+    CASH = "cash"
 
 
-class Categoria(Enum):
-    """Categorías de gastos para clasificar."""
+class Category(Enum):
+    """Categorías de gastos para clasificación."""
 
-    COMIDA = "comida"
-    TRANSPORTE = "transporte"
-    ENTRETENIMIENTO = "entretenimiento"
-    COMPRAS = "compras"
-    TECNOLOGIA = "tecnologia"
-    OTRO = "otro"
+    FOOD = "comida"
+    TRANSPORT = "transporte"
+    ENTERTAINMENT = "entretenimiento"
+    SHOPPING = "compras"
+    GADGET = "tecnologia"
+    OTHER = "otro"
 
 
 @mcp.tool
-async def agregar_gasto(
-    fecha_gasto: Annotated[date, "Fecha del gasto en formato AAAA-MM-DD"],
-    amount: Annotated[float, "Monto numérico positivo del gasto"],
-    category: Annotated[Categoria, "Etiqueta de categoría"],
-    description: Annotated[str, "Descripción legible del gasto"],
-    payment_method: Annotated[MetodoPago, "Método de pago utilizado"],
+async def add_expense(
+    expense_date: Annotated[date, "Expense date in YYYY-MM-DD format"],
+    amount: Annotated[float, "Positive numeric expense amount"],
+    category: Annotated[Category, "Category label"],
+    description: Annotated[str, "Human-readable expense description"],
+    payment_method: Annotated[PaymentMethod, "Payment method used"],
 ) -> str:
     """Agrega un nuevo gasto al archivo expenses.csv."""
     if amount <= 0:
         return "Error: El monto debe ser positivo"
 
-    date_iso = fecha_gasto.isoformat()
+    date_iso = expense_date.isoformat()
     logger.info(f"Agregando gasto: ${amount} por {description} el {date_iso}")
 
     try:
@@ -76,7 +76,7 @@ async def agregar_gasto(
 
 
 @mcp.resource("resource://expenses")
-async def obtener_datos_gastos() -> str:
+async def get_expenses_data() -> str:
     """Obtiene los datos de gastos desde el archivo CSV."""
     logger.info("Datos de gastos consultados")
 

examples/spanish/openai_tool_calling.py

@@ -42,17 +42,17 @@ def lookup_weather(city_name: str | None = None, zip_code: str | None = None) ->
         "type": "function",
         "function": {
             "name": "lookup_weather",
-            "description": "Consulta el clima para un nombre de ciudad o código postal dado.",
+            "description": "Look up weather for a given city name or zip code.",
             "parameters": {
                 "type": "object",
                 "properties": {
                     "city_name": {
                         "type": "string",
-                        "description": "El nombre de la ciudad",
+                        "description": "City name",
                     },
                     "zip_code": {
                         "type": "string",
-                        "description": "El código postal",
+                        "description": "Zip code",
                     },
                 },
                 "strict": True,
@@ -63,7 +63,7 @@ def lookup_weather(city_name: str | None = None, zip_code: str | None = None) ->
 ]
 
 messages = [
-    {"role": "system", "content": "Eres un chatbot del clima. Responde en español."},
+    {"role": "system", "content": "Eres un chatbot del clima"},
     {"role": "user", "content": "¿Está soleado en Madrid?"},
 ]
 response = client.chat.completions.create(