Μετάβαση στο περιεχόμενο

Ικανότητες

Ό,τι μπορεί να κάνει το AI σας, συσκευασμένο.

Άνοιγμα του Ικανότητες
Ελέγχθηκε με τον πίνακα ελέγχου στις 20 Νοεμβρίου 2026

Το δημόσιο API έχει επτά μεθόδους για τις ικανότητες. Το API εξακολουθεί να λέει μια ικανότητα πράκτορα AI (AI agent), οπότε αυτό είναι το όνομα σε κάθε μέθοδο. Ενεργούν σε ικανότητες που υπάρχουν ήδη: καρφιτσώνουν μία, σημειώνουν μία ως αγαπημένη, αρχειοθετούν μία, της δημιουργούν εικόνα και καταγράφουν μια συγκατάθεση. Καθεμία ενεργεί για τον λογαριασμό του οποίου το κλειδί API χρησιμοποιείτε.

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

Στείλτε ένα αίτημα σε μια μέθοδο με το κλειδί σας:

curl -s https://xuda.ai/cpi/pin_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_SKILL_ID"}'
const res = await fetch('https://xuda.ai/cpi/pin_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', agent_id: 'YOUR_SKILL_ID' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/pin_ai_agent',
    json={'api_key': 'YOUR_API_KEY', 'agent_id': 'YOUR_SKILL_ID'},
)

Μια επιτυχής απάντηση έχει code 1. Μια απορριφθείσα έχει αρνητικό code και λέει γιατί στο data.

Κάθε μέθοδος δέχεται το id της ικανότητας ως agent_id, που είναι το τελευταίο μέρος της διεύθυνσης της ικανότητας στο dashboard. Εκτός από το set_agent_tool_consent, κάθε μέθοδος δέχεται επίσης ένα προαιρετικό workspace_id, για να ενεργήσει σε χώρο εργασίας διαφορετικό από τον δικό σας αρχικό. Πρέπει να είστε ιδιοκτήτης αυτού του χώρου εργασίας.

Καρφίτσωμα και σήμανση ως αγαπημένο

  • Τα pin_ai_agent και unpin_ai_agent καρφιτσώνουν μια ικανότητα και αφαιρούν το καρφίτσωμα. Το dashboard ενημερώνεται αμέσως, οπότε μια ανοιχτή σελίδα δείχνει την αλλαγή.
  • Τα favorite_ai_agent και unfavorite_ai_agent ορίζουν και αφαιρούν το σήμα αγαπημένου, την καρδιά στην κάρτα της ικανότητας. Ένα αγαπημένο είναι επίσης αυτό που απαριθμεί η επιλογή Αγαπημένα του μενού Εμφάνιση.

Αρχειοθέτηση

Το archive_ai_agent μετακινεί μια ικανότητα από την ενεργή λίστα στο Αρχειοθετήθηκε. Μια αρχειοθετημένη ικανότητα δεν μετράει πια στον αριθμό που χωράει το πλάνο του χώρου εργασίας, γεγονός που το κάνει τρόπο να ελευθερώσετε χώρο κάτω από ένα όριο.

  • Μόνο το άτομο που έφτιαξε την ικανότητα μπορεί να την αρχειοθετήσει. Για οποιονδήποτε άλλον η απάντηση είναι απόρριψη που λέει ότι η λειτουργία δεν επιτρέπεται.
  • Μια ικανότητα που έχετε κοινοποιήσει σε άλλους απορρίπτεται όσο η κοινοποίηση είναι ενεργή. Τερματίστε πρώτα την κοινοποίηση.
  • Το conversation_id είναι προαιρετικό. Μαζί του, αρχειοθετείται μόνο εκείνη η συνομιλία της ικανότητας. Χωρίς αυτό, αρχειοθετούνται μαζί της όλες οι συνομιλίες της ικανότητας.

Η επαναφορά μιας ικανότητας ή η οριστική διαγραφή της γίνεται στο dashboard, από την προβολή Αρχειοθετήθηκε.

Δημιουργία εικόνας

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

Επιτρέψτε σε μια εγκατεστημένη ικανότητα να χρησιμοποιεί τα εργαλεία του εκδότη της

Το set_agent_tool_consent καταγράφει αν επιτρέπετε σε μια εγκατεστημένη ικανότητα να χρησιμοποιεί εργαλεία plugin που τρέχουν στον χώρο εργασίας του εκδότη της. Ό,τι δημιουργούν αυτά τα εργαλεία αποθηκεύεται στο drive του εκδότη και όχι στο δικό σας. Δέχεται τα agent_id και granted, true για να επιτρέψετε και false για να ανακαλέσετε, και προαιρετικά το owner_uid, τον λογαριασμό του εκδότη. Καταγράφει πάντα μόνο τη δική σας απόφαση, ποτέ κάποιου άλλου.

Ο αριθμός μιας ικανότητας και το πλάνο της

Οι ικανότητες μετριούνται με το πλάνο του χώρου εργασίας στον οποίο βρίσκονται. Δείτε τα Πλάνα και χρέωση για το τι μετράει και τι συμβαίνει στο όριο.

Πώς σας φαίνεται αυτός ο οδηγός;

Τελευταία ενημέρωση: 20 Νοεμβρίου 2026