Azure OpenAI Yardımcıları Kod Yorumlayıcısı (Önizleme) (klasik)

Yalnızca şunlar için geçerlidir:Dökümhane (klasik) portalı. Bu makale yeni Dökümhane portalında kullanılamaz. Yeni portal hakkında daha fazla bilgi edinin.

Not

Bu makaledeki bağlantılar, şu anda görüntülediğiniz Dökümhane (klasik) belgeleri yerine yeni Microsoft Foundry belgelerinde içerik açabilir.

Not

Asistanlar API'si kullanımdan kaldırıldı ve 26 Ağustos 2026'da emekliye ayrılacaktır. Genel olarak mevcut olan Microsoft Foundry Agents hizmetini kullanın. İş yüklerinizi güncellemek için geçiş rehberini takip edin. Daha fazla bilgi edinin.

Kod Yorumlayıcı, Yardımcılar API'sinin korumalı bir yürütme ortamında Python kodu yazmasına ve çalıştırmasına olanak tanır. Kod Yorumlayıcı etkinleştirildiğinde, Yardımcınız daha zorlu kod, matematik ve veri analizi sorunlarını çözmek için kodu yinelemeli olarak çalıştırabilir. Yardımcınız çalıştırılamayan bir kod yazdığında, kod yürütme başarılı olana kadar farklı kodlar üzerinde değişiklik yapıp çalıştırarak bu kodu yineleyebilir.

Önemli

Kod Yorumlayıcı, Azure OpenAI kullanımı için belirteç tabanlı ücretlendirmenin ötesinde ek ücretler barındırır. Yardımcınız kod yorumlayıcıyı aynı anda iki farklı iş parçacığında çağırırsa, iki kod yorumlayıcı oturumu oluşturulur. Her oturum varsayılan olarak 1 saat boyunca etkindir ve boşta kalma süresi 30 dakikadır.

Kod yorumlayıcı desteği

Desteklenen modeller

Modeller sayfası, Asistanların ve kod yorumlayıcının desteklendiği bölgeler/modeller hakkında en güncel bilgileri içerir.

Yeni özelliklerden, daha büyük bağlam pencerelerinden ve daha güncel eğitim verilerinden yararlanmak için en son modellerle yardımcıları kullanmanızı öneririz.

API Sürümleri

  • Başlangıç: 2024-02-15-preview

Desteklenen dosya türleri

Dosya biçimi MIME Türü
.C text/x-c
.cpp text/x-c++
.csv application/csv
.docx application/vnd.openxmlformats-officedocument.wordprocessingml.document
.html metin/html
.java text/x-java
.json application/json
.md text/markdown
.pdf uygulama/pdf
.php text/x-php
.pptx application/vnd.openxmlformats-officedocument.presentationml.presentation
.py text/x-python
.py text/x-script.python
.rb text/x-ruby
.tex text/x-tex
.txt düz metin
.css text/css
.jpeg image/jpeg
.jpg image/jpeg
.js text/javascript
.gif resim/gif
.png resim/png
.tar application/x-tar
.ts application/typescript
.xlsx application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
.xml application/xml veya "text/xml"
.zip application/zip

Dosya yükleme API referansı

Yardımcılar, dosya yükleme için ince ayarda kullanılan aynı API'yi kullanır. Bir dosyayı karşıya yüklerken, amaç parametresi için uygun bir değer belirtmeniz gerekir.

Kod Yorumlayıcısını Etkinleştirme

from openai import AzureOpenAI
    
client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2024-05-01-preview",
    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
    )

assistant = client.beta.assistants.create(
  instructions="You are an AI assistant that can write code to help answer math questions",
  model="<REPLACE WITH MODEL DEPLOYMENT NAME>", # replace with model deployment name. 
  tools=[{"type": "code_interpreter"}]
)

Kod Yorumlayıcısı için Dosya Yüklemesi

from openai import AzureOpenAI
    
client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2024-05-01-preview",
    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
    )

# Upload a file with an "assistants" purpose
file = client.files.create(
  file=open("speech.py", "rb"),
  purpose='assistants'
)

# Create an assistant using the file ID
assistant = client.beta.assistants.create(
  instructions="You are an AI assistant that can write code to help answer math questions.",
  model="gpt-4-1106-preview",
  tools=[{"type": "code_interpreter"}],
  tool_resources={"code_interpreter":{"file_ids":[file.id]}}
)

Dosyayı tek bir iş parçacığına geçirme

Dosyaları Yardımcılar düzeyinde erişilebilir hale getirmenin yanı sıra, dosyaları geçirerek yalnızca belirli bir iş parçacığı için erişilebilir olmasını sağlayabilirsiniz.

from openai import AzureOpenAI
    
client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2024-05-01-preview",
    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
    )

thread = client.beta.threads.create(
  messages=[
    {
      "role": "user",
      "content": "I need to solve the equation `3x + 11 = 14`. Can you help me?",
      "file_ids": ["file.id"] # file id will look like: "assistant-R9uhPxvRKGH3m0x5zBOhMjd2" 
    }
  ]
)

Kod Yorumlayıcı tarafından oluşturulan dosyaları indirme

Kod Yorumlayıcı tarafından oluşturulan dosyalar Yardımcı ileti yanıtlarında bulunabilir

 {
      "id": "msg_oJbUanImBRpRran5HSa4Duy4",
      "assistant_id": "asst_eHwhP4Xnad0bZdJrjHO2hfB4",
      "content": [
        {
          "image_file": {
            "file_id": "assistant-1YGVTvNzc2JXajI5JU9F0HMD"
          },
          "type": "image_file"
        },
        # ...
 }

Dosyaları dosyalar API'sine geçirerek bu oluşturulan dosyaları indirebilirsiniz:

from openai import AzureOpenAI
    
client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2024-05-01-preview",
    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
    )

image_data = client.files.content("assistant-abc123")
image_data_bytes = image_data.read()

with open("./my-image.png", "wb") as file:
    file.write(image_data_bytes)

Ayrıca bkz.

  • Last updated on