Naar de inhoud springen

Vaardigheden

Wat je AI kan doen, ingepakt.

Vaardigheden openen
Gecontroleerd aan de hand van het dashboard op 20 november 2026

De publieke API heeft zeven methoden voor vaardigheden. De API noemt een vaardigheid nog steeds een AI-agent, dus dat is de naam in elke methode. Ze werken op vaardigheden die al bestaan: ze zetten er een vast, markeren er een als favoriet, archiveren er een, maken er een afbeelding voor en leggen een toestemming vast. Elke methode werkt voor het account waarvan je de API-sleutel gebruikt.

Een vaardigheid maken, er een plannen vanuit je woorden, zijn instructies of tools wijzigen, klonen, installeren vanuit de marktplaats, tonen, delen, uit het archief halen, verwijderen en een abonnement kiezen doe je in het dashboard. Daar is op dit moment geen publieke methode voor.

Stuur een verzoek naar een methode met je sleutel:

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'},
)

Een goed antwoord heeft code 1. Een geweigerd antwoord heeft een negatieve code en zegt in data waarom.

Elke methode neemt de id van de vaardigheid als agent_id, het laatste deel van het adres van de vaardigheid in het dashboard. Behalve set_agent_tool_consent neemt elke methode ook een optionele workspace_id, om in een andere werkruimte te werken dan je eigen hoofdwerkruimte. Je moet die werkruimte bezitten.

Vastzetten en als favoriet markeren

  • pin_ai_agent en unpin_ai_agent zetten een vaardigheid vast en halen de pin weg. Het dashboard krijgt het meteen te horen, dus een geopende pagina toont de wijziging.
  • favorite_ai_agent en unfavorite_ai_agent zetten en wissen de favorietmarkering, het hartje op de kaart van de vaardigheid. Een favoriet is ook wat de keuze Favorieten in het menu Tonen laat zien.

Archiveren

archive_ai_agent verplaatst een vaardigheid van de actieve lijst naar Gearchiveerd. Een gearchiveerde vaardigheid telt niet meer mee voor het aantal dat het abonnement van de werkruimte bevat, waardoor dit een manier is om ruimte te maken onder een limiet.

  • Alleen de persoon die de vaardigheid heeft gemaakt kan hem archiveren. Voor iedereen anders is het antwoord een weigering die zegt dat de bewerking niet is toegestaan.
  • Een vaardigheid die je met anderen hebt gedeeld, wordt geweigerd zolang die deling actief is. Beëindig eerst de deling.
  • conversation_id is optioneel. Daarmee wordt alleen dat ene gesprek van de vaardigheid gearchiveerd. Zonder wordt elk gesprek van de vaardigheid mee gearchiveerd.

Een vaardigheid terugbrengen of definitief verwijderen doe je in het dashboard, in de weergave Gearchiveerd.

Een afbeelding maken

generate_ai_agent_image maakt een nieuwe afbeelding voor een vaardigheid die je bezit en slaat die op bij de vaardigheid. Gebruik het als een vaardigheid geen afbeelding heeft en zijn kaart terugvalt op de plaatsaanduiding. Het draait op de achtergrond, dus de nieuwe afbeelding verschijnt de volgende keer dat de vaardigheid wordt geladen. Het is hetzelfde als Afbeelding genereren in het menu van de kaart.

Een geïnstalleerde vaardigheid de tools van zijn uitgever laten gebruiken

set_agent_tool_consent legt vast of je toestaat dat een geïnstalleerde vaardigheid plugintools gebruikt die draaien in de werkruimte van zijn uitgever. Alles wat die tools maken, wordt opgeslagen in de drive van de uitgever in plaats van in de jouwe. Het neemt agent_id en granted, true om toe te staan en false om in te trekken, en optioneel owner_uid, het account van de uitgever. Het legt altijd alleen je eigen beslissing vast, nooit die van een ander.

De telling van een vaardigheid en zijn abonnement

Vaardigheden worden geteld volgens het abonnement van de werkruimte waarin ze zitten. Zie Abonnementen en facturering voor wat meetelt en wat er bij de limiet gebeurt.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026