---
title: "Minds API"
description: "Özel yapılandırmalar ve kişiliklerle AI mind'ları programatik olarak oluşturun ve yönetin."
---

# Minds API

AI mind'ları (ajanlar) programatik olarak oluşturun ve yönetin. Mind'lar, belirli uzmanlık, kişilik ve bilgiye sahip özelleştirilebilir AI asistanlardır.

**Base URL:** `https://getminds.ai/api/v1` veya `https://api.getminds.ai/v1`

## Mind Al

System prompt, paylaşım ayarları ve bilgi öğesi sayısı dahil olmak üzere tam ayrıntılarla tek bir mind alın.

**Endpoint:** `GET /api/v1/minds/{mindId}`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
```

### Yanıt

```json
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Marketing Expert",
    "description": "Experienced marketing director",
    "type": "expert",
    "discipline": "Marketing",
    "systemPrompt": "## Core Identity & Personality\n\nYou are a seasoned marketing director...",
    "tags": ["marketing", "b2b"],
    "isPublic": false,
    "isLinkSharingEnabled": false,
    "publicShareId": null,
    "profileImageUrl": "https://...",
    "phoneNumber": null,
    "clonedVoiceStatus": null,
    "profitSplitOptIn": false,
    "createdAt": "2025-12-10T12:00:00.000Z",
    "updatedAt": "2025-12-10T12:00:00.000Z",
    "knowledgeItemCount": 12
  }
}
```

### Yanıt Alanları

<table>
<thead>
  <tr>
    <th>
      Alan
    </th>
    
    <th>
      Tip
    </th>
    
    <th>
      Açıklama
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        id
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Benzersiz mind tanımlayıcısı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        name
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Mind adı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        description
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Mind açıklaması
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        type
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        creative
      </code>
      
      , <code>
        expert
      </code>
      
       veya <code>
        user
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        discipline
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Uzmanlık alanı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        systemPrompt
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Mind'ın davranışını tanımlayan tam system prompt
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        tags
      </code>
    </td>
    
    <td>
      array
    </td>
    
    <td>
      Kategorilendirme etiketleri
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        isPublic
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Mind'ın herkese açık erişilebilir olup olmadığı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        isLinkSharingEnabled
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Bağlantı paylaşımının etkin olup olmadığı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        publicShareId
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Public erişim için paylaşım ID'si (paylaşılmadıysa null)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        profileImageUrl
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Avatar resim URL'i
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        phoneNumber
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      İlişkili telefon numarası (yoksa null)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        clonedVoiceStatus
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Ses klonlama durumu (klonlanmadıysa null)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        profitSplitOptIn
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Kar paylaşımının etkin olup olmadığı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        knowledgeItemCount
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      Ekli bilgi öğelerinin sayısı
    </td>
  </tr>
</tbody>
</table>

### Örnek İstek

```bash
curl -X GET "https://getminds.ai/api/v1/minds/{mindId}" \
  -H "Authorization: Bearer minds_your_api_key"
```

### Hata Yanıtları

**400 Bad Request** - Geçersiz mind ID formatı

**401 Unauthorized** - Geçersiz veya eksik API key

**403 Forbidden** - Bu mind'a erişim yok

**404 Not Found** - Mind mevcut değil

---

## Mind'ları Listele

Kimliği doğrulanmış kullanıcıya ait tüm mind'ları al.

**Endpoint:** `GET /api/v1/minds`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
```

### Sorgu Parametreleri

<table>
<thead>
  <tr>
    <th>
      Parametre
    </th>
    
    <th>
      Tip
    </th>
    
    <th>
      Varsayılan
    </th>
    
    <th>
      Açıklama
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        search
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      —
    </td>
    
    <td>
      Mind'ları ada, açıklamaya veya disipline göre filtrele (büyük/küçük harf duyarsız)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        limit
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      100
    </td>
    
    <td>
      Döndürülecek maksimum mind sayısı (1–100)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        offset
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      0
    </td>
    
    <td>
      Sayfalama için atlanacak mind sayısı
    </td>
  </tr>
</tbody>
</table>

### Yanıt

