Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Gníomhaire Aimsire Iomlán

Ceacht 12 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Tóg Gníomhaire Aimsire Iomlán ón tTús
  2. Ailtireacht an Ghníomhaire
  3. Cur Chun Feidhme na Feidhme
  4. Príomhlúb an Ghníomhaire
  5. Tástáil an Ghníomhaire
  6. Feabhsuithe Féideartha
  7. Príomhphointí

Tóg Gníomhaire Aimsire Iomlán ón tTús

Sa cheacht seo, cuirfidh tú le chéile gach rud atá foghlamtha agat chun gníomhaire aimsire iomlán a thógáil. Léiríonn an gníomhaire seo an timthriall glao feidhme iomlán: sainmhíniú uirlise, láimhseáil il-chasadh, láimhseáil earráidí, agus freagraí i dteanga nádúrtha.

Ailtireacht an Ghníomhaire

Tá trí uirlis ag an ngníomhaire aimsire:

  1. get_weather — faigh an aimsir reatha do chathair
  2. get_forecast — faigh réamhaisnéisí do roinnt laethanta
  3. get_alerts — seiceáil foláirimh aimsire gníomhacha
import json
from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a city. "
                          "Returns temperature, humidity, wind, and conditions.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City name (e.g., Paris, Lyon, Marseille)"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "default": "celsius"
                    }
                },
                "required": ["city"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "get_forecast",
            "description": "Get weather forecasts for multiple days. "
                          "Returns day-by-day conditions.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City name"
                    },
                    "days": {
                        "type": "integer",
                        "description": "Number of forecast days (1-7)",
                        "default": 3
                    }
                },
                "required": ["city"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "get_alerts",
            "description": "Check active weather alerts (storms, heatwaves, "
                          "floods) for a city or region.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City or region name"
                    }
                },
                "required": ["city"]
            }
        }
    }
]

Cur Chun Feidhme na Feidhme

I dtimpeallacht táirgeachta, thabharfadh na feidhmeanna seo glao ar API aimsire fíor. Anseo, déanaimid na freagraí a shamhlú:

def get_weather(city, unit="celsius"):
    # In production: call OpenWeatherMap, WeatherAPI, etc.
    data = {
        "Paris": {"temp": 18, "humidity": 65, "wind": 12, "conditions": "Cloudy"},
        "Lyon": {"temp": 21, "humidity": 55, "wind": 8, "conditions": "Sunny"},
        "Marseille": {"temp": 24, "humidity": 70, "wind": 15, "conditions": "Clear"},
    }
    result = data.get(city, {"error": f"City {city} not found"})
    if "error" not in result:
        result["city"] = city
        result["unit"] = unit
    return result

def get_forecast(city, days=3):
    return {
        "city": city,
        "forecast": [
            {"day": f"Day+{i+1}", "temp_max": 20+i, "temp_min": 12+i,
             "conditions": "Variable"}
            for i in range(days)
        ]
    }

def get_alerts(city):
    alerts = {
        "Marseille": [{"type": "Strong Wind", "severity": "orange",
                       "message": "Gusts up to 90 km/h expected"}],
    }
    return {"city": city, "alerts": alerts.get(city, [])}

Príomhlúb an Ghníomhaire

def execute_function(name, args):
    functions = {
        "get_weather": get_weather,
        "get_forecast": get_forecast,
        "get_alerts": get_alerts,
    }
    fn = functions.get(name)
    if not fn:
        return {"error": f"Unknown function {name}"}
    try:
        return fn(**args)
    except Exception as e:
        return {"error": str(e)}

def weather_agent(user_message):
    messages = [
        {
            "role": "system",
            "content": "You are an expert weather assistant. "
                       "Use the available tools to provide "
                       "accurate weather information. Always "
                       "check alerts when asked about the "
                       "weather for a city."
        },
        {"role": "user", "content": user_message}
    ]

    for _ in range(5):  # Max 5 turns
        response = client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=tools
        )

        message = response.choices[0].message
        messages.append(message)

        if not message.tool_calls:
            return message.content

        for tc in message.tool_calls:
            args = json.loads(tc.function.arguments)
            print(f"  → Calling: {tc.function.name}({args})")
            result = execute_function(tc.function.name, args)
            messages.append({
                "role": "tool",
                "tool_call_id": tc.id,
                "content": json.dumps(result, ensure_ascii=False)
            })

    return "Sorry, too many turns required."

Tástáil an Ghníomhaire

# Test 1: simple question
print(weather_agent("What's the weather like in Paris?"))

# Test 2: forecast
print(weather_agent("Give me the forecast for Lyon for 5 days"))

# Test 3: multi-city (parallel calls)
print(weather_agent("Compare the weather between Paris, Lyon, and Marseille"))

# Test 4: complex question
print(weather_agent("I'm going to Marseille this weekend, what do you recommend?"))

Cuireann Tástáil 3 glaotha comhthreomhara ar siúl: déanann an tsamhail glao ar get_weather trí huaire ag an am céanna. Is í Tástáil 4 an ceann is suimiúla — ba chóir don tsamhail glao a dhéanamh ar get_forecast AGUS ar get_alerts do Marseille, agus ansin na torthaí a shintéisiú ina gcomhairle phraiticiúil.

Feabhsuithe Féideartha

Chun gníomhaire atá réidh le haghaidh táirgeachta a chruthú, cuir leis na nithe seo a leanas:

  • Taisce: seachain glao a dhéanamh ar an API aimsire don chathair chéanna laistigh de 10 nóiméad
  • Geo-chódú: tiontaigh ainmneacha cathracha go comhordanáidí chun cruinneas níos fearr a bhaint amach
  • Stair: sábháil roghanna an úsáideora (aonaid, cathracha is fearr leat)
  • Idirnáisiúnú: tacaigh le hainmneacha cathracha i ngach teanga

Príomhphointí

  • Comhcheanglaíonn gníomhaire iomlán uirlisí iolracha le freagrachtaí ar leith
  • Treoraíonn an chóras-leide iompar na samhla (seiceáil foláirimh go córasach)
  • Coscann an lúb il-chasadh le max_iterations lúba gan teorainn
  • Lárníonn an t-aiseoir execute_function an cur i gcrích agus an láimhseáil earráidí
  • Déan tástáil le hiarratais éagsúla: simplí, il-chathair, casta
  • I dtimpeallacht táirgeachta, cuir taisce, geo-chódú, agus stair an úsáideora leis