Panoramica degli strumenti

Matrice di supporto del provider

I provider OpenAI e Azure OpenAI offrono ognuno due tipi di client, risposte e completamento chat, con diverse funzionalità degli strumenti. I client OpenAI di Azure rispecchiano gli equivalenti OpenAI. Copilot Studio e A2A agenti vengono eseguiti in un servizio remoto in modo che le relative funzionalità siano configurate nell'agente remoto anziché tramite il client di Agent Framework, non sono elencate nella matrice.

Matrice di supporto del provider

I provider OpenAI e Azure OpenAI offrono ognuno più tipi di client con diverse funzionalità degli strumenti. I client OpenAI di Azure rispecchiano gli equivalenti OpenAI. La colonna Foundry si applica a FoundryChatClient : per FoundryAgent, gli strumenti sono configurati nella definizione dell'agente Foundry (vedere Cosa funziona e cosa non funziona con FoundryAgent). Copilot Studio e A2A agenti vengono eseguiti in un servizio remoto in modo che le relative funzionalità siano configurate nell'agente remoto anziché tramite il client di Agent Framework, non sono elencate nella matrice.

¹ Dipende dal modello locale scelto che supporta la chiamata di funzione. ² Integrato nel runtime dell'interfaccia della riga di comando GitHub Copilot, gestito da un gestore di autorizzazioni. Superficie diversa da Quella di get_shell_toolOpenAI.

Chiamare .AsAIFunction() su un AIAgent oggetto per convertirlo in uno strumento funzione che può essere fornito a un altro agente:

// Create the inner agent with its own tools
AIAgent weatherAgent = new AIProjectClient(
    new Uri("<your-foundry-project-endpoint>"),
    new DefaultAzureCredential())
     .AsAIAgent(
        model: "gpt-4o-mini",
        instructions: "You answer questions about the weather.",
        name: "WeatherAgent",
        description: "An agent that answers questions about the weather.",
        tools: [AIFunctionFactory.Create(GetWeather)]);

// Create the main agent and provide the inner agent as a function tool
AIAgent agent = new AIProjectClient(
    new Uri("<your-foundry-project-endpoint>"),
    new DefaultAzureCredential())
     .AsAIAgent(
        model: "gpt-4o-mini",
        instructions: "You are a helpful assistant.",
        tools: [weatherAgent.AsAIFunction()]);

// The main agent can now call the weather agent as a tool
Console.WriteLine(await agent.RunAsync("What is the weather like in Amsterdam?"));

Chiamare .as_tool() un agente per convertirlo in uno strumento funzione che può essere fornito a un altro agente:

import os
from agent_framework.openai import OpenAIChatCompletionClient
from azure.identity import AzureCliCredential

# Create the inner agent with its own tools
weather_agent = OpenAIChatCompletionClient(
    model=os.environ["AZURE_OPENAI_CHAT_COMPLETION_MODEL"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version=os.getenv("AZURE_OPENAI_API_VERSION"),
    credential=AzureCliCredential(),
).as_agent(
    name="WeatherAgent",
    description="An agent that answers questions about the weather.",
    instructions="You answer questions about the weather.",
    tools=get_weather
)

# Create the main agent and provide the inner agent as a function tool
main_agent = OpenAIChatCompletionClient(
    model=os.environ["AZURE_OPENAI_CHAT_COMPLETION_MODEL"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version=os.getenv("AZURE_OPENAI_API_VERSION"),
    credential=AzureCliCredential(),
).as_agent(
    instructions="You are a helpful assistant.",
    tools=weather_agent.as_tool()
)

# The main agent can now call the weather agent as a tool
result = await main_agent.run("What is the weather like in Amsterdam?")
print(result.text)

È anche possibile personalizzare il nome, la descrizione e il nome dell'argomento dello strumento:

weather_tool = weather_agent.as_tool(
    name="WeatherLookup",
    description="Look up weather information for any location",
    arg_name="query",
    arg_description="The weather query or location"
)