Przejdź do treści

Umiejętności

To, co potrafi Twoje AI, w gotowych pakietach.

Otwórz Umiejętności
Sprawdzono z pulpitem dnia 20 listopada 2026

Publiczne API ma siedem metod dla umiejętności. API nadal nazywa umiejętność agentem AI, więc taka nazwa jest w każdej metodzie. Działają na umiejętnościach, które już istnieją: przypinają jedną, oznaczają jako ulubioną, archiwizują, tworzą jej obrazek i zapisują zgodę. Każda działa dla konta, którego klucza API używasz.

Tworzenie umiejętności, planowanie jej na podstawie Twoich słów, zmiana jej instrukcji lub narzędzi, klonowanie, instalowanie z marketplace, wystawianie, udostępnianie, przywracanie z archiwum, usuwanie i wybór planu odbywają się w dashboardzie. Dziś nie mają metody publicznej.

Wyślij żądanie do metody ze swoim kluczem:

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

Dobra odpowiedź ma code 1. Odrzucona ma ujemny code i w data mówi dlaczego.

Każda metoda przyjmuje identyfikator umiejętności jako agent_id, czyli ostatnią część adresu umiejętności w dashboardzie. Poza set_agent_tool_consent każda przyjmuje też opcjonalne workspace_id, by działać w innej przestrzeni roboczej niż Twoja domowa. Ta przestrzeń musi należeć do Ciebie.

Przypinanie i oznaczanie jako ulubione

  • pin_ai_agent i unpin_ai_agent przypinają umiejętność i zdejmują przypięcie. Dashboard dostaje o tym od razu informację, więc otwarta strona pokazuje zmianę.
  • favorite_ai_agent i unfavorite_ai_agent ustawiają i zdejmują oznaczenie ulubionej, czyli serce na karcie umiejętności. Ulubione to także to, co wyświetla wybór Ulubione w menu Pokaż.

Archiwizowanie

archive_ai_agent przenosi umiejętność z aktywnej listy do Zarchiwizowano. Zarchiwizowana umiejętność nie wlicza się już do liczby, którą mieści plan przestrzeni roboczej, co jest sposobem na zrobienie miejsca pod limitem.

  • Zarchiwizować umiejętność może tylko osoba, która ją zrobiła. Dla kogokolwiek innego odpowiedzią jest odmowa mówiąca, że operacja nie jest dozwolona.
  • Umiejętność, którą udostępniłeś innym, jest odrzucana, dopóki to udostępnienie jest aktywne. Najpierw zakończ udostępnianie.
  • conversation_id jest opcjonalne. Z nim archiwizowana jest tylko ta jedna rozmowa umiejętności. Bez niego archiwizowane są razem z nią wszystkie jej rozmowy.

Przywracanie umiejętności lub usuwanie jej na dobre odbywa się w dashboardzie, z widoku Zarchiwizowano.

Tworzenie obrazka

generate_ai_agent_image tworzy nowy obrazek dla jednej Twojej umiejętności i zapisuje go w niej. Użyj go, gdy umiejętność nie ma obrazka, a jej karta wraca do zastępczego. Działa w tle, więc nowy obrazek pojawia się przy następnym załadowaniu umiejętności. To to samo co Generuj obraz w menu karty.

Zezwól zainstalowanej umiejętności na używanie narzędzi jej wydawcy

set_agent_tool_consent zapisuje, czy pozwalasz zainstalowanej umiejętności używać narzędzi wtyczek, które działają w przestrzeni roboczej jej wydawcy. Wszystko, co te narzędzia tworzą, jest przechowywane na dysku wydawcy, a nie na Twoim. Przyjmuje agent_id i granted, true by zezwolić i false by wycofać, oraz opcjonalnie owner_uid, czyli konto wydawcy. Zapisuje zawsze tylko Twoją własną decyzję, nigdy cudzą.

Liczba umiejętności i plan

Umiejętności są liczone według planu przestrzeni roboczej, w której są. Co się wlicza i co dzieje się przy limicie, znajdziesz w Plany i rozliczenia.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026