Ενσωματωμένα εργαλεία: αναζήτηση web, X και συλλογές
Σε αυτήν τη σελίδα
Τα εγγενή εργαλεία του Voice Agent
Εκτός από την προσαρμοσμένη κλήση συναρτήσεων και τους διακομιστές MCP, το API του Voice Agent παρέχει αρκετά ενσωματωμένα εργαλεία που ο πράκτορας μπορεί να χρησιμοποιήσει μόνος του κατά τη διάρκεια της συνομιλίας. Αυτά τα εργαλεία δεν απαιτούν λογική εκτέλεσης από την πλευρά σας: οι διακομιστές της xAI τα διαχειρίζονται εξ ολοκλήρου.
web_search: αναζήτηση στον ιστό
Αυτό το εργαλείο επιτρέπει στον πράκτορα να αναζητά πληροφορίες στον ιστό σε πραγματικό χρόνο κατά τη διάρκεια της συνομιλίας:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Όταν ο χρήστης θέτει ένα ερώτημα βασισμένο σε γεγονότα («Ποιος είναι ο καιρός στο Παρίσι;», «Ποιος κέρδισε τον αγώνα χθες βράδυ;»), ο πράκτορας εκτελεί αυτόματα μια αναζήτηση στον ιστό και χρησιμοποιεί τα αποτελέσματα για να διαμορφώσει την προφορική απάντησή του.
Δεν αποστέλλεται κανένα συγκεκριμένο συμβάν στον πελάτη για τα ενσωματωμένα εργαλεία: ο πράκτορας χρησιμοποιεί τα αποτελέσματα εσωτερικά και τα ενσωματώνει στην ηχητική απόκρισή του.
x_search: αναζήτηση στο X (Twitter)
Αυτό το εργαλείο επιτρέπει στον πράκτορα να αναζητά αναρτήσεις στην πλατφόρμα X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Η παράμετρος allowed_x_handles είναι προαιρετική. Όταν ορίζεται, η αναζήτηση περιορίζεται σε αναρτήσεις από αυτούς τους συγκεκριμένους λογαριασμούς. Χωρίς αυτήν, ο πράκτορας αναζητά σε όλο το X.
Περιπτώσεις χρήσης του x_search
- Παρακολούθηση ανταγωνισμού: «Τι ανάρτησε ο [ανταγωνιστής] αυτή την εβδομάδα;»
- Υποστήριξη πελατών: «Υπάρχουν πρόσφατα παράπονα για το προϊόν μας στο X;»
- Ειδήσεις: «Ποια είναι τα τελευταία νέα για το [θέμα];»
- Τάσεις: «Για τι μιλούν οι άνθρωποι αυτή τη στιγμή στον [κλάδο];»
file_search: αναζήτηση σε συλλογές RAG
Το εργαλείο file_search επιτρέπει στον πράκτορα φωνής να κάνει ερωτήματα σε συλλογές διανυσματοποιημένων εγγράφων (RAG). Είναι το ιδανικό εργαλείο για πράκτορες που χρειάζονται πρόσβαση σε μια εσωτερική βάση γνώσεων:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Παράμετροι
vector_store_ids: τα αναγνωριστικά (IDs) των διανυσματικών συλλογών προς ερώτημα. Μπορείτε να αναφέρετε πολλά για να συνδυάσετε διαφορετικές πηγές γνώσηςmax_num_results: ο μέγιστος αριθμός αποτελεσμάτων προς επιστροφή (10 από προεπιλογή)
Σενάρια χρήσης
- Συχνές ερωτήσεις (FAQ) μέσω φωνής: ο πράκτορας απαντά σε ερωτήσεις πελατών με βάση την τεκμηρίωσή σας
- Τεχνική υποστήριξη: αναζήτηση σε εγχειρίδια και οδηγούς αντιμετώπισης προβλημάτων
- Εκπαίδευση: ο πράκτορας έχει πρόσβαση στο περιεχόμενο του μαθήματος για να απαντά σε ερωτήσεις των εκπαιδευόμενων
- Νομική συνδρομή: αναζήτηση σε συμβόλαια και νομικά έγγραφα
Συνδυασμός πολλών εργαλείων
Μπορείτε να ενεργοποιήσετε πολλά εργαλεία ταυτόχρονα. Ο πράκτορας επιλέγει το πιο σχετικό με βάση το πλαίσιο της συνομιλίας:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "file_search",
"vector_store_ids": ["vs_documentation"]
},
{
"type": "function",
"name": "create_ticket",
"description": "Creates a support ticket",
"parameters": {
"type": "object",
"properties": {
"subject": {"type": "string"},
"priority": {"type": "string", "enum": ["low", "medium", "high"]}
},
"required": ["subject"]
}
},
{
"type": "mcp",
"server_url": "https://mcp.exemple.com/sse",
"server_label": "CRM"
}
]
}
}
Σε αυτό το παράδειγμα, ο πράκτορας μπορεί να:
- Αναζητήσει στον ιστό για γενικές ερωτήσεις
- Ελέγξει το X για τάσεις και απόψεις
- Ανατρέξει στην εσωτερική τεκμηρίωση για τεχνικές ερωτήσεις
- Δημιουργήσει ένα εισιτήριο (ticket) μέσω κλήσης συνάρτησης
- Προσπελάσει το CRM μέσω MCP
Βασικά σημεία
- Διατίθενται πέντε τύποι εργαλείων:
web_search,x_search,file_search,functionκαιmcp - Τα ενσωματωμένα εργαλεία (
web_search,x_search,file_search) εκτελούνται στον διακομιστή χωρίς να απαιτείται κώδικας από εσάς - Το
file_searchκάνει ερωτήματα σε διανυσματικές συλλογές για RAG - Το
x_searchμπορεί να περιοριστεί σε συγκεκριμένους λογαριασμούς με τοallowed_x_handles - Μπορείτε να συνδυάσετε κάθε τύπο εργαλείου στην ίδια συνεδρία