Přeskočit na obsah

Dovednosti

Co umí vaše AI, zabalené.

Otevřít Dovednosti
Ověřeno podle nástěnky dne 20. listopadu 2026

Veřejné API má pro dovednosti sedm metod. API dovednost stále nazývá AI agent, proto je to název v každé metodě. Působí na dovednosti, které už existují: připnou jednu, označí ji jako oblíbenou, archivují ji, vytvoří pro ni obrázek a zaznamenají souhlas. Každá jedná za účet, jehož klíč API použijete.

Vytvoření dovednosti, její naplánování z vašich slov, změna jejích pokynů nebo nástrojů, klonování, instalace z tržiště, výpis, sdílení, obnovení z archivu, smazání a volba tarifu se dělají v dashboardu. Dnes pro ně neexistuje veřejná metoda.

Pošlete požadavek metodě se svým klíčem:

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

Dobrá odpověď má code 1. Odmítnutá má záporný code a v data říká proč.

Každá metoda bere id dovednosti jako agent_id, což je poslední část adresy dovednosti v dashboardu. Kromě set_agent_tool_consent bere každá také volitelné workspace_id, aby jednala v jiném pracovním prostoru než ve vašem domovském. Ten pracovní prostor musíte vlastnit.

Připnutí a označení jako oblíbené

  • pin_ai_agent a unpin_ai_agent dovednost připnou a připnutí odeberou. Dashboard se to dozví okamžitě, takže otevřená stránka změnu ukáže.
  • favorite_ai_agent a unfavorite_ai_agent nastaví a zruší značku oblíbené, srdce na kartě dovednosti. Oblíbené je také to, co vypisuje volba Oblíbené v nabídce Zobrazit.

Archivace

archive_ai_agent přesune dovednost z aktivního seznamu do Archivováno. Archivovaná dovednost se už nepočítá do počtu, který tarif pracovního prostoru pojme, takže je to způsob, jak udělat místo pod limitem.

  • Dovednost může archivovat jen ten, kdo ji vytvořil. Pro kohokoli jiného je odpovědí odmítnutí, které říká, že operace není povolena.
  • Dovednost, kterou jste sdíleli s jinými, se odmítne, dokud je sdílení aktivní. Nejdřív sdílení ukončete.
  • conversation_id je volitelné. S ním se archivuje jen ta jedna konverzace dovednosti. Bez něj se archivují všechny konverzace dovednosti spolu s ní.

Vrácení dovednosti nebo její trvalé smazání se dělá v dashboardu, ze zobrazení Archivováno.

Vytvoření obrázku

generate_ai_agent_image vytvoří nový obrázek pro jednu dovednost, kterou vlastníte, a uloží jej k dovednosti. Použijte jej, když dovednost nemá obrázek a její karta spadne na zástupný. Běží na pozadí, takže nový obrázek se objeví při příštím načtení dovednosti. Je to totéž jako Vygenerovat obrázek v nabídce karty.

Povolení nainstalované dovednosti používat nástroje jejího vydavatele

set_agent_tool_consent zaznamenává, zda nainstalované dovednosti povolujete používat nástroje pluginů, které běží v pracovním prostoru jejího vydavatele. Cokoli tyto nástroje vytvoří, se ukládá na disk vydavatele, ne na váš. Bere agent_id a granted, true pro povolení a false pro odvolání, a volitelně owner_uid, účet vydavatele. Zaznamenává vždy jen vaše vlastní rozhodnutí, nikdy cizí.

Počet dovedností a jejich tarif

Dovednosti se počítají podle tarifu pracovního prostoru, ve kterém jsou. Co se počítá a co se děje na limitu, najdete v Tarifech a fakturaci.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026