Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Εργαλεία διακομιστή και κλήση συναρτήσεων

Μάθημα 10 / 12 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Εμπλουτισμός παρτίδων με εργαλεία
  2. Εργαλεία πλευράς διακομιστή
  3. Κλήση συναρτήσεων πλευράς πελάτη
  4. Συνδυασμός εργαλείων
  5. Περιορισμοί εργαλείων παρτίδας
  6. Βασικά σημεία

Το μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026 με βάση την τεκμηρίωση της xAI: η έκπτωση για παρτίδες (batch) είναι 20% στα κατάλληλα μοντέλα κειμένου (όχι 50%), τα παραδείγματα ακολουθούν το REST API και το επίσημο xai-sdk (client.batch.*· το Batch API της xAI δεν χρησιμοποιεί τη μορφή της OpenAI, οπότε το SDK της OpenAI δεν εφαρμόζεται), ενώ το Responses API έχει προτεραιότητα έναντι του Chat Completions, το οποίο αποτελεί πλέον παρωχημένο endpoint στην xAI. Πηγές: Batch API · REST Reference · Batch Pricing.

Εμπλουτισμός παρτίδων με εργαλεία

Τα αιτήματα παρτίδας δεν περιορίζονται σε απλό κείμενο. Τα εργαλεία διακομιστή και η κλήση συναρτήσεων λειτουργούν και σε ασύγχρονη λειτουργία, με μια βασική διάκριση: τα πρώτα εκτελούνται κατά την επεξεργασία από την xAI, ενώ τα δεύτερα επιστρέφουν τον έλεγχο σε εσάς.

Εργαλεία πλευράς διακομιστή

Τα εργαλεία διακομιστή εκτελούνται κατά την επεξεργασία της παρτίδας, ακριβώς όπως σε πραγματικό χρόνο: το Grok καλεί το εργαλείο, λαμβάνει το αποτέλεσμα, το ενσωματώνει στον συλλογισμό του και η παρτίδα επιστρέφει την τελική απάντηση. Λειτουργούν με το Responses API.

Αναζήτηση στον ιστό

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

Στη λειτουργία παρτίδας, η αναζήτηση στον ιστό εξυπηρετεί τον εμπλουτισμό δεδομένων: επαλήθευση πληροφοριών, συλλογή πρόσφατων γεγονότων, σύγκριση προφίλ με διαδικτυακές πηγές.

Αναζήτηση στο X

Το εργαλείο x_search αναζητά αναρτήσεις στο X, χρήσιμο για την παρακολούθηση του συναισθήματος σχετικά με ένα θέμα ή μια μάρκα:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Εκτέλεση κώδικα

Το Grok μπορεί να γράψει και να εκτελέσει κώδικα Python σε ένα απομονωμένο περιβάλλον. Στο Responses API, το εργαλείο ονομάζεται code_interpreter (το xAI SDK το ονομάζει code_execution):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

Η εκτέλεση κώδικα είναι κατάλληλη για ακριβείς υπολογισμούς, στατιστικές αναλύσεις και μετασχηματισμούς δεδομένων που το μοντέλο θα διαχειριζόταν λιγότερο αξιόπιστα από τη μνήμη του.

Απομακρυσμένοι διακομιστές MCP

Το εργαλείο mcp συνδέει το Grok με έναν απομακρυσμένο διακομιστή MCP, ο οποίος περιγράφεται εντός του ίδιου του αιτήματος: δεν απαιτείται προηγούμενη ρύθμιση λογαριασμού. Τα πεδία server_url και server_label είναι υποχρεωτικά· το allowed_tools περιορίζει τα εκτεθειμένα εργαλεία και το authorization περνά ένα διακριτικό (token) στον διακομιστή. Γίνονται δεκτοί μόνο οι μεταφορείς Streamable HTTP και SSE.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Χωρίς το allowed_tools, όλοι οι ορισμοί εργαλείων από τον διακομιστή εισάγονται στο πλαίσιο του μοντέλου και χρεώνονται ως tokens εισόδου σε κάθε αίτημα παρτίδας: σε 50.000 αιτήματα, ο περιορισμός της λίστας αποδίδει γρήγορα.

Κλήση συναρτήσεων πλευράς πελάτη

Η κλήση συναρτήσεων είναι ένα εργαλείο πλευράς πελάτη: το Grok παράγει μια δομημένη κλήση συνάρτησης, αλλά ο κώδικάς σας την εκτελεί. Στην παρτίδα, το μοντέλο επιστρέφει αυτές τις κλήσεις στα αποτελέσματά του, για offline επεξεργασία.

Ορισμοί συναρτήσεων

Στο Responses API, δηλώστε τη συνάρτηση επίπεδα, με τα name, description και parameters στο ανώτατο επίπεδο. Το tool_choice: "required" αναγκάζει το μοντέλο να καλέσει τουλάχιστον ένα εργαλείο, κάτι που ταιριάζει στην εξαγωγή δεδομένων:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Επεξεργασία αποτελεσμάτων

Με το SDK, διαβάστε τις κλήσεις συναρτήσεων στο tool_calls κάθε επιτυχούς αποτελέσματος:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

Η κλήση συναρτήσεων σε παρτίδα είναι ιδανική για δομημένη εξαγωγή: εσείς ορίζετε το σχήμα δεδομένων, το Grok διαβάζει τα έγγραφα και παράγει τις κλήσεις, και εσείς τις επεξεργάζεστε μαζικά.

Συνδυασμός εργαλείων

Μπορείτε να συνδυάσετε πολλαπλά εργαλεία διακομιστή σε ένα μόνο αίτημα:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

Το Grok χρησιμοποιεί τα εργαλεία με τη σειρά που κρίνει σχετική: εδώ, αναζήτηση στον ιστό για λήψη των δεδομένων και στη συνέχεια εκτέλεση κώδικα για τον υπολογισμό.

Περιορισμοί εργαλείων παρτίδας

  • Τα εργαλεία διακομιστή αυξάνουν τον χρόνο επεξεργασίας κάθε αιτήματος και, κατά συνέπεια, της παρτίδας.
  • Τα αιτήματα με αναζήτηση εξαρτώνται από το τι δημοσιεύουν οι πηγές κατά τον χρόνο επεξεργασίας, όχι κατά τον χρόνο υποβολής.
  • Η κλήση συναρτήσεων πραγματοποιεί μόνο έναν γύρο επικοινωνίας (round trip) ανά αίτημα: για συνέχεια, υποβάλετε ένα νέο αίτημα παρτίδας που θα περιέχει τη συνομιλία και τα αποτελέσματα της συνάρτησής σας.
  • Οι μη φιλτραρισμένοι ορισμοί εργαλείων MCP διογκώνουν κάθε αίτημα.

Βασικά σημεία

  • Τα εργαλεία διακομιστή (web, X, κώδικας, MCP) εκτελούνται από την xAI κατά την επεξεργασία, μέσω του Responses API.
  • Περιγράψτε έναν διακομιστή MCP στο αίτημα (server_url, server_label), χωρίς προηγούμενη ρύθμιση.
  • Η κλήση συναρτήσεων επιστρέφει δομημένες κλήσεις που εσείς εκτελείτε στην πλευρά του πελάτη.
  • Μια ανταλλαγή πολλαπλών γύρων απαιτεί ένα νέο αίτημα παρτίδας ανά γύρο.
  • Περιορίστε τα εκτεθειμένα εργαλεία για να αποφύγετε την πληρωμή για τους ορισμούς τους σε κάθε αίτημα.