Vytvoření agenta Azure AI pomocí rozhraní Microsoft Agent Framework

  • 7 min

Azure AI Foundry Agent je specializovaný agent v rámci rozhraní Microsoft Agent Framework, který je navržený tak, aby poskytoval konverzační funkce na podnikové úrovni s bezproblémovou integrací nástrojů. Automaticky zpracovává volání nástrojů, takže nemusíte ručně analyzovat a volat funkce. Agent také bezpečně spravuje historii konverzací pomocí vláken, což snižuje práci údržby stavu. Azure AI Foundry Agent podporuje řadu integrovaných nástrojů, včetně interpreta kódu, vyhledávání souborů a webového vyhledávání. Poskytuje také možnosti integrace pro Azure AI Search, Azure Functions a další služby Azure.

Vytvoření agenta Azure AI Foundry

Agent Azure AI Foundry zahrnuje všechny základní funkce, které obvykle potřebujete pro podnikové aplikace AI, jako je spouštění funkcí, plánování a přístup k paměti. Tento agent funguje jako samostatný modul runtime s funkcemi na podnikové úrovni.

Použití agenta Azure AI Foundry:

  1. Vytvořte projekt Azure AI Foundry.
  2. Přidejte připojovací řetězec projektu do kódu aplikace Microsoft Agent Framework.
  3. Nastavte přihlašovací údaje pro ověřování.
  4. Vytvořte ChatAgent pomocí AzureAIAgentClient.
  5. Definujte nástroje a pokyny pro vašeho agenta.

Tady je kód, který ukazuje, jak vytvořit agenta Azure AI Foundry:

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

Po vytvoření agenta můžete vytvořit vlákno pro interakci s vaším agentem a získat odpovědi na vaše otázky. Například:

# 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}")

Klíčové komponenty agenta Azure AI Foundry

Agent Microsoft Agent Framework Azure AI Foundry používá k práci následující komponenty:

  • AzureAIAgentClient – spravuje připojení k projektu Azure AI Foundry. Tento klient umožňuje přístup ke službám a modelům přidruženým k vašemu projektu a poskytuje funkce ověřování a zabezpečení na podnikové úrovni.

  • ChatAgent – hlavní třída agenta, která kombinuje klienta, pokyny a nástroje k vytvoření funkčního agenta AI, který dokáže zpracovat konverzace a dokončit úlohy.

  • AgentThread – automaticky sleduje historii konverzací mezi agenty a uživateli a spravuje stav konverzace. Můžete vytvořit nová vlákna nebo znovu použít existující vlákna, abyste zachovali kontext napříč interakcemi.

  • Integrace nástrojů – podpora vlastních funkcí, které rozšiřují možnosti agenta. Funkce se automaticky registrují a agenti je můžou volat, aby se připojili k externím rozhraním API a službám.

  • Přihlašovací údaje pro ověřování – podporuje přihlašovací údaje Azure CLI, ověřování instančního objektu a další možnosti identity Azure pro zabezpečený přístup ke službám Azure AI.

  • Správa vláken – poskytuje flexibilní možnosti pro vytváření vláken, včetně automatického vytváření vláken pro jednoduché scénáře a explicitní správu vláken pro probíhající konverzace.

Tyto komponenty spolupracují a umožňují vytvářet agenty na podnikové úrovni s pokyny k definování jejich účelu a získání odpovědí z modelů AI při zachování kontextu zabezpečení, škálovatelnosti a konverzací pro obchodní aplikace.