Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Tinkintos funkcijos (funkcijų kvietimas)

Paskaita 11 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Prijunk Grok prie savo paslaugų
  2. Kaip tai veikia
  3. Deklaruok funkciją
  4. Gauk funkcijos kvietimą
  5. Grąžink rezultatą
  6. Geriausios aprašymų praktikos
  7. Klaidų apdorojimas
  8. Svarbiausi punktai

Prijunk Grok prie savo paslaugų

Serverio įrankiai (web_search, x_search, code_interpreter) yra patogūs, tačiau apriboti tik xAI paslaugomis. Naudodamas tinkintus function įrankius, gali prijungti Grok prie bet kurios API ar paslaugos savo infrastruktūroje.

Kaip tai veikia

Funkcijų kvietimas vyksta trijų žingsnių ciklu:

  1. Deklaravimas: Užklausoje aprašai savo funkcijas (pavadinimą, aprašymą, parametrus).
  2. Kvietimas: Modelis sugeneruoja funkcijos kvietimą su tinkamais argumentais ir sustabdo generavimą.
  3. Rezultatas: Tavo kodas įvykdo funkciją, tada siunti rezultatą atgal modeliui, kad jis galėtų suformuluoti atsakymą.

Deklaruok funkciją

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Book me a table for 2 people tonight at 8 PM.",
  "tools": [{
    "type": "function",
    "name": "book_restaurant",
    "description": "Books a table at a restaurant",
    "parameters": {
      "type": "object",
      "properties": {
        "restaurant_name": {
          "type": "string",
          "description": "Restaurant name"
        },
        "date": {
          "type": "string",
          "description": "Date in YYYY-MM-DD format"
        },
        "time": {
          "type": "string",
          "description": "Time in HH:MM format"
        },
        "guests": {
          "type": "integer",
          "description": "Number of guests"
        }
      },
      "required": ["date", "time", "guests"]
    }
  }]
}

Kiekvienos funkcijos ir parametro aprašymas yra kritiškai svarbus. Modelis jais remiasi spręsdamas, kada iškviesti funkciją ir kaip užpildyti argumentus.

Gauk funkcijos kvietimą

Kai modelis nusprendžia iškviesti tavo funkciją, atsakyme atsiranda function_call elementas:

{
  "id": "resp-xyz789",
  "status": "completed",
  "output": [{
    "type": "function_call",
    "name": "book_restaurant",
    "arguments": "{\"date\": \"2026-04-03\", \"time\": \"20:00\", \"guests\": 2}",
    "call_id": "call-abc123"
  }]
}

Laukas arguments yra JSON eilutė, kurią turi išanalizuoti (parse). Laukas call_id identifikuoja šį konkretų kvietimą.

Grąžink rezultatą

Įvykdęs funkciją savo kode, grąžink rezultatą:

import json

# 1. Pradinė užklausa
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What's the weather like in Paris?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Retrieves current weather",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }
    }]
)

# 2. Patikrink, ar modelis nori iškviesti funkciją
for item in response.output:
    if item.type == "function_call":
        args = json.loads(item.arguments)

        # 3. Įvykdyk savo funkciją
        weather_data = get_weather_from_api(args["city"])

        # 4. Grąžink rezultatą modeliui
        final = client.responses.create(
            model="grok-4.20-0309-reasoning",
            input=[{
                "type": "function_call_output",
                "call_id": item.call_id,
                "output": json.dumps(weather_data)
            }],
            previous_response_id=response.id
        )
        print(final.output[0].content[0].text)

Geriausios aprašymų praktikos

Modelis remiasi aprašymais, kad suprastų tavo funkcijas. Būk tikslus:

{
  "name": "search_products",
  "description": "Searches for products in the e-commerce catalog. Returns the top 10 results sorted by relevance. Supports search by name, category, or price range.",
  "parameters": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search terms (product name, brand, keyword)"
      },
      "category": {
        "type": "string",
        "enum": ["electronics", "clothing", "home", "sports"],
        "description": "Product category to filter"
      },
      "max_price": {
        "type": "number",
        "description": "Maximum price in euros"
      }
    },
    "required": ["query"]
  }
}

Naudok enum iš anksto apibrėžtoms reikšmėms, išsamų description kiekvienam parametrui ir pažymėk kaip required tik būtiniausius parametrus.

Klaidų apdorojimas

Jei tavo funkcija nepavyksta, grąžink klaidą kaip rezultatą:

try:
    result = call_external_api(args)
    output = json.dumps(result)
except Exception as e:
    output = json.dumps({"error": str(e)})

final = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{
        "type": "function_call_output",
        "call_id": call_id,
        "output": output
    }],
    previous_response_id=response.id
)

Modelis interpretuoja klaidą ir gali performuluoti savo atsakymą arba pasirinkti kitą metodą.

Svarbiausi punktai

  • Tinkintos funkcijos sujungia Grok su tavo pačių paslaugomis.
  • Ciklas toks: deklaruok, gauk kvietimą, įvykdyk, grąžink rezultatą.
  • Funkcijų ir parametrų aprašymai nukreipia modelio pasirinkimą.
  • Laukas arguments yra JSON eilutė, kurią reikia išanalizuoti kliento pusėje.
  • Grąžink klaidas kaip rezultatus, kad modelis galėtų prisitaikyti.