Guía de Quick-Start de Microsoft Agent Framework

Prerrequisitos

Antes de comenzar, asegúrese de que tiene lo siguiente:

• SDK de .NET 8.0 o posterior
• Recurso de Azure OpenAI con un modelo implementado (por ejemplo, gpt-4o-mini)
• CLI de Azure instalada y autenticada (az login)
• El usuario tiene los roles de Cognitive Services OpenAI User o Cognitive Services OpenAI Contributor para el recurso de Azure OpenAI.

Creación de un proyecto

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Instalar paquetes

Los paquetes se publicarán en la Galería de NuGet | MicrosoftAgentFramework.

En primer lugar, agregue los siguientes paquetes NuGet de Microsoft Agent Framework a la aplicación con los siguientes comandos:

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

Ejecución de un ejemplo de agente básico

En este ejemplo se muestra cómo crear y usar un agente de inteligencia artificial simple con la finalización de chat de Azure OpenAI como back-end. Creará un agente básico con AzureOpenAIClientgpt-4o-mini e instrucciones personalizadas.

Código de ejemplo

Asegúrese de reemplazar https://your-resource.openai.azure.com/ por el punto de conexión del recurso de Azure OpenAI.

using System;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using OpenAI;

AIAgent agent = new AzureOpenAIClient(
  new Uri("https://your-resource.openai.azure.com/"),
  new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .CreateAIAgent(instructions: "You are good at telling jokes.");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

(Opcional) Instalación de paquetes nocturnos

Si necesita obtener un paquete que contenga las mejoras o correcciones más recientes, las compilaciones nocturnas de Agent Framework están disponibles en https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Para descargar compilaciones nocturnas, siga estos pasos:

1. Necesitará una cuenta de GitHub para completar estos pasos.

2. Cree un token de acceso personal de GitHub con el read:packages ámbito mediante estas instrucciones.

3. Si su cuenta forma parte de la organización de Microsoft, debe autorizar a la Microsoft organización como una organización de inicio de sesión único.

   1. Haga clic en "Configurar SSO" junto al token de acceso personal que acaba de crear y, a continuación, autorice Microsoft.

4. Use el siguiente comando para agregar el origen de paquetes de GitHub de Microsoft a la configuración de NuGet:

   dotnet nuget add source --username GITHUBUSERNAME --password GITHUBPERSONALACCESSTOKEN --store-password-in-clear-text --name GitHubMicrosoft "https://nuget.pkg.github.com/microsoft/index.json"
   

5. O bien, puede crear manualmente un NuGet.Config archivo.

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <packageSources>
       <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
       <add key="github" value="https://nuget.pkg.github.com/microsoft/index.json" />
     </packageSources>
   
     <packageSourceMapping>
       <packageSource key="nuget.org">
         <package pattern="*" />
       </packageSource>
       <packageSource key="github">
         <package pattern="*nightly"/>
         <package pattern="Microsoft.Agents.AI" />
       </packageSource>
     </packageSourceMapping>
   
     <packageSourceCredentials>
       <github>
           <add key="Username" value="<Your GitHub Id>" />
           <add key="ClearTextPassword" value="<Your Personal Access Token>" />
         </github>
     </packageSourceCredentials>
   </configuration>
   

   • Si coloca este archivo en la carpeta de su proyecto, asegúrese de que Git (o cualquier sistema de control de versiones que use) lo ignore.
   • Para obtener más información sobre dónde almacenar este archivo, consulte nuget.config referencia.

6. Ahora puedes agregar paquetes de la compilación nocturna a tu proyecto.

   Por ejemplo, use este comando. dotnet add package Microsoft.Agents.AI --prerelease

7. Y se puede hacer referencia a la versión más reciente del paquete en el proyecto de la siguiente manera:

   <PackageReference Include="Microsoft.Agents.AI" Version="*-*" />

Para obtener más información, consulte https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Prerrequisitos

Antes de comenzar, asegúrese de que tiene lo siguiente:

• Python 3.10 o posterior
• Un proyecto de Azure AI con un modelo implementado (por ejemplo, gpt-4o-mini)
• CLI de Azure instalada y autenticada (az login)
• Instale el paquete del marco de trabajo del agente:

pip install -U agent-framework --pre

Ejecución de un ejemplo de agente básico

En este ejemplo se muestra cómo crear y usar un agente de inteligencia artificial simple con Azure AI como back-end. Creará un agente básico con ChatAgentAzureAIAgentClient e instrucciones personalizadas.

Asegúrese de establecer las siguientes variables de entorno:

• AZURE_AI_PROJECT_ENDPOINT: tu punto de conexión del proyecto de Azure AI
• AZURE_AI_MODEL_DEPLOYMENT_NAME: el nombre de la implementación del modelo.

Código de ejemplo

import asyncio
from agent_framework.azure import AzureAIClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        AzureAIClient(async_credential=credential).create_agent(
            instructions="You are good at telling jokes."
        ) as agent,
    ):
        result = await agent.run("Tell me a joke about a pirate.")
        print(result.text)

if __name__ == "__main__":
    asyncio.run(main())

Más ejemplos

Para obtener ejemplos más detallados y escenarios avanzados, consulte Ejemplos de Azure AI.