Pojęcia dotyczące agenta

Agent w ramach Agent Framework łączy abstrakcję agenta, model lub połączenie ze zdalnym agentem, instrukcje, narzędzia, warstwę pośrednią, dostawców kontekstu i stan sesji w ramach spójnego interfejsu uruchamiania.

Środowisko uruchomieniowe i wykonanie

• Uruchamianie agentów wyjaśnia regularne i przesyłane strumieniowo przebiegi, opcje uruchamiania, odpowiedzi, komunikaty i zawartość.
• Potok działania agenta opisuje, jak oprogramowanie pośredniczące, dostawcy kontekstu, wywołanie modelu i narzędzia biorą udział w wykonaniu.
• Routing modelu środowiska uruchomieniowego wyjaśnia, kiedy konwersacja może przełączać modele lub dostawców wnioskowania bez utraty kontekstu.

Typy agentów

• Agenty niestandardowe wyjaśniają wspólny interfejs agenta i to, kiedy należy bezpośrednio zaimplementować agenta.
• Dostawcy modelu łączą agentów należących do aplikacji z usługami wnioskowania.
• Usługi agentów łączą się z zarządzanymi lub opartymi na protokole agentami zdalnymi.

Agenci klienta czatu

Agenci klienta czatu są agentami należącymi do aplikacji obsługiwanymi przez klienta wnioskowania modelu. Obsługują narzędzia funkcjonalne, konwersacje wieloturowe, narzędzia hostowane przez dostawcę, jeśli są dostępne, ustrukturyzowane dane wyjściowe, przesyłanie strumieniowe, middleware oraz lokalnie przechowywaną historię konwersacji lub historię konwersacji zarządzaną przez usługę.

Każdy klient wnioskowania, który implementuje Microsoft.Extensions.AI.IChatClient , może utworzyć kopię zapasową elementu ChatClientAgent:

using Microsoft.Agents.AI;

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are a helpful assistant.");

Wszystkie implementacje agentów opierają się na abstrakcji AIAgent, dzięki czemu kod aplikacji i orkiestracje mogą korzystać z agentów klientów czatu, agentów niestandardowych i proxy agentów zdalnych za pomocą jednego interfejsu.

Aby uzyskać informacje o możliwościach dostawcy, obsłudze historii konwersacji i wybieraniu punktów końcowych zestawu SDK, zobacz Dostawcy modelu.

Utwórz standardowy element Agent z dowolnego klienta obsługującego SupportsChatGetResponse:

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

Ten sam Agent interfejs działa u obsługiwanych dostawców modeli. Typy agentów bezpośrednich, takie jak FoundryAgent, A2AAgent, GitHubCopilotAgent i ClaudeAgent, zamiast tego łączą się z zarządzanymi lub zdalnymi środowiskami uruchomieniowymi agentów.

Aby uzyskać informacje o dostępnych klientach wnioskowania, zobacz Dostawcy modeli.

Pakiety dostawcy modeli języka Go konstruowają standardowy *agent.Agent typ za pomocą konstruktorów specyficznych dla dostawcy. Zapewnia to kodowi aplikacji spójny interfejs dla uruchomień, sesji, narzędzi, oprogramowania pośredniczącego i strumieniowania, podczas gdy każdy dostawca odpowiada za inicjalizację klienta.

W przypadku konstruktorów i ścieżek importu zobacz Dostawcy modelu.

Konwersacje i pamięć

Pojęcia dotyczące rozmowy obejmują sesje, dostawców kontekstu, przechowywanie, kompresję oraz wbudowanego dostawcę pamięci historii czatu.

Middleware

Pojęcia dotyczące oprogramowania pośredniczącego obejmują definicję, zakres, kolejność, stan współdzielony, kontekst wykonywania, zakończenie, błędy i nadpisywanie wyników.

Safety

Bezpieczeństwo agenta opisuje wzorce projektowe dotyczące ograniczania zachowania agenta i zmniejszenie ryzyka operacyjnego. Wymuszanie zabezpieczeń za pomocą narzędzia FIDES pozostaje funkcją agenta.

Następne kroki

Dowiedz się, jak uruchamiać agentów