Barındırılan aracı uç noktasını ve aracı kartını güncelleştirme

Important

Bu makalede önizleme olarak işaretlenmiş öğeler şu anda önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve Microsoft üretim iş yükleri için bunu önermez. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Zaten dağıtılmış bir Microsoft Foundry aracısına uç nokta ve kart meta verilerine yama uygulamak için kullanınazd ai agent endpoint update. Yeni bir ajan sürümü oluşturmadan müşteriye dönük ayrıntıları yenileyebilirsiniz.

GitHub Copilot gibi bir kodlama aracısı kullanıyorsanız Microsoft Foundry Skill, dağıtım değişikliklerini ayrı tutarken uç nokta meta verilerini ve aracı kartı ayarlarını güncelleştirmenize yardımcı olabilir.

Prerequisites

  • Bir Foundry projesine dağıtılan mevcut bir barındırılan aracı. endpoint update, barındırılan bir aracı oluşturmaz.
  • Aracının azure.yaml içinde tanımlandığı bir azd projesi veya açıkça belirtilmiş bir Foundry proje uç noktası. Daha fazla bilgi için bkz. Azd proje bağlamını ayarlama.
  • azd Foundry uzantıları yüklü.
  • Kimliği doğrulanmış azd bir oturum.

Meta verilerin ne zaman güncelleştirileceğine karar verme

Yalnızca tüketicilerin ve araçların aracıyla ilgili okuduğu meta verileri yenilemeniz gerektiğinde azd ai agent endpoint update kullanın. Bu meta veriler genel uç noktayı, görünen adı, açıklamayı ve kişi bilgilerini içerir.

Sık karşılaşılan durumlar şunlardır:

  • Aracı kartındaki kullanıcılara görünen adı veya açıklamayı değiştirdiniz ve bunun yeniden dağıtım yapmadan Foundry portalında da görünmesini istiyorsunuz.
  • Genel aracı uç nokta URL’sini taşıdınız veya yeniden oluşturdunuz.
  • Yönlendirme veya idare için kartta sahip veya kişi meta verilerini güncelleştirmişsiniz.

Modeli, yönergeleri, araçları, kodu veya ortam değişkenlerini değiştirdiyseniz kullanmayın endpoint update. Bu değişikliklerin yeni bir sürüme ihtiyacı vardır. Bunun yerine azd deploy veya azd up çalıştırın.

Uç noktayı ve kartı güncelleştirme

  1. agent_endpoint dosyanızdaki agent_card hizmetinde azure.ai.agent bölümünü, azure.yaml bölümünü veya her iki bölümü düzenleyin.

  2. Update komutunu çalıştırın:

    azd ai agent endpoint update

  3. Çok hizmetli bir projede hizmet adını konumsal olarak geçirin:

    azd ai agent endpoint update my-agent

CLI, azure.yaml içindeki ajan hizmetinden iki bölümü okur ve mevcut ajan kaydına yama uygular. Bu işlem yeni bir ajan sürümü oluşturmaz, bir kapsayıcıyı yeniden oluşturmaz veya altyapıda herhangi bir değişiklik yapmaz.

Güncellemeyi doğrulayın

Değişikliğin geçerli olduğunu onaylayın:

azd ai agent show

Çıkış, yeni uç nokta ve kart değerlerini yansıtır. Sürüm numarası değiştirilmez.

Güncelleştirilen alanları gözden geçirme

endpoint update yalnızca uç nokta ve kart meta verilerini güncelleştirir. Değişikliğinizin tam dağıtım gerekip gerekmediğine karar vermek için tabloyu kullanın.

azure.ai.agent hizmetindeki alan endpoint update tarafından güncellendi?
agent_endpoint Yes
agent_card Yes
model, model_deployment Hayır - gerektirir azd deploy
instructions Hayır - gerektirir azd deploy
tools, toolboxes, skills Hayır - gerektirir azd deploy
env Hayır - gerektirir azd deploy
Kapsayıcı görüntüsü / giriş noktası / çalışma zamanı Hayır - gerektirir azd deploy

Bir değişikliğin endpoint update için uygun olup olmadığından emin değilseniz, ardından azd ai agent doctor çalıştırın. azure.yaml ile dağıtılan aracının durumu arasındaki herhangi bir sapmayı tespit eder.

İlgili içerik

  • Son güncelleştirme: