Microsoft Agent Framework ile Azure AI aracısı oluşturma

  • 7 dakika

Microsoft Foundry Agent , Sorunsuz araç tümleştirmesi ile kurumsal düzeyde konuşma özellikleri sağlamak için tasarlanmış, Microsoft Agent Framework içinde özel bir aracıdır. Araç çağrılarını otomatik olarak işler, bu nedenle işlevleri el ile ayrıştırmanıza ve çağırmanıza gerek yoktur. Aracı ayrıca thread'leri kullanarak konuşma geçmişini güvenli bir şekilde yönetir ve bu, durumu koruma işini azaltır. Microsoft Foundry Agent, kod yorumlayıcı, dosya arama ve web araması gibi birçok yerleşik aracı destekler. Ayrıca Azure AI Search, Azure İşlevleri ve diğer Azure hizmetleri için tümleştirme özellikleri sağlar.

Microsoft Foundry Aracısı Oluşturma

Microsoft Foundry Aracısı, işlev yürütme, planlama ve bellek erişimi gibi kurumsal yapay zeka uygulamaları için genellikle ihtiyacınız olan tüm temel özellikleri içerir. Bu ajan, kurumsal düzeyde özelliklere sahip kendi başına çalışan bir çalışma zamanı işlevi görür.

Microsoft Foundry Aracısı kullanmak için:

  1. Microsoft Foundry projesi oluşturun.
  2. Proje bağlantı dizesini Microsoft Agent Framework uygulama kodunuza ekleyin.
  3. Kimlik doğrulama bilgilerini ayarlayın.
  4. Bir ChatAgent, bir AzureAIAgentClient ile oluşturun.
  5. Ajanınız için araçlar ve yönergeler tanımlayın.

Microsoft Foundry Agent'ın nasıl oluşturulacağını gösteren kod aşağıdadır:

from agent_framework import AgentThread, ChatAgent
from agent_framework.azure import AzureAIAgentClient
from azure.identity.aio import AzureCliCredential

def get_weather(
    location: Annotated[str, Field(description="The location to get the weather for.")],
) -> str:
    """Get the weather for a given location."""
    return f"The weather in {location} is sunny with a high of 25°C."

# Create a ChatAgent with Azure AI client
async with (
    AzureCliCredential() as credential,
    ChatAgent(
        chat_client=AzureAIAgentClient(async_credential=credential),
        instructions="You are a helpful weather agent.",
        tools=get_weather,
    ) as agent,
):
    # Agent is now ready to use

Ajanınız oluşturulduktan sonra, ajanınızla etkileşim kurmak ve sorularınıza yanıt almak için bir konu oluşturabilirsiniz. Örneğin:

# Create the agent thread for ongoing conversation
thread = agent.get_new_thread()

# Ask questions and get responses
first_query = "What's the weather like in Seattle?"
print(f"User: {first_query}")
first_result = await agent.run(first_query, thread=thread)
print(f"Agent: {first_result.text}")

Microsoft Foundry Agent anahtar bileşenleri

Microsoft Agent Framework Microsoft Foundry Agent, çalışmak için aşağıdaki bileşenleri kullanır:

  • AzureAIAgentClient - Microsoft Foundry projenize bağlantıyı yönetir. Bu istemci, projenizle ilişkili hizmetlere ve modellere erişmenizi sağlar ve kurumsal düzeyde kimlik doğrulaması ve güvenlik özellikleri sağlar.

  • ChatAgent - konuşmaları işleyebilecek ve görevleri tamamlayabilen çalışan bir yapay zeka aracısı oluşturmak için istemciyi, yönergeleri ve araçları birleştiren ana aracı sınıfıdır.

  • AgentThread - Aracılar ve kullanıcılar arasındaki konuşma geçmişini otomatik olarak izler ve konuşma durumunu yönetir. Etkileşimler arasında bağlamı korumak için yeni iş parçacıkları oluşturabilir veya mevcut iş parçacıklarını yeniden kullanabilirsiniz.

  • Araçlar tümleştirmesi - Aracı özelliklerini genişleten özel işlevler için destek. İşlevler otomatik olarak kaydedilir ve aracılar tarafından dış API'lere ve hizmetlere bağlanmak için çağrılabilir.

  • Kimlik doğrulama kimlik bilgileri - Foundry Tools'a güvenli erişim için Azure CLI kimlik bilgilerini, hizmet sorumlusu kimlik doğrulamasını ve diğer Azure kimlik seçeneklerini destekler.

  • İş parçacığı yönetimi - Basit senaryolar için otomatik iş parçacığı oluşturma ve devam eden konuşmalar için açık iş parçacığı yönetimi dahil olmak üzere iş parçacığı oluşturma için esnek seçenekler sağlar.

Bu bileşenler birlikte çalışarak kurumsal düzeyde aracılar oluşturmanıza ve iş uygulamaları için güvenlik, ölçeklenebilirlik ve konuşma bağlamını korurken yapay zeka modellerinden yanıtlar almanıza olanak tanır.