# Yapay zekâ bağlantıları (https://docs.akollo.com/tr/ai/connections)



## Nedir [#nedir]

Akollo’nun yapay zekâ özellikleri varsayılan olarak Akollo’nun sağladığı modellerle çalışır. Kurum yöneticisi
isterse bir yapay zekâ sağlayıcısını kurumunuzun kendi anahtarıyla bağlayabilir (“kendi anahtarınızı getirin”) ve
o sağlayıcının hangi modelinin hangi işi yapacağını belirleyebilir.

Desteklenen sağlayıcılar: OpenRouter, Anthropic, OpenAI, Google AI, Azure OpenAI, Amazon Bedrock ve Google Vertex AI.
Bunlara ek olarak kendi model sunucunuzu doğrudan ya da Yapay Zekâ Bağlayıcısı üzerinden bağlayabilirsiniz.

<Mermaid
  title="Bir yapay zekâ isteği nereye gider"
  chart="`flowchart LR
A[Akollo’daki yapay zekâ özelliği] --> B{Bu iş için seçilen model}
B -->|Varsayılan| C[Akollo’nun sağladığı modeller]
B -->|Etkin bağlantı| D{Bu veriye bağlantıda izin var mı?}
D -->|Evet| E[Sağlayıcınız ya da model sunucunuz]
D -->|Kısıtlı veri| F[Kurumun kendi sunucusunda kalır]`"
/>

## Bağlantı ekleme [#bağlantı-ekleme]

<Steps>
  <Step>
    ### Bağlantılar sayfasını açın [#bağlantılar-sayfasını-açın]

    **Ayarlar › Yapay zekâ › Bağlantılar** sayfasına gidin.
  </Step>

  <Step>
    ### Sağlayıcıyı ve anahtarı girin [#sağlayıcıyı-ve-anahtarı-girin]

    **Bağlantı ekleyin** bölümünde **Sağlayıcı** alanından sağlayıcıyı seçin, bağlantıya bir **Ad** verin ve **API
    anahtarı** alanına anahtarı yapıştırın. Azure OpenAI ve Vertex AI için sağlayıcınızın verdiği **Adres** bilgisini,
    Amazon Bedrock için de **Bölge** bilgisini (örneğin eu-central-1) girin.
  </Step>

  <Step>
    ### Bağlantıdan geçebilecek veriyi seçin [#bağlantıdan-geçebilecek-veriyi-seçin]

    **İzin verilen veri** alanında bir düzey seçin: **Yalnızca herkese açık veri**, **Kuruma özel veriye kadar** ya da
    **Gizli veriye kadar**. En hassas (kısıtlı) veriler hiçbir koşulda dışarıdaki bir sağlayıcıya gönderilmez; kısıtlı
    olarak işaretlenen bilgiler kurumun kendi sunucusunda kalır. Ardından **Bağlantıyı ekle** düğmesine basın.
  </Step>
</Steps>

| Veri düzeyi  | Dışarıdaki bir bağlantıdan geçebilir mi?                                  |
| ------------ | ------------------------------------------------------------------------- |
| Herkese açık | Evet, her düzeyde                                                         |
| Kuruma özel  | Evet; **Kuruma özel veriye kadar** ya da **Gizli veriye kadar** seçiliyse |
| Gizli        | Evet; yalnızca **Gizli veriye kadar** seçiliyse                           |
| Kısıtlı      | Hayır, hiçbir zaman. Kurumun kendi sunucusunda kalır                      |

<Callout type="info" title="Not">
  Anahtar şifrelenmiş olarak saklanır ve yöneticiler dahil hiç kimseye bir daha gösterilmez. Anahtarı değiştirmek için
  **Anahtarı değiştir** düğmesini kullanın, ardından bağlantıyı yeniden deneyin.
</Callout>

## Deneme ve etkinleştirme [#deneme-ve-etkinleştirme]

<Steps>
  <Step>
    ### Modelleri bulun [#modelleri-bulun]

    **Modelleri bul**, anahtarınızın erişebildiği modelleri listeler.
  </Step>

  <Step>
    ### Bir modeli deneyin [#bir-modeli-deneyin]

    **Dene**, seçtiğiniz modelde kısa bir denetim yürütür: Türkçe yanıt, yapılandırılmış yanıt ve araç kullanımı.
    Bağlantı ancak bu denetimden geçerse etkinleştirilebilir.
  </Step>

  <Step>
    ### Etkinleştirin [#etkinleştirin]

    **Etkinleştir** bağlantıyı devreye alır. Canlı kurumlarda etkinleştirmeyi aynı sayfada başka bir yöneticinin
    onaylaması gerekir. Onay verilene kadar bağlantı **İkinci yönetici onayı bekleniyor** durumunda kalır.
    Diğer yönetici **Etkinleştirmeyi onayla** ya da **Reddet** seçeneğini kullanır. İsteği yapan kişi kendi isteğini
    onaylayamaz.
  </Step>
</Steps>

<Mermaid
  title="Bağlantı durumu"
  chart="`flowchart LR
A[Taslak] -->|Deneme geçti, Etkinleştir| B{Canlı kurum mu?}
B -->|Hayır| D[Etkin]
B -->|Evet| C[İkinci yönetici onayı bekleniyor]
C -->|Etkinleştirmeyi onayla| D
C -->|Reddet| F[Etkinleştirilmedi]
D -->|Kapat| E[Kapatıldı]`"
/>

| Durum                                | Anlamı                                                                             |
| ------------------------------------ | ---------------------------------------------------------------------------------- |
| **Taslak**                           | Bağlantı eklendi, henüz etkin değil. Modelleri bulma ve deneme bu aşamada yapılır. |
| **İkinci yönetici onayı bekleniyor** | Canlı bir kurumda etkinleştirme istendi; kararı başka bir yönetici verir.          |
| **Etkin**                            | Bağlantı kullanımda. Denemede bulunan modeller işlere atanabilir.                  |
| **Kapatıldı**                        | Bağlantı kalıcı olarak kapatıldı.                                                  |

## Kendi model sunucunuz [#kendi-model-sunucunuz]

Kurumunuz kendi model sunucusunu işletiyorsa (örneğin llama.cpp ya da vLLM) sunucuyu HTTPS adresiyle **Kendi model
sunucunuz** olarak ekleyin. Anahtar girmek isteğe bağlıdır.

* Adres, kurulumunuzun izin verilen hedefler listesinde yer almalıdır.
* Kurulum ilgili sunucuya izin vermedikçe Akollo özel ya da ayrılmış adreslere hiçbir zaman bağlanmaz.
* Bulut kurulumunda, kurumun özel ağındaki bir adres dış bağlantı olarak kabul edilmez. Bu durumda Yapay Zekâ
  Bağlayıcısını kullanın.

## Yapay Zekâ Bağlayıcısı [#yapay-zekâ-bağlayıcısı]

Model sunucusu kapalı bir ağdaysa **Yapay Zekâ Bağlayıcısı**nı kullanın. Bağlayıcı, model sunucusunun yanında çalışan
ve Akollo’ya dışarı doğru bağlanan küçük bir programdır; içeri doğru bir bağlantı açmanız gerekmez.

<Steps>
  <Step>
    ### Bağlayıcıyı tanımlayın [#bağlayıcıyı-tanımlayın]

    **Yapay Zekâ Bağlayıcısı ekleyin** bölümünde bağlayıcıya bir ad verin.
  </Step>

  <Step>
    ### Belirteci kopyalayın [#belirteci-kopyalayın]

    Ekranda görünen belirteci kopyalayın. Belirteç yalnızca bir kez gösterilir.
  </Step>

  <Step>
    ### Bağlayıcıyı başlatın [#bağlayıcıyı-başlatın]

    Bağlayıcıyı model sunucunuzun yanında bu belirteçle başlatın. Bağlantı kartında bağlayıcının çevrim içi olup olmadığı
    görünür.
  </Step>
</Steps>

<Mermaid
  title="Yapay Zekâ Bağlayıcısı: yalnızca dışarı doğru bağlantı"
  chart="`flowchart LR
