İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

API anahtarlarıyla agent paylaşma

ajan'da API anahtarı oluşturmayı ve programatik erişim için bir agent'ı onunla paylaşmayı öğrenin.

Başlamadan önce

  • API key: Bir admin'in API anahtarını oluşturması ve agent'ı onunla paylaşması gerekir. Admin değilseniz, "Share" düğmesiyle agent'ınıza bir admin'i editor olarak davet edin.
  • Agents API: Bu, yerel Vercel AI SDK uyumluluğuna sahip Agents API'dir.

API anahtarı nasıl oluşturulur

  1. ajan uygulamasına gidin ve açılır menüden workspace ayarlarını açın.
  1. Kenar çubuğunda Products altında API'ye tıklayın.
  1. Create API key'e tıklayın, bir ad girin, gerekli kapsamları seçin (en az "Assistant API") ve onaylayın.
  1. API anahtarınızı kopyalayın ve güvenli saklayın. Tekrar görüntüleyemezsiniz.

Workspace API anahtarı bir service account olarak çalışır. Bir agent ile kullandığınızda araçlar, oluşturanın kişisel bağlantıları yerine önceden seçilmiş bir bağlantıyı veya bu anahtarla paylaşılan bir bağlantıyı kullanır.

Agent'ı API anahtarıyla paylaşma

  1. Kenar çubuğunda Agents'a gidin.
  1. Yeni bir agent oluşturun veya mevcut birini seçin. Yeni agent için Agent Builder sohbeti açılır. Agent'ı doğal dilde tanımlayın veya agent editöründe elle yapılandırmak için Go to editor'e tıklayın.
  2. Agent editöründe sağ üstteki Share düğmesine tıklayın.
  1. Paylaşım diyaloğu açılır ve mevcut erişim ayarlarını gösterir.
  1. API anahtarınızı ada göre arayın ve agent'ı API ile paylaşmak için ekleyin.

Yalnızca admin'ler bir agent'ı API anahtarıyla bağlayabilir. Paylaşım menüsünde API anahtarlarını görmüyorsanız, bu adımı bir admin'in gerçekleştirmesini isteyin.

Paylaştığınız agent'a subagents bağlıysa, her subagent'ı da API anahtarıyla paylaşın. Anahtarla paylaşılmayan subagent'lar, agent onları API üzerinden çağırdığında erişim reddedildi mesajı döndürür.

API bağlantısını test etme

Paylaşıldıktan sonra agent'ınızı Agent API documentation üzerinden test edebilirsiniz. API anahtarınızı ve URL'deki agent ID'yi kullanın (https://app.ajan.com/agents/AGENT_ID/edit).

ajan, API anahtarınızı korumak için tarayıcı kaynaklı istekleri engeller. Daha fazla bilgi için API Key Best Practices kılavuzuna bakın.

Using MCP: Agent'larınıza ajan MCP Server üzerinden de erişebilirsiniz. Bu, MCP uyumlu AI istemcilerinin (Claude Desktop veya Cursor gibi) agent'larınızı doğrudan çağırmasını sağlar.