Paso 2: Agregar herramientas

Las herramientas permiten al agente llamar a funciones personalizadas, como capturar datos meteorológicos, consultar una base de datos o llamar a una API.

Defina una herramienta como cualquier método con un [Description] atributo :

using System.ComponentModel;

[Description("Get the weather for a given location.")]
static string GetWeather([Description("The location to get the weather for.")] string location)
    => $"The weather in {location} is cloudy with a high of 15°C.";

Cree un agente con la herramienta :

using System;
using Azure.AI.Projects;
using Azure.Identity;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

var endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
    ?? throw new InvalidOperationException("Set AZURE_OPENAI_ENDPOINT");
var deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME") ?? "gpt-4o-mini";

AIAgent agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(
        model: deploymentName,
        instructions: "You are a helpful assistant.",
        tools: [AIFunctionFactory.Create(GetWeather)]);

Advertencia

DefaultAzureCredential es conveniente para el desarrollo, pero requiere una consideración cuidadosa en producción. En producción, considere usar una credencial específica (por ejemplo, ManagedIdentityCredential) para evitar problemas de latencia, sondeos de credenciales no deseados y posibles riesgos de seguridad de los mecanismos de respaldo.

El agente llamará automáticamente a tu herramienta cuando sea pertinente.

Console.WriteLine(await agent.RunAsync("What is the weather like in Amsterdam?"));

Sugerencia

Consulte aquí para obtener una aplicación de ejemplo ejecutable completa.

Defina una herramienta con el @tool decorador:

# NOTE: approval_mode="never_require" is for sample brevity.
# Use "always_require" in production for user confirmation before tool execution.
@tool(approval_mode="never_require")
def get_weather(
    location: Annotated[str, Field(description="The location to get the weather for.")],
) -> str:
    """Get the weather for a given location."""
    conditions = ["sunny", "cloudy", "rainy", "stormy"]
    return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."

Cree un agente con la herramienta :

agent = Agent(
    client=client,
    name="WeatherAgent",
    instructions="You are a helpful weather agent. Use the get_weather tool to answer questions.",
    tools=[get_weather],
)

Sugerencia

Consulte el ejemplo completo para obtener el archivo ejecutable completo.

Pasos siguientes

Paso 3: Conversaciones de múltiples turnos

Vaya más profundamente:

• Información general sobre las herramientas : obtenga información sobre todos los tipos de herramientas disponibles.
• Herramientas de funciones : patrones avanzados de la herramienta de funciones
• Aprobación de herramientas — humano en el bucle para llamadas a herramientas