الخطوة 6: عامل Harness

يلتف التسخير مع عميل الدردشة مع دعم يحتاج العامل إلى العمل من خلال مهام طويلة متعددة الخطوات — التخطيط / أوضاع التنفيذ، وقائمة المهام للتخطيط مقابل، وضغط السياق، وذاكرة الملف، والوصول إلى الملفات، والموافقة على أداة عدم الطلب مرة أخرى. بدلا من تجميع هذه القطع بنفسك، يمكنك إنشاء عامل تسخير وإخراجها من الصندوق.

إنشاء عامل تسخير من أي IChatClient مع أسلوب الملحق AsHarnessAgent . نظرا لأن التسخير يعمل من خلال المهام بشكل تفاعلي عبر العديد من الخطوات، فإنك عادة ما تقوده من حلقة محادثة: احتفظ AgentSession بحالة التسخير (الخطة، المهام، والمحفوظات) تستمر عبر المنعطفات، وقراءة التعليمات التالية للمستخدم، ودفق إخراج العامل أثناء إنتاجه.

using System;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

// chatClient is any IChatClient implementation (Foundry, Azure OpenAI, OpenAI, Anthropic, ...).
AIAgent agent = chatClient.AsHarnessAgent();

// A session carries the harness state (plan, todos, history) across turns.
AgentSession session = await agent.CreateSessionAsync();

Console.WriteLine("Harness agent ready. Type 'exit' to quit.");
while (true)
{
    Console.Write("> ");
    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(input) || input.Equals("exit", StringComparison.OrdinalIgnoreCase))
    {
        break;
    }

    // Stream this turn's output as the harness plans and works through the request.
    await foreach (var update in agent.RunStreamingAsync(input, session))
    {
        Console.Write(update);
    }

    Console.WriteLine();
}

يعالج التسخير التخطيط وتعقب المهام واستمرار التاريخ لك عبر المحادثة بأكملها. للحصول على وحدة تحكم كاملة الميزات — مع مطالبات الموافقة على الأدوات، وعرض المهام/الوضع، والأوامر المائلة — راجع نموذج UX الطرفية.

Tip

راجع عينات .NET harness للتطبيقات القابلة للتشغيل الكامل.

إنشاء عامل تسخير مع create_harness_agent المصنع. نظرا لأن التسخير يعمل من خلال المهام بشكل تفاعلي عبر العديد من الخطوات، فإنك عادة ما تقوده من حلقة محادثة: احتفظ بجلسة عمل حتى تستمر حالة التسخير (الخطة، والدوس، والمحفوظات) عبر المنعطفات، وقراءة التعليمات التالية للمستخدم، ودفق إخراج العامل أثناء إنتاجه.

from agent_framework import create_harness_agent
from agent_framework.openai import OpenAIChatClient

agent = create_harness_agent(
    OpenAIChatClient(model="gpt-4o"),
)

# A session carries the harness state (plan, todos, history) across turns.
session = agent.create_session()

print("Harness agent ready. Type 'exit' to quit.")
while True:
    user_input = input("> ")
    if user_input.strip().lower() in {"exit", "quit"}:
        break

    # Stream this turn's output as the harness plans and works through the request.
    async for chunk in agent.run(user_input, session=session, stream=True):
        if chunk.text:
            print(chunk.text, end="", flush=True)
    print()

يعالج التسخير التخطيط وتعقب المهام واستمرار التاريخ لك عبر المحادثة بأكملها. للحصول على وحدة تحكم كاملة الميزات — مع مطالبات الموافقة على الأدوات، وعرض المهام/الوضع، والأوامر المائلة — راجع نموذج UX الطرفية.

Tip

راجع عينات Python harness للتطبيقات القابلة للتشغيل الكامل.

Note

سيتوفر دعم Go لتسخيرات الوكلاء قريبا. راجع مستودع Agent Framework Go للحصول على أحدث حالة.

الخطوات التالية

الخطوة 7: استضافة وكيلك

انتقل إلى أبعد من ذلك:

• Agent Harnesses — الضغط، التكرار الحلقي، shell، ونموذج UX الطرفي
• مهارات العامل - تحميل المهارات تدريجيا من نظام الملفات