Gníomhaire Aimsire Iomlán
Ar an leathanach seo
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:
- get_weather — faigh an aimsir reatha do chathair
- get_forecast — faigh réamhaisnéisí do roinnt laethanta
- 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_iterationslúba gan teorainn - Lárníonn an t-aiseoir
execute_functionan 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