subgraph Kapalı ağ
M[Model sunucusu] --- K[Yapay Zekâ Bağlayıcısı]
end
K -->|Belirteciyle dışarı bağlanır| A[Akollo]`"
/>

<Callout type="warn" title="Dikkat">
  **Yeni belirteç** mevcut belirtecin yerine yenisini üretir. Eski belirteç hemen geçersiz olur; bağlayıcıyı yeni
  belirteçle yeniden başlatın.
</Callout>

## İşlere model seçme [#i̇şlere-model-seçme]

**Hangi model hangi işi yapsın** bölümünde her iş için ya Akollo’nun sağladığı modelleri ya da etkin bir bağlantının
modelini seçin ve **Kaydet** düğmesine basın. İşler şunlardır:

* **Yönlendirme**
* **Güvenlik denetimi**
* **Günlük yanıtlar**
* **Planlama ve karmaşık işler**
* **Arama**

Yalnızca etkin bağlantılar ve bu bağlantıların denemesinde bulunan modeller seçilebilir. Siz bir bağlantı ekleyene
kadar yapay zekâ Akollo’nun sağladığı modellerle çalışır.

## Maliyet [#maliyet]

Kendi bağlantınız üzerinden yapılan istekleri sağlayıcı doğrudan size faturalar. Bu istekler kurumunuzun Akollo
yapay zekâ token’larından düşülmez.

<Screenshot src="/screens/tr/settings-usage.webp" alt="Yapay zekâ girdi token’ları ölçümünün seçili olduğu Kullanım sayfası ve bütçe alanı" caption="Kullanım: Akollo yapay zekâ token’ları burada ölçülür. Kendi bağlantınızdan geçen istekler bu ölçüme yansımaz." />

## Bağlantıyı kapatma [#bağlantıyı-kapatma]

**Kapat** bağlantıyı kalıcı olarak devre dışı bırakır. Bu bağlantıyı kullanan işler Akollo’nun sağladığı modellere
geri döner.

## Bağlantıları kimler yönetebilir [#bağlantıları-kimler-yönetebilir]

Kurum sahipleri ve yöneticiler. Her değişiklik, kimin ve ne zaman yaptığıyla birlikte kayda geçer. Destek
oturumunda bağlantılar görüntülenebilir ancak değiştirilemez.

## Sık sorulan sorular [#sık-sorulan-sorular]

<Accordions type="single">
  <Accordion title="Kaydettiğim API anahtarını yeniden görebilir miyim?">
    Hayır. Anahtar şifrelenmiş olarak saklanır ve yöneticiler dahil kimseye bir daha gösterilmez. Değiştirmek için
    **Anahtarı değiştir** düğmesini kullanın.
  </Accordion>

  <Accordion title="Kısıtlı veriler kendi sağlayıcımıza gönderilebilir mi?">
    Hayır. Kısıtlı veriler hiçbir zaman dışarıdaki bir sağlayıcıya gitmez; kurumun kendi sunucusunda kalır.
  </Accordion>

  <Accordion title="Bağlantıyı neden etkinleştiremiyorum?">
    Bağlantının önce **Dene** denetiminden geçmesi gerekir. Canlı kurumlarda ayrıca ikinci bir yöneticinin
    etkinleştirmeyi onaylaması gerekir; isteği yapan kişi bu onayı veremez.
  </Accordion>

  <Accordion title="Kendi bağlantımızdan geçen istekler yapay zekâ token’larımızdan düşer mi?">
    Hayır. Bu istekleri sağlayıcı doğrudan size faturalar; kurumunuzun Akollo yapay zekâ token’ları kullanılmaz.
  </Accordion>

  <Accordion title="Bir bağlantıyı kapattığımda ne olur?">
    Bağlantı kalıcı olarak kapanır ve onu kullanan işler Akollo’nun sağladığı modellere döner.
  </Accordion>

  <Accordion title="Model sunucumuz kapalı ağda. İçeri doğru bir bağlantı noktası açmamız gerekir mi?">
    Hayır. Yapay Zekâ Bağlayıcısı model sunucusunun yanında çalışır ve Akollo’ya dışarı doğru bağlanır.
  </Accordion>
</Accordions>

## İlgili sayfalar [#i̇lgili-sayfalar]

* [Kim kullanabilir, yapay zekâ token’ları](/tr/ai/access-and-tokens)
* [Modeli kurumda çalıştırmak](/tr/ai/on-prem)
* [Yardım neyi görür](/tr/ai/privacy)