İçeriğe geç

Beceriler

AI'nızın yapabilecekleri, paketlenmiş halde.

Beceriler aç
20 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

Herkese açık API'de beceriler için yedi yöntem vardır. API hâlâ bir beceriye yapay zekâ ajanı der; bu yüzden her yöntemde bu ad geçer. Zaten var olan becerilerle çalışırlar: birini sabitler, favoriye ekler, arşivler, ona resim üretir ve bir onayı kaydederler. Her biri, API anahtarını kullandığınız hesap adına çalışır.

Bir beceri oluşturma, sözlerinizden plan yapma, talimatlarını veya araçlarını değiştirme, kopyalama, Marketplace'ten yükleme, listeleme, paylaşma, arşivden çıkarma, silme ve plan seçme dashboard'da yapılır. Bugün bunların herkese açık bir yöntemi yoktur.

Anahtarınızla bir yönteme istek gönderin:

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

İyi bir yanıtın code değeri 1'dir. Reddedilen bir yanıtın code değeri negatiftir ve nedenini data içinde söyler.

Her yöntem, becerinin kimliğini agent_id olarak alır; bu, becerinin dashboard'daki adresinin son kısmıdır. set_agent_tool_consent dışında her biri, kendi ana çalışma alanınızdan başka bir çalışma alanında işlem yapmak için isteğe bağlı bir workspace_id de alır. O çalışma alanının sahibi olmalısınız.

Sabitleme ve favoriye ekleme

  • pin_ai_agent ve unpin_ai_agent bir beceriyi sabitler ve sabitlemeyi kaldırır. Dashboard'a hemen haber verilir, böylece açık bir sayfa değişikliği gösterir.
  • favorite_ai_agent ve unfavorite_ai_agent, becerinin kartındaki kalp olan favori işaretini koyar ve kaldırır. Favori, Göster menüsündeki Favoriler seçeneğinin de listelediği şeydir.

Arşivleme

archive_ai_agent bir beceriyi etkin listeden çıkarıp Arşivlendi'ye taşır. Arşivlenen bir beceri, çalışma alanının planının tuttuğu sayıya artık sayılmaz; bu da bir sınırın altında yer açmanın bir yoludur.

  • Beceriyi yalnızca onu yapan kişi arşivleyebilir. Başkası için yanıt, işleme izin verilmediğini söyleyen bir redtir.
  • Başkalarıyla paylaştığınız bir beceri, paylaşım etkin olduğu sürece reddedilir. Önce paylaşımı sonlandırın.
  • conversation_id isteğe bağlıdır. Verilirse becerinin yalnızca o sohbeti arşivlenir. Verilmezse becerinin tüm sohbetleri onunla birlikte arşivlenir.

Bir beceriyi geri getirmek veya kalıcı olarak silmek, dashboard'da Arşivlendi görünümünden yapılır.

Resim üretme

generate_ai_agent_image, sahibi olduğunuz bir beceri için yeni bir resim üretir ve onu beceriye kaydeder. Bir becerinin resmi yoksa ve kartı yer tutucuya dönüyorsa kullanın. Arka planda çalışır; bu yüzden yeni resim, beceri bir sonraki yüklendiğinde görünür. Kartın menüsündeki Görsel oluştur ile aynı şeydir.

Yüklü bir becerinin yayıncısının araçlarını kullanmasına izin verme

set_agent_tool_consent, yüklü bir becerinin, yayıncısının çalışma alanında çalışan eklenti araçlarını kullanmasına izin verip vermediğinizi kaydeder. Bu araçların oluşturduğu her şey sizin sürücünüzde değil, yayıncının sürücüsünde saklanır. agent_id ve granted (izin vermek için true, geri çekmek için false) alır; isteğe bağlı olarak yayıncının hesabı olan owner_uid da alır. Yalnızca sizin kendi kararınızı kaydeder, hiçbir zaman başkasınınkini değil.

Bir becerinin sayısı ve planı

Beceriler, içinde bulundukları çalışma alanının planına göre sayılır. Neyin sayıldığı ve sınırda ne olduğu için Planlar ve faturalandırma sayfasına bakın.

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026