```json
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Marketing Expert",
      "description": "Experienced marketing director",
      "type": "expert",
      "discipline": "Marketing",
      "tags": ["marketing", "b2b"],
      "profileImageUrl": "https://...",
      "createdAt": "2025-12-10T12:00:00.000Z",
      "updatedAt": "2025-12-10T12:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 100,
    "offset": 0
  }
}
```

### Yanıt Alanları

<table>
<thead>
  <tr>
    <th>
      Alan
    </th>
    
    <th>
      Tip
    </th>
    
    <th>
      Açıklama
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        data
      </code>
    </td>
    
    <td>
      array
    </td>
    
    <td>
      Mind nesnelerinin dizisi
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        pagination.total
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      Sorguyla eşleşen toplam mind sayısı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        pagination.limit
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      Sayfa başına maksimum sonuç
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        pagination.offset
      </code>
    </td>
    
    <td>
      number
    </td>
    
    <td>
      Atlanan sonuç sayısı
    </td>
  </tr>
</tbody>
</table>

### Örnek İstek

```bash
curl -X GET "https://getminds.ai/api/v1/minds?limit=10&offset=0" \
  -H "Authorization: Bearer minds_your_api_key"
```

## Mind Oluştur

Farklı eğitim modlarını kullanarak özel yapılandırmayla yeni bir AI mind oluşturun.

**Endpoint:** `POST /api/v1/minds`

Güvenli yeniden denemeler için isteğe bağlı `X-Minds-Idempotency-Key` başlığını (1–128 karakter) gönderin ve zaman aşımından sonra aynı anahtarı ve istek gövdesini kullanın. Anahtarlar kimliği doğrulanmış sahibin kapsamında tutulur. İlk Mind var olduğu sürece aynı anahtar, daha sonraki denemelerde de HTTP `200` ile o Mind’ı döndürür; Mind’ı güncellemez. Yeni bir Mind oluşturmak için yeni bir anahtar kullanın (HTTP `201`). 128 karakterden uzun anahtarlar kısaltılmak yerine `400` ile reddedilir.

Yönetilen çalışma alanlarında güncel oluşturma izinleri, yeniden denemeler dahil her isteğe uygulanır. Yeni Minds bu çalışma alanına aittir. Bir yeniden deneme anahtarı başka bir yönetilen çalışma alanındaki Mind’ı döndüremez; böyle bir istek `404` döndürür. Oluşturma devre dışıysa veya çalışma alanı etkin değilse oluşturma işleminden önce `403` döndürülür.

**Headers:**

```text
Authorization: Bearer minds_your_api_key
Content-Type: application/json
```

### İstek Body

```json
{
  "name": "My AI Expert",
  "description": "An expert in renewable energy",
  "mode": "keywords",
  "type": "expert",
  "discipline": "Renewable Energy",
  "keywords": ["solar", "wind energy", "sustainability", "green tech"],
  "personaContext": "Ada Lovelace, pioneering computer scientist",
  "contextLink": "https://example.com/profile",
  "tags": ["energy", "solar", "sustainability"],
  "profileImageUrl": "https://example.com/avatar.jpg"
}
```

### Parametreler

<table>
<thead>
  <tr>
    <th>
      Parametre
    </th>
    
    <th>
      Tip
    </th>
    
    <th>
      Zorunlu
    </th>
    
    <th>
      Açıklama
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        name
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <strong>
        Evet
      </strong>
    </td>
    
    <td>
      Mind'ın adı (2-100 karakter)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        discipline
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <strong>
        Evet
      </strong>
    </td>
    
    <td>
      Mind'ın uzmanlık alanı (örn. "Marketing", "Engineering")
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        mode
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Eğitim modu: <code>
        keywords
      </code>
      
      , <code>
        clone
      </code>
      
      , <code>
        link
      </code>
      
       veya <code>
        manual
      </code>
      
      . Varsayılan: <code>
        keywords
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        type
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind tipi: <code>
        creative
      </code>
      
      , <code>
        expert
      </code>
      
       veya <code>
        user
      </code>
      
      . Varsayılan: <code>
        creative
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        description
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın amacının açıklaması
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        keywords
      </code>
    </td>
    
    <td>
      array
    </td>
    
    <td>
      Koşullu
    </td>
    
    <td>
      Anahtar kelimeler dizisi (eğer <code>
        mode
      </code>
      
       <code>
        keywords
      </code>
      
       ise zorunlu)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        personaContext
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Koşullu
    </td>
    
    <td>
      Taklit edilecek kişinin adı/bağlamı (eğer <code>
        mode
      </code>
      
       <code>
        clone
      </code>
      
       ise zorunlu; ayrıca anahtar kelimeleri otomatik olarak türetmek için kullanılır)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        contextLink
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Koşullu
    </td>
    
    <td>
      Profil/içerik URL'i (eğer <code>
        mode
      </code>
      
       <code>
        link
      </code>
      
       ise zorunlu; sunucu bunu scrape eder ve anahtar kelimeleri türetir)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        tags
      </code>
    </td>
    
    <td>
      array
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Kategorilendirme için etiketler dizisi (maks 20 etiket)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        profileImageUrl
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Avatar resim için harici URL (indirilir ve saklanır)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        generateImage
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      <code>
        true
      </code>
      
       olduğunda, arka planda AI profil resmi oluşturmayı tetikler
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        cloneVoice
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      <code>
        true
      </code>
      
       olduğunda, YouTube araması yoluyla ses klonlamayı tetikler (deneysel)
    </td>
  </tr>
</tbody>
</table>

### Mode Değerleri

`mode` parametresi, mind'ınızın nasıl eğitileceğini belirler:

- **keywords** (varsayılan) - Mind'ınızı virgülle ayrılmış anahtar kelimeler kullanarak eğitin. AI, mind'ın bilgi tabanını oluşturmak için bu anahtar kelimelere dayalı çeşitli kaynaklardan ilgili bilgileri toplayacaktır.
  - **Zorunlu alan:** `keywords` - Anahtar kelimeler/konular dizisi
  - **En uygun:** Belirli konular veya alanlarda genel uzmanlık için
- **clone** - Bir kişinin tarzını ve bilgisini adlarını ve bağlamlarını sağlayarak klonlayın. AI, uzmanlıklarını ve iletişim tarzlarını taklit eden kapsamlı bir profil araştıracak ve oluşturacaktır.
  - **Zorunlu alan:** `personaContext` - Ad ve kısa bağlam (örn. "Ada Lovelace, pioneering computer scientist")
  - **En uygun:** Belirli kişileri, tarihi figürleri veya tanınmış uzmanları taklit etmek için
- **link** - Mind'ınızı belirli bir URL'den alınan içerikle eğitin. Bir profile, portfolyoya veya web sitesine bağlantı sağlayın; AI ilgili bilgileri analiz edip çıkaracaktır.
  - **Zorunlu alan:** `contextLink` - İçerik kaynağına URL
  - **En uygun:** Belirli web sitelerinden, portföylerden veya çevrimiçi profillerden eğitim için
- **manual** - Otomatik eğitim olmadan bir mind oluşturun. Tüm ayarları manuel olarak yapılandıracak ve daha sonra knowledge API aracılığıyla bilgi ekleyeceksiniz.
  - **Ek alan gerekmez**
  - **En uygun:** Eğitim verileri üzerinde tam kontrol istediğiniz özel yapılandırmalar için

> **Otomatik işleme:** `keywords`, `clone` veya `link` kullandığınızda, backend ürün içi Add Mind formunu yansıtır — entity anahtar kelimelerini türetir (`clone`/`link` için AI destekli) ve mind'ı asenkron olarak eğitir. Bu eğitimi, oluşturma yanıtındaki `training` bloğu ve aşağıdaki **Mind eğitim yaşam döngüsü** bölümünde açıklanan özel uç nokta üzerinden izleyin. `manual` modu bu otomasyonu atlar, böylece mind'ı daha sonra Knowledge API aracılığıyla eğitebilirsiniz.

### Type Değerleri

- **creative** - Sanatçılar, tasarımcılar, yazarlar ve yaratıcı profesyoneller için
- **expert** - Uzmanlar, danışmanlar ve alan uzmanları için
- **user** - Kullanıcı personaları, müşteriler ve hedef kitle arketipleri için

### Yanıt

```json
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My AI Expert",
    "description": "An expert in renewable energy",
    "type": "expert",
    "discipline": "Renewable Energy",
    "tags": ["energy", "solar", "sustainability"],
    "profileImageUrl": "https://...",
    "createdAt": "2025-12-10T12:00:00.000Z",
    "updatedAt": "2025-12-10T12:00:00.000Z"
  },
  "training": {
    "status": "queued",
    "readyToChat": false,
    "message": "Queued for data collection",
    "startedAt": null,
    "completedAt": null,
    "error": null
  }
}
```

`training` bloğu, mind'ın oluşturma anındaki yaşam döngüsünü bildirir. `keywords`, `clone` ve `link` modları `queued` olarak başlar ve arka planda eğitilir; `manual` mind'lar `readyToChat` zaten `true` olacak şekilde `completed` döner. Bir mind'ın `id`'si bu çağrı döndüğü anda vardır, ancak mind yalnızca `readyToChat` `true` olduğunda yanıt verebilir. Yoklama için aşağıdaki **Mind eğitim yaşam döngüsü** bölümüne bakın.

### Örnek: Keywords Modu ile Mind Oluştur

```bash
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Experienced marketing director with expertise in B2B SaaS",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["B2B marketing", "SaaS", "growth marketing", "content strategy", "brand positioning", "ROI"],
    "tags": ["marketing", "b2b", "saas", "growth"]
  }'
```

### Örnek: Clone Modu ile Mind Oluştur

```bash
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Lovelace AI",
    "description": "AI trained to emulate Ada Lovelace",
    "mode": "clone",
    "type": "expert",
    "discipline": "Computer Science Pioneer",
    "personaContext": "Ada Lovelace, pioneering computer scientist and mathematician, first computer programmer",
    "tags": ["computer science", "mathematics", "history"]
  }'
```

### Örnek: Link Modu ile Mind Oluştur

```bash
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brand Voice Expert",
    "description": "Trained on company brand guidelines",
    "mode": "link",
    "type": "creative",
    "discipline": "Brand Strategy",
    "contextLink": "https://example.com/brand-guidelines",
    "tags": ["branding", "copywriting"]
  }'
```

### Örnek: Manual Modu ile Mind Oluştur

```bash
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Custom Assistant",
    "description": "Custom configured assistant",
    "mode": "manual",
    "type": "creative",
    "discipline": "General Assistant",
    "tags": ["custom"]
  }'
```

## Mind eğitim yaşam döngüsü

Bir mind oluşturmak asenkrondur. `POST /v1/minds` hemen bir `id` döndürür, ancak `keywords`, `clone` ve `link` modlarında mind hâlâ arka planda eğitilmektedir. **Bir mind'ın id'sinin var olması, mind'ın hazır olduğu anlamına gelmez** — mind yalnızca `readyToChat` `true` olduğunda yanıt verebilir. Tek istisna `manual` modudur: bu mind'lar veri toplamayı atlar ve oluşturuldukları anda `completed` olur.

Mind hazır olana kadar özel eğitim uç noktasını yoklayın:

```bash
curl "https://getminds.ai/api/v1/minds/{mindId}/training" \
  -H "Authorization: Bearer minds_your_api_key"
```

```json
{
  "status": "running",
  "readyToChat": false,
  "message": "Collecting knowledge...",
  "startedAt": "2025-12-10T12:00:01.000Z",
  "completedAt": null,
  "error": null
}
```

### Durum değerleri

<table>
<thead>
  <tr>
    <th>
      Durum
    </th>
    
    <th>
      Anlamı
    </th>
    
    <th>
      <code>
        readyToChat
      </code>
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        queued
      </code>
    </td>
    
    <td>
      Eğitim kuyruğa alındı ama henüz başlamadı.
    </td>
    
    <td>
      <code>
        false
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        running
      </code>
    </td>
    
    <td>
      Mind etkin şekilde bilgi topluyor ve persona'sını oluşturuyor.
    </td>
    
    <td>
      <code>
        false
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        completed
      </code>
    </td>
    
    <td>
      Eğitim bitti. Mind sohbete hazır.
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        failed
      </code>
    </td>
    
    <td>
      Eğitim tamamlanmadı. <code>
        error
      </code>
      
      'u inceleyin ve yeniden denenebilirse yeniden eğitin.
    </td>
    
    <td>
      <code>
        false
      </code>
    </td>
  </tr>
