MIP, OpenAI API’leriyle sorunsuz bağlantılar kurmanıza olanak tanıyan güçlü ve esnek bir entegrasyon platformudur. Bu rehberde, MIP ile OpenAI API entegrasyonunun adımlarını birlikte inceleyeceğiz.
1. MIP’de Package ve Flow Oluşturma
İlk olarak, MIP platformunda bir package ve akış (flow) oluşturuyoruz.
Daha sonra entegrasyon akışını açıyoruz. Sol üst köşedeki düğmeye tıklayarak yeni bir akış konfigürasyonu ekliyoruz.
2. OpenAI API Anahtarının Tanımlanması
OpenAI erişimi için gerekli olan API anahtarını güvenli bir şekilde saklamak amacıyla bir değişken tanımlıyoruz:
- Değişken Adı: openai_api_key
- Açıklama: OpenAI erişimi için gerekli olan API anahtarıdır.
Bu yöntem sayesinde test ortamından canlıya geçerken yalnızca bu değişkenin değerini güncellemeniz yeterlidir.
3. Entegrasyonun Yapılandırılması
Konfigürasyonu kaydettikten sonra tasarım ekranına geçiyoruz. Burada bizi Start Connector (Başlatıcı Bağlantı Noktası) karşılıyor. Bu bileşen, entegrasyonu tetikleyecek protokolü tanımlar.
- Protocol: REST
- Endpoint: Entegrasyonun sunulacağı adres.
- Synchronous Seçeneği: OpenAI’den senkron yanıt bekleniyorsa “Synchronous Endpoint” seçilmelidir.
4. OpenAI API Gereksinimlerinin Ayarlanması
a) Header Ayarlarının Yapılandırılması
Gerekli HTTP başlıklarını tanımlamak için Tools> Transformations > Set Context bileşeni eklenir.
b) HTTP Bağlantısıyla API Çağrılarının Yapılması
Ardından, OpenAI API ile bağlantı kurmak için Tools > External Calls > Technology > HTTP bağlantısını ekliyoruz.
- HTTP Method: POST
- Endpoint: OpenAI tarafından sağlanan API URL’si
- Timeout Setting: OpenAI yanıtları zaman alabileceği için yüksek bir timeout değeri belirlenir.
Kullanılabilir endpoint bilgileri için OpenAI dokümantasyonundaki Capabilities bölümüne göz atabilirsiniz.
c) Entegrasyonun Tamamlanması
Tasarımı tamamlamak için bir End Connector (Bitiş Noktası) eklenir. Her şey hazır olduğunda Kaydet ve Yayınla (Save and Deploy) düğmesine tıklanır.
5. Entegrasyonun Test Edilmesi
Entegrasyonu doğrulamak için Operations > Endpoints ve daha önce yapılandırdığımız endpoint URL’sini bulun.
Ardından entegrasyonu test etmek için “postman” kullanırız.
1. Yeni bir talep oluşturun.
2. Metot olarak POST seçin.
3. Authorization sekmesi altında MIP kullanıcı kimlik bilgilerini girin.
4. OpenAI istek gövdesini “Body section” bölümüne yapıştırın.
{
“model”: “gpt-3.5-turbo”,
“messages”: [
{
“role”: “developer”,
“content”: “Convert today’s top 10 rising US stocks to XML format and provide only the XML content, no comments.”
}
]
}
5. İsteği gönderin ve OpenAI’den gelen yanıtı inceleyin.
6. OpenAI Yanıtını XML Formatına Dönüştürme
Entegrasyonu geliştirmek adına OpenAI’den gelen JSON yanıtını XML formatına dönüştürelim:
- Yeni bir “Set Context Connector” ekleyin.
- Context Properties sekmesinde, JSON yanıtından yalnızca
contentalanını almak için bir değişken tanımlayın.
3. Change Context sekmesinde bu değişkeni yanıtla eşleştirin.
4. Context Header bölümünde content-type başlığını application/xml olarak ayarlayın.
Testi tekrar Postman ile gerçekleştirdiğinizde artık XML formatında bir yanıt göreceksiniz.
7. Entegrasyon Kayıtlarının İzlenmesi
Entegrasyon sürecini detaylı analiz etmek için:
- Operations> Endpoints kısmına giderek Log Seviyesini “All Steps” olarak değiştirin.
2. Postman ile tekrar bir istek gönderin.
3. Monitoring > Message Monitoring bölümünden entegrasyon mesajlarını inceleyin.
4. Başarılı (Successful) sütunundaki sayıya tıklayın.
5. Son mesajda Action > Show Full Log seçeneğine tıklayın.
Yeni bir pencere açılarak entegrasyon tasarımınız görüntülenir. Böylece her adımı adım adım takip edebilirsiniz. Örneğin, OpenAI’den yanıt geldikten sonra Set Context adımının çıktıyı nasıl dönüştürdüğünü görebilirsiniz.
Bu rehberde, MIP ile OpenAI API entegrasyonunun nasıl yapılacağını ve gerekli yapılandırmaları nasıl gerçekleştireceğinizi adım adım açıkladık. Herhangi bir sorunuz olursa bizimle iletişime geçebilirsiniz!
MIP ile yapabileceğiniz diğer entegrasyonları keşfedin:
