UiPath

Genel Bakış

ajan, farklı API'ler ve kimlik doğrulama kullandıkları için iki ayrı UiPath entegrasyonu sunar:

Bir çalışma alanı yöneticisi UiPath için bir OAuth istemcisi ve Automation Hub için bir Open API token yapılandırır. Ardından her entegrasyonu bağımsız bağlarsınız.

Desteklenen dağıtım: Yalnızca UiPath Automation Cloud. Automation Suite ve diğer self-hosted host'lar desteklenmez.

ajan neden paylaşılan bir UiPath OAuth istemcisi sunmaz

UiPath harici OAuth uygulamalarını her organization içinde kaydeder (Admin → External applications → OAuth apps). Bir kuruluşta oluşturulan istemci tüm ajan müşteri kuruluşlarına hizmet edemez.

Bu yüzden ajan, Microsoft veya Google'da olduğu gibi merkezi bir UiPath istemcisi sağlayamaz. Kuruluşunuzdaki bir UiPath yöneticisinin confidential uygulamayı oluşturması, ardından bir ajan çalışma alanı yöneticisinin Application ID ve app secret'ı Kendi OAuth İstemcinizi Getirin sayfasına yapıştırması gerekir.

UiPath (Orchestrator)

Temsilcilerin her oturum açmış kullanıcı adına otomasyonları çalıştırıp izleyebilmesi için Orchestrator'ı bağlayın.

Kimlik Doğrulama: OAuth (kuruluşunuzun confidential uygulaması) Kullanılabilirlik: Tüm çalışma alanı planları

Önkoşullar

• Orchestrator içeren bir UiPath Automation Cloud kuruluşu
• Harici OAuth uygulaması oluşturmak için UiPath yönetici erişimi
• OAuth istemcisini yapılandırmak için ajan çalışma alanı yönetici erişimi
• ajan'ın UiPath entegrasyon ayarlarından Redirect URL ve kapsam listesi

OAuth istemcisini kurma

Bu adımları ajan çalışma alanı başına bir kez tamamlayın (grup kapsamlı istemciler kullanıyorsanız grup istemcisi başına bir kez).

ajan'dan Redirect URL ve kapsamları kopyalayın

[Workspace settings → Integrations] sayfasına gidin(https://app.ajan.com/settings/workspace/products/integrations), UiPath seçin, ardından Configure your OAuth client to use this integration. düğmesine tıklayın.

Redirect URL değerini kopyalayın. Sync scopes with enabled actions açık bırakın, ardından Scopes listesini kopyalayın. UiPath'e geçmeden önce bu iletişim kutusunu açık tutun veya değerleri güvenli bir yere yapıştırın.

Redirect URL'yi ajan'dan tam olarak kopyalayın. Sondaki eğik çizgi, yanlış host veya yazım hatası bağlantı sırasında redirect_uri_mismatch hatasına yol açar.

UiPath'te confidential OAuth uygulaması oluşturun

UiPath Automation Cloud'ta kuruluş Admin → External applications → OAuth apps yolunu açın, ardından Add application düğmesine tıklayın.

Open this from organization Admin → External applications → OAuth apps. Some UiPath pages also describe an Orchestrator Manage Access route, which may not appear in every tenant.

Configure the app as follows:

1. Enter an application name (for example, ajan).
2. Select Confidential application.
3. Click Add scopes, choose the Orchestrator resource, and grant the scopes from ajan under User Scope(s). Leave Application Scope(s) empty for this connection flow.
4. Paste the ajan Redirect URL into the redirect URL field.
5. Save the application.

Store the Application ID (Client ID) and the generated app secret (Client secret). UiPath shows the secret once.

For background on confidential apps and user scopes, see UiPath's OAuth apps overview.

Put Orchestrator scopes under User Scope(s) only. Application scopes are for app-only access and do not match ajan's user-delegated OAuth flow.

İstemciyi ajan'a kaydedin

Back in the ajan OAuth client dialog:

1. Optionally set a Client name and choose Entire workspace or Groups.
2. Paste the UiPath Application ID into Client ID.
3. Paste the UiPath app secret into Client secret with no extra spaces or line breaks.
4. If the dialog shows OAuth connection details, you can save a UiPath Cloud URL as the default for that client, for example https://cloud.uipath.com/acme/DefaultTenant/orchestrator_/.
5. Click Save, confirm, then activate the client from the client list.

For group clients and scope sync behavior, see Bring Your Own OAuth Client and Manage Action-Level Scopes.

Bir UiPath hesabı bağlayın

Open Integrations, select UiPath, and add a connection.

Members paste a UiPath Cloud URL that includes your organization and tenant, for example https://cloud.uipath.com/acme/DefaultTenant/orchestrator_/, unless you already set a default under OAuth connection details. You can also enter just the org name (tenant defaults to DefaultTenant) or org/tenant.

Complete the OAuth consent screen. ajan acts with that user's Orchestrator permissions.

ajan'da UiPath kullanmaya başlayın

Klasör ve süreç listelemek, iş tetiklemek, kuyruk öğesi eklemek veya iş geçmişi ve denetim günlüklerini incelemek için herhangi bir temsilcide entegrasyonu @ ile etiketleyin.

Yaygın kullanım durumları

• Otomasyon çalıştırma — Sohbet veya iş akışlarından Orchestrator işlerini tetikleyin ve kuyruk öğeleri ekleyin
• Süreç keşfi — Kişisel çalışma alanları ve Solution klasörleri dahil klasör ve süreçleri listeleyin
• Çalıştırmaları sorun giderme — İş durumunu kontrol edin, iş ayrıntıları ve yürütme günlüklerini alın, hatalı işleri inceleyin
• Denetim etkinliği — İşleri, kuyrukları veya diğer bileşenleri kimin değiştirdiğini görmek için Orchestrator denetim günlüklerini okuyun

Sorun giderme

UiPath Automation Hub

Temsilcilerin otomasyon fikirlerini ve pipeline bağlamını keşfedebilmesi için Automation Hub'ı bağlayın. Görünürlük, Open API token kullanıcısının Automation Hub rolleri ve kategori erişimini izler.

Kimlik Doğrulama: API Key (kişisel veya kullanıcıya atanmış Open API token) Kategori: Knowledge Base Kullanılabilirlik: Tüm çalışma alanı planları

Önkoşullar

• A UiPath Automation Cloud organization with Automation Hub enabled
• Access to Admin Console → Platform Setup → Open API to create or copy a token
• A personal or user-assigned Open API token (tenant-level tokens cannot search automations)

Kurulum

Automation Hub Cloud URL'nizi kopyalayın

Open Automation Hub in the browser and copy the URL. A typical shape is https://cloud.uipath.com/mycompany/DefaultTenant/automationhub_/.... ajan extracts the organization and tenant from this URL. You can also enter just the org name (tenant defaults to DefaultTenant) or org/tenant.

Only UiPath Automation Cloud URLs are accepted. Automation Suite and other self-hosted hosts are rejected.

Kişisel bir Open API token oluşturun

In Automation Hub go to Admin Console → Platform Setup → Open API, then create or select a personal or user-assigned token. Use Copy to Clipboard next to the token so you get the combined Tenant ID/Token value.

Follow UiPath's token guide for the exact UI steps. If you set an App key when creating the token, copy that as well.

ajan'da Entegrasyonlara gidin

Go to Integrations and find UiPath Automation Hub.

Kimlik bilgilerinizi girin

Paste the UiPath Cloud URL, the Open API credential (Tenant ID/Token), and the App key if you created one. Leave App key empty otherwise.

ajan'da Automation Hub kullanmaya başlayın

Tag the integration with @ in any agent to search ideas, look up pipeline context, or browse categories and applications.

İzinler ve token yönetimi

Microsoft veya Google entegrasyonlarının aksine Automation Hub, kullanıcı başına temsil edilen OAuth desteklemez. Bunun ne anlama geldiğini ve token'ları güvenli yönetmeyi anlamak için bu bölümü kullanın.

İzin türlerini anlama

ajan uses the token user's Automation Hub rights. Every request runs as the user assigned to the Open API token (category access plus role permissions). ajan does not add its own privacy layer, and it does not strip privileged fields.

Automation Hub's Open API authenticates with a static token that an Automation Hub admin creates in Admin Console → Platform Setup → Open API. There is no per-user consent flow in ajan. Whoever uses the connected token sees what that Automation Hub user can already see in the UI.

If the token user can view cost-benefit analysis, collaborators, or detailed assessment data in Automation Hub, those ajan actions can return it whenever they are enabled.

Önerilen kurulum

Create separate connections for regular catalog access and for privileged CoE work. Do not reuse a high-privilege CoE token as the default connection for everyone.

flowchart LR
  subgraph AH["Automation Hub"]
    RU["Dedicated regular userlimited roles + categories"]
    COE["CoE / privileged userbroader AH rights"]
  end
  subgraph LD["ajan"]
    C1["Catalog connection"]
    C2["CoE connection"]
    A1["Shared or agent-fixedfor regular users"]
    A2["CoE-only agentsor workflows"]
  end
  RU -->|personal / user-assigned token| C1 --> A1
  COE -->|separate token| C2 --> A2

Düzenli kullanıcı katalog bağlantısı

1. Create an Automation Hub user whose roles and category access match what regular ajan users should be allowed to see.
2. Grant only the permissions needed for search and basic idea detail. Skip CBA, collaborator, and detailed assessment permissions unless they are deliberately in scope.
3. Generate a personal or user-assigned Open API token for that user (not a tenant-level token).
4. Connect it in ajan, then either:
   • Share the connection with the people or groups who should use the catalog (Sharing Non-OAuth Connections Directly), or
   • Preselect it on an agent as a fixed connection (Using shared connections in agent actions).

Either option keeps visibility bounded to the dedicated user's Automation Hub rights. That is the strongest limited-view pattern the API allows.

CoE bağlantısı

Separately, the Center of Excellence (or another privileged team) can create their own Open API token for a user with broader Automation Hub permissions. Keep that connection on CoE-only agents or workflows.

Sınırlı bir token'ın görebilecekleri

Her eylemin döndürebilecekleri

Polling triggers (New automation idea, Updated automation idea) inherit the same visibility: they only see ideas the token user can already access.

For a regular-user catalog connection, enable the catalog actions you need and leave privileged options off unless required: Get cost-benefit analysis, Include collaborators, and Include advanced assessment.

Yaygın kullanım durumları

• Fikir keşfi — Otomasyon fikirlerini metin, aşama, durum, kategori veya uygulamaya göre arayın
• Pipeline bağlamı — Bir fikrin geçerli aşamasını ve durumunu, dokunduğu kategori ve uygulamaları bulun
• Taksonomi gezinme — Fikirlerin nasıl düzenlendiğini anlamak için kategori ve uygulamaları listeleyin
• Değişiklik sinyalleri — Token kullanıcısının görünürlüğünde fikirler oluşturulduğunda veya güncellendiğinde iş akışlarını tetikleyin

Sorun giderme