</tbody>
</table>

`GET /v1/minds/{id}` de mind'ın geri kalanıyla birlikte `readyToChat` (ve `trainingStatus`) döndürür; böylece tek bir okuma size hem mind'ın kim olduğunu hem de henüz yanıt verip veremeyeceğini söyler.

### Eğitim başarısız olduğunda

`status` `failed` olduğunda, yanıt bir `code` ve bir `retryable` bayrağı içeren bir `error` nesnesi içerir:

<table>
<thead>
  <tr>
    <th>
      Hata kodu
    </th>
    
    <th>
      Anlamı
    </th>
    
    <th>
      <code>
        retryable
      </code>
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        COLLECTION_FAILED
      </code>
    </td>
    
    <td>
      Bilgi toplama tamamlanamadı.
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PROFILE_GEN_FAILED
      </code>
    </td>
    
    <td>
      Persona profili oluşturulamadı.
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        TIMEOUT
      </code>
    </td>
    
    <td>
      Eğitim zaman bütçesini aştı ve durduruldu.
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        INTERNAL
      </code>
    </td>
    
    <td>
      Beklenmeyen bir iç hata oluştu.
    </td>
    
    <td>
      <code>
        false
      </code>
    </td>
  </tr>
</tbody>
</table>

### Yeniden eğitim

Bir mind `failed` ile biterse (ya da yalnızca `completed` bir mind'ı yeniden oluşturmak isterseniz) onu yeniden eğitin:

```bash
curl -X POST "https://getminds.ai/api/v1/minds/{mindId}/retrain" \
  -H "Authorization: Bearer minds_your_api_key"
```

Bu, mind'ı yeniden kuyruğa alır ve `status` değeri `queued` olan yeni bir `training` bloğu döndürür. Yeniden eğitim yalnızca tamamlanmış mind'larda çalışır: hâlâ `queued` veya `running` olan bir mind, zaten bir eğitim çalışması sürdüğü için `409 Conflict` döndürür. Yeniden eğitimden sonra, `readyToChat` `true` olana kadar `GET /v1/minds/{id}/training`'i tekrar yoklayın.

## Profil Resimleri

Bir `profileImageUrl` sağladığınızda:

1. Resim harici URL'den indirilir
2. Güvenli depolamaya yüklenir
3. Saklanan URL yanıtta döndürülür

Desteklenen formatlar: JPG, PNG, GIF, WEBP

Harici indirmeler, herkese açık bir HTTP(S) raster görüntü URL’si gerektirir. Yönlendirme hedefleri dahil özel ağ adresleri ve SVG içerikleri reddedilir. İndirmeler 50 MiB ve 30 saniye ile sınırlıdır. İndirme veya depolama başarısız olursa Mind yine de özgün URL ile oluşturulur; bir URL döndürülmesi görüntünün depolandığını kanıtlamaz.

## Eğitim Nasıl Çalışır

Sistem, seçtiğiniz mod, tip ve disipline dayalı olarak akıllı bir system prompt'u otomatik olarak oluşturur:

- **Keywords modu**: Belirttiğiniz anahtar kelimeler etrafında uzmanlık oluşturur
- **Clone modu**: Belirtilen kişinin tarzını ve bilgisini taklit eden bir profil oluşturur
- **Link modu**: Sağlanan URL'den bilgi çıkarır
- **Manual modu**: Özel bilgi ile eğiteceğiniz temel bir asistan oluşturur

Mind'ınızı oluşturduktan sonra [bilgi yükleyerek](/docs/api/knowledge) daha da geliştirebilirsiniz.

## Plan Limitleri

Güncel herkese açık varsayılanlar için oluşturulan [plan limiti tablosuna](/docs/api/overview) bakın. Sözleşmeye özel geçersiz kılmalar farklı olabilir; entegrasyonlar kimliği doğrulanmış bir `PLAN_LIMIT` yanıtındaki `data.limit` ve `data.current` değerlerini kullanmalıdır. Starter planı API payload'larında `"premium"` olarak görünür.

Limitinize ulaştığınızda, `403 Forbidden` hatası alırsınız:

```json
{
  "statusCode": 403,
  "statusMessage": "Starter plan limit reached",
  "message": "Starter plan limit reached",
  "url": "/api/v1/minds",
  "error": true,
  "data": {
    "code": "PLAN_LIMIT",
    "limitType": "minds",
    "currentPlan": "premium",
    "limit": 100,
    "current": 100
  }
}
```

## Hata Yanıtları

### 400 Bad Request

Eksik veya geçersiz parametreler.

```json
{
  "statusCode": 400,
  "statusMessage": "Name is required"
}
```

### 401 Unauthorized

Geçersiz veya eksik API key.

### 403 Forbidden

Plan limitine ulaşıldı.

### 500 Internal Server Error

Sunucu tarafı hata (nadir).

## Mind Güncelle

Ad, açıklama, system prompt ve diğer ayarlar dahil olmak üzere mevcut bir mind'ın yapılandırmasını güncelleyin.

**Endpoint:** `PUT /api/v1/minds/{mindId}`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
Content-Type: application/json
```

### İstek Body

```json
{
  "name": "Updated Name",
  "description": "Updated description",
  "type": "expert",
  "discipline": "Updated Discipline",
  "systemPrompt": "Custom system prompt instructions...",
  "tags": ["tag1", "tag2"],
  "isPublic": false
}
```

### Parametreler

<table>
<thead>
  <tr>
    <th>
      Parametre
    </th>
    
    <th>
      Tip
    </th>
    
    <th>
      Zorunlu
    </th>
    
    <th>
      Açıklama
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        name
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın adı (2-100 karakter)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        description
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın amacının açıklaması
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        type
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Tip: <code>
        creative
      </code>
      
      , <code>
        expert
      </code>
      
       veya <code>
        user
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        discipline
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın uzmanlık alanı
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        systemPrompt
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın davranışını ve kişiliğini tanımlayan özel system prompt
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        tags
      </code>
    </td>
    
    <td>
      array
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Kategorilendirme için etiketler dizisi (maks 20 etiket)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        isPublic
      </code>
    </td>
    
    <td>
      boolean
    </td>
    
    <td>
      Hayır
    </td>
    
    <td>
      Mind'ın herkese açık erişilebilir olup olmadığı
    </td>
  </tr>
</tbody>
</table>

### System Prompt

`systemPrompt` alanı, mind'ınızın nasıl davranacağını ve yanıt vereceğini özelleştirmenize olanak tanır. Bu şunlar için kullanışlıdır:

- **Persona özelleştirme**: Belirli kişilik özellikleri, iletişim tarzı veya uzmanlık alanları tanımlama
- **Yanıt formatı**: Mind'a belirli formatlarda yanıt vermesini söyleme (örn. madde işaretleri, numaralı listeler)
- **Alan kısıtlamaları**: Yanıtları belirli konular veya bakış açılarıyla sınırlama
- **Dil/ton**: Yanıtların dilini, resmiyet düzeyini veya tonunu ayarlama

**Örnek system prompt'lar:**

```text
# Survey Response Expert
Du bist ein erfahrener Handwerker. Bei Umfragen antworte immer aus deiner
persönlichen Erfahrung, nicht mit allgemeinen Branchendurchschnittswerten.
Wähle bei Multiple-Choice-Fragen immer genau eine Option.
```

```text
# Technical Expert
You are a senior software architect. Always provide concrete,
actionable advice. Include code examples when relevant.
Avoid vague statements.
```

### Yanıt

```json
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Updated Name",
    "description": "Updated description",
    "type": "expert",
    "discipline": "Updated Discipline",
    "systemPrompt": "Custom system prompt...",
    "tags": ["tag1", "tag2"],
    "isPublic": false,
    "profileImageUrl": "https://...",
    "createdAt": "2025-12-10T12:00:00.000Z",
    "updatedAt": "2025-12-29T15:30:00.000Z"
  }
}
```

### Örnek: System Prompt Güncelle

```bash
curl -X PUT "https://getminds.ai/api/v1/minds/{mindId}" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "systemPrompt": "Du bist ein erfahrener Handwerker im Sanitärbereich. Antworte immer aus deiner persönlichen Praxiserfahrung."
  }'
```

### Örnek: Birden Fazla Alanı Güncelle

```bash
curl -X PUT "https://getminds.ai/api/v1/minds/{mindId}" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Senior Plumber Expert",
    "description": "Expert plumber with 20 years of experience",
    "discipline": "Plumbing & Sanitary Installation",
    "tags": ["plumbing", "sanitary", "renovation"]
  }'
```

### Hata Yanıtları

**400 Bad Request** - Güncellenecek geçerli alan yok veya geçersiz alan değerleri

**401 Unauthorized** - Geçersiz veya eksik API key

**403 Forbidden** - Bu mind'ı güncelleme izni yok (owner olmalısınız)

**404 Not Found** - Mind mevcut değil

## Mind Bilgi Örüntülerini Al

Belirli bir mind için düşünme örüntülerini ve çerçeveye göre düzenlenmiş bilgiyi al.

**Endpoint:** `GET /api/v1/minds/{mindId}/knowledge/patterns`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
```

### Yanıt Yapısı

Endpoint, çerçevelere göre gruplandırılmış örüntüleri döndürür (örn. AOX Internal, OCEAN, DISC, vb.), yöntemler ve yetkinlikler, görülme sayılarını ve kanıtları gösterir.

```json
{
  "success": true,
  "data": {
    "mindId": "550e8400-e29b-41d4-a716-446655440000",
    "mindName": "Marketing Expert",
    "totalPatterns": 47,
    "frameworks": [
      {
        "id": "aox-internal",
        "name": "AOX Internal Framework",
        "totalOccurrences": 32,
        "methods": [
          {
            "id": "strategic-thinking",
            "name": "Strategic Thinking",
            "description": "Ability to think strategically and plan long-term",
            "occurrences": 15,
            "competencies": [
              {
                "id": "market-analysis",
                "name": "Market Analysis",
                "description": "Understanding market dynamics and trends",
                "occurrences": 8,
                "evidence": [
                  {
                    "mind": "Market segmentation requires understanding customer pain points and aligning product features with specific needs...",
                    "portfolioItemId": "abc-123",
                    "createdAt": "2025-12-10T15:30:00.000Z"
                  },
                  {
                    "mind": "Competitive analysis shows that timing and positioning are critical for market entry...",
                    "portfolioItemId": "def-456",
                    "createdAt": "2025-12-10T14:20:00.000Z"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}
```

### Yanıtı Anlamak

- **frameworks**: Mind'ın örüntülerini içeren çerçevelerin dizisi

  - **totalOccurrences**: Bu çerçevedeki toplam örüntü sayısı
  - **methods**: Tespit edilen düşünme yöntemleri veya yaklaşımları
  
    - **occurrences**: Bu yöntemin kaç kez göründüğü
    - **competencies**: Yöntem içindeki belirli beceriler veya alt alanlar
    
      - **occurrences**: Bu yetkinlik için örüntü sayısı
      - **evidence**: Bu örüntüyü gösteren alıntıların/kanıtların dizisi
      
        - **mind**: İçerikten gerçek alıntı veya öngörü
        - **portfolioItemId**: Kaynak materyale referans
        - **createdAt**: Bu örüntünün ne zaman tespit edildiği

### Örnek İstek

```bash
curl -X GET "https://getminds.ai/api/v1/minds/{mindId}/knowledge/patterns" \
  -H "Authorization: Bearer minds_your_api_key"
```

### Kullanım Senaryoları

- **Mind uzmanlığını anlama**: Mind'ınızın hangi yöntemleri ve yetkinlikleri öğrendiğini görün
- **Kalite güvencesi**: Örüntülerin eğitim verilerinden doğru şekilde çıkarıldığını doğrulayın
- **Bilgi boşlukları**: Daha fazla eğitim verisine ihtiyaç duyulan alanları belirleyin
- **Çerçeve karşılaştırması**: Bir mind'ın farklı çerçevelerde nasıl performans gösterdiğini karşılaştırın

### Hata Yanıtları

**401 Unauthorized** - Geçersiz veya eksik API key

**403 Forbidden** - Bu mind'a erişim yok

**404 Not Found** - Mind mevcut değil

## System Prompt'u Yeniden Oluştur

Mevcut bilgi tabanını kullanarak bir mind için tüm system prompt bileşenlerini yeniden oluşturun. Bu, UI'nin "Generate All" düğmesiyle aynı AI destekli oluşturmayı kullanır.

**Endpoint:** `POST /api/v1/minds/{mindId}/regenerate-prompt`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
```

### Nasıl Çalışır

Endpoint, mind'ın bilgi tabanını (portfolio öğeleri, örüntüler, embedding'ler) analiz eder ve tüm prompt bileşenlerini oluşturur:

**user** tipi mind'lar için:

- Core Identity & Demographics
- Needs & Motivations
- Pain Points & Challenges
- Tone & Communication Style
- Goals & Desires
- Behavioral Patterns

**expert** tipi mind'lar için:

- Core Identity & Personality
- Professional Expertise & Credentials
- Tone & Communication Style
- Professional Approach & Methods
- Domain Knowledge

**creative** tipi mind'lar için:

- Core Identity & Personality
- Creative Philosophy & Values
- Tone & Communication Style
- Creative Approach & Methods
- Domain Expertise

### Yanıt

```json
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My Mind",
    "systemPrompt": "## Core Identity & Demographics\n\n...",
    "promptLength": 2847
  }
}
```

### Örnek İstek

```bash
curl -X POST "https://getminds.ai/api/v1/minds/{mindId}/regenerate-prompt" \
  -H "Authorization: Bearer minds_your_api_key"
```

### Kullanım Senaryoları

- **Bilgi ekledikten sonra**: Yeni eklenen bilgi öğelerini dahil etmek için prompt'u yeniden oluşturun
- **Persona iyileştirme**: Mevcut bilgi örüntülerine dayalı olarak personayı güncellemek için yeniden oluşturun
- **Özelleştirmeleri sıfırla**: Manuel düzenlemeleri temizleyin ve bilgi tabanından yeni prompt'lar yeniden oluşturun

### Hata Yanıtları

**401 Unauthorized** - Geçersiz veya eksik API key

**403 Forbidden** - Bu mind'ı değiştirme izni yok (owner olmalısınız)

**404 Not Found** - Mind mevcut değil

**500 Internal Server Error** - Prompt oluşturulamadı (örn. yetersiz bilgi)

## Mind Sil

Bilgi, portfolio öğeleri ve dosyalar dahil olmak üzere bir mind'ı ve ilişkili tüm verileri kalıcı olarak silin.

**Endpoint:** `DELETE /api/v1/minds/{mindId}`

**Headers:**

```text
Authorization: Bearer minds_your_api_key
```

### Yanıt

Başarılı olduğunda boş bir body ile `204 No Content` döndürür.

### Örnek İstek

```bash
curl -X DELETE "https://getminds.ai/api/v1/minds/{mindId}" \
  -H "Authorization: Bearer minds_your_api_key"
```

### Nelerin Silineceği

Bir mind sildiğinizde, aşağıdakiler kalıcı olarak kaldırılır:

- Mind'ın kendisi ve tüm yapılandırma
- Tüm bilgi ve eğitim verileri
- Tüm portfolio öğeleri ve ilişkili dosyalar
- Tüm sohbet geçmişi ve mesajlar
- Profil resimleri ve yüklenen dosyalar

**Uyarı:** Bu eylem geri alınamaz.

### Hata Yanıtları

**400 Bad Request** - Geçersiz mind ID formatı

**401 Unauthorized** - Geçersiz veya eksik API key

**403 Forbidden** - Bu mind'ı silme izni yok (owner olmalısınız)

**404 Not Found** - Mind mevcut değil

## Sonraki Adımlar

- [Mind'ınıza bilgi yükleyin](/docs/api/knowledge)
- [Mind'ınızla sohbet edin](/docs/api/chat)
- [Hatalar ve limitler](/docs/api/errors) hakkında bilgi edinin