GitHub Copilot

Microsoft Agent Framework, arka uç olarak GitHub Copilot SDK'sını kullanan aracılar oluşturmayı destekler. GitHub Copilot aracıları kabuk komutu yürütme, dosya işlemleri, URL getirme ve Model Bağlam Protokolü (MCP) sunucu tümleştirmesi gibi güçlü kodlama odaklı yapay zeka özelliklerine erişim sağlar.

Önemli

GitHub Copilot aracıları kimliği doğrulanmış bir GitHub Copilot çalışma zamanı gerektirir. Bazı SDK'lar yüklü bir CLI kullanırken Go SDK'sı varsayılan olarak paketlenmiş çalışma zamanını kullanır. Güvenlik için kapsayıcılı bir ortamda (Docker/Dev Kapsayıcısı) kabuk veya dosya izinlerine sahip aracıların çalıştırılması önerilir.

Başlangıç Yapmak

Projenize gerekli NuGet paketlerini ekleyin.

dotnet add package Microsoft.Agents.AI.GitHub.Copilot

GitHub Copilot Aracısı Oluşturma

İlk adım olarak bir CopilotClient oluşturun ve başlatın. Ardından bir aracı oluşturmak için uzantı yöntemini kullanın AsAIAgent .

using GitHub.Copilot;
using Microsoft.Agents.AI;

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

AIAgent agent = copilotClient.AsAIAgent(sessionConfig: null);

Console.WriteLine(await agent.RunAsync("What is Microsoft Agent Framework?"));

Araçlar ve Yönergelerle

Aracıyı oluştururken işlev araçları ve özel yönergeler sağlayabilirsiniz:

using GitHub.Copilot;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

AIFunction weatherTool = AIFunctionFactory.Create((string location) =>
{
    return $"The weather in {location} is sunny with a high of 25C.";
}, "GetWeather", "Get the weather for a given location.");

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

AIAgent agent = copilotClient.AsAIAgent(
    tools: [weatherTool],
    instructions: "You are a helpful weather agent.");

Console.WriteLine(await agent.RunAsync("What's the weather like in Seattle?"));

Temsilci Özellikleri

Akış Yanıtları

Oluşturulan yanıtları alın:

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

AIAgent agent = copilotClient.AsAIAgent(sessionConfig: null);

await foreach (AgentResponseUpdate update in agent.RunStreamingAsync("Tell me a short story."))
{
    Console.Write(update);
}

Console.WriteLine();

Oturum Yönetimi

Oturumları kullanarak birden çok etkileşimde konuşma bağlamı sağlama:

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

await using GitHubCopilotAgent agent = new(
    copilotClient,
    instructions: "You are a helpful assistant. Keep your answers short.");

AgentSession session = await agent.CreateSessionAsync();

// First turn
await agent.RunAsync("My name is Alice.", session);

// Second turn - agent remembers the context
AgentResponse response = await agent.RunAsync("What is my name?", session);
Console.WriteLine(response); // Should mention "Alice"

Permissions

Varsayılan olarak, aracı kabuk komutlarını yürütemez, dosyaları okuyamaz/yazamaz veya URL'leri getiremez. Bu özellikleri etkinleştirmek için aracılığıyla SessionConfigbir izin işleyicisi sağlayın:

static Task<PermissionDecision> PromptPermission(
    PermissionRequest request, PermissionInvocation invocation)
{
    Console.WriteLine($"\n[Permission Request: {request.Kind}]");
    Console.Write("Approve? (y/n): ");

    string? input = Console.ReadLine()?.Trim().ToUpperInvariant();
    PermissionDecision decision = input is "Y" or "YES"
        ? PermissionDecision.ApproveOnce()
        : PermissionDecision.Reject();

    return Task.FromResult(decision);
}

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

SessionConfig sessionConfig = new()
{
    OnPermissionRequest = PromptPermission,
};

AIAgent agent = copilotClient.AsAIAgent(sessionConfig);

Console.WriteLine(await agent.RunAsync("List all files in the current directory"));

Araç Onayı

GitHub Copilot SDK’sı araç çağırma döngüsünü yönettiği için, özel işlev araçları için onay standart Agent Framework onay gidiş-dönüşü yerine SDK’nın yerel yürütme öncesi kancası üzerinden uygulanır. ApprovalRequiredAIFunction içine sarılmış bir aracı kaydettiğinizde, aracı o araç için "ask" döndüren varsayılan bir OnPreToolUse kancası yükler ve kararı OnPermissionRequest işleyicinize yönlendirir:

using GitHub.Copilot;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

AIFunction deleteFile = AIFunctionFactory.Create(
    (string path) => $"Deleted {path}.",
    "DeleteFile",
    "Deletes a file.");

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

SessionConfig sessionConfig = new()
{
    // Wrapping the tool marks it approval-required; the agent turns this into an "ask" at OnPreToolUse.
    Tools = [new ApprovalRequiredAIFunction(deleteFile)],

    // OnPermissionRequest decides the "asked" tools (and Copilot's built-in shell/file/URL prompts).
    OnPermissionRequest = PromptPermission,
};

AIAgent agent = copilotClient.AsAIAgent(sessionConfig);

Console.WriteLine(await agent.RunAsync("Delete the file temp.txt"));

Warning

SessionConfig.Hooks aracılığıyla kendi OnPreToolUse kancanızı sağlarsanız, bu kanca öncelikli olur ve ajan varsayılan onay kancasını yüklemez. Daha sonra, kaydettiğiniz herhangi bir ApprovalRequiredAIFunction için onayı uygulamaktan tamamen siz sorumlu olursunuz (örneğin, "deny" veya "ask" kararı döndürerek). Ajan, hook’unuzun işlemesi gereken onay gerektiren tüm araçların adını veren bir uyarı kaydeder.

MCP Sunucuları

Genişletilmiş özellikler için yerel (stdio) veya uzak (HTTP) MCP sunucularına bağlanın:

await using CopilotClient copilotClient = new();
await copilotClient.StartAsync();

SessionConfig sessionConfig = new()
{
    OnPermissionRequest = PromptPermission,
    McpServers = new Dictionary<string, McpServerConfig>
    {
        // Local stdio server
        ["filesystem"] = new McpStdioServerConfig
        {
            Command = "npx",
            Args = ["-y", "@modelcontextprotocol/server-filesystem", "."],
            Tools = ["*"],
        },
        // Remote HTTP server
        ["microsoft-learn"] = new McpHttpServerConfig
        {
            Url = "https://learn.microsoft.com/api/mcp",
            Tools = ["*"],
        },
    },
};

AIAgent agent = copilotClient.AsAIAgent(sessionConfig);

Console.WriteLine(await agent.RunAsync("Search Microsoft Learn for 'Azure Functions' and summarize the top result"));

Tip

Çalıştırılabilir örneklerin tamamı için .NET örneklerine bakın.

Tools

Araç	Statü	Notes
İşlev Araçları	✅	Standart `AIFunction` örnekler.
Araç Onayı	✅	Çerçevenin işlev çağırma destekli sohbet istemcisi tarafından sağlanır; herhangi bir işlev aracı çağrısıyla çalışır.
Kod Yorumlayıcısı	❌	Copilot CLI özelliği değildir.
Dosya Arama	❌	Copilot CLI özelliği değildir.
Web Araması	❌	Barındırılan bir araç olarak kullanıma sunulmaz.
Komut satırı / dosya sistemi / URL alma	✅	Copilot CLI çalışma zamanına yerleşiktir ve sağladığınız Permissions işleyicisinin denetimine tabidir.
Barındırılan MCP Araçları	✅	`SessionConfig.McpServers` aracılığıyla yapılandırılan uzak (HTTP) MCP sunucuları. Bkz. MCP Sunucuları.
Yerel MCP Araçları	✅	`SessionConfig.McpServers` aracılığıyla yapılandırılan yerel (stdio) MCP sunucuları. Bkz. MCP Sunucuları.

Ajanı Kullanma

Aracı, standart bir AIAgent'dir ve tüm standart AIAgent işlemlerini destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Prerequisites

Microsoft Agent Framework GitHub Copilot paketini yükleyin.

pip install agent-framework-github-copilot

Configuration

Aracı isteğe bağlı olarak aşağıdaki ortam değişkenleri kullanılarak yapılandırılabilir:

Variable	Açıklama
`GITHUB_COPILOT_CLI_PATH`	Copilot CLI yürütülebilir dosyasının yolu
`GITHUB_COPILOT_MODEL`	Kullanılacak model (örn. , `gpt-5claude-sonnet-4`)
`GITHUB_COPILOT_TIMEOUT`	İstek zaman aşımı süresi (saniye cinsinden)
`GITHUB_COPILOT_LOG_LEVEL`	CLI günlük düzeyi
`GITHUB_COPILOT_BASE_DIRECTORY`	CLI oturum durumu ve yapılandırması dizini (varsayılan olarak `~/.copilot`)

Başlangıç Yapmak

Gerekli sınıfları Agent Framework'ten içeri aktarın:

import asyncio
from agent_framework.github import GitHubCopilotAgent, GitHubCopilotOptions

GitHub Copilot Aracısı Oluşturma

Temel Ajan Oluşturma

GitHub Copilot aracısı oluşturmanın en basit yolu:

async def basic_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
    )

    async with agent:
        result = await agent.run("What is Microsoft Agent Framework?")
        print(result)

Açık Yapılandırma ile

aracılığıyla default_optionsaçık yapılandırma sağlayabilirsiniz:

async def explicit_config_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
        default_options={
            "model": "gpt-5",
            "timeout": 120,
        },
    )

    async with agent:
        result = await agent.run("What can you do?")
        print(result)

Tip

default_options (ve çalıştırma başına options), yalnızca burada gösterilen anahtarları değil, Copilot SDK’sının create_session tarafından kabul edilen her türlü parametreyi iletir — örneğin reasoning_effort, context_tier, enable_citations, provider (kendi anahtarını sağlama) veya skill_directories. Bilinmeyen parametre adları TypeError hatasına yol açar; böylece yazım hataları sessizce yok sayılmak yerine yakalanır.

Çalışma alanı dosya kancalarını denetleme

Varsayılan olarak, GitHubCopilotAgent çalışma dizininin .github/hooks/ klasöründen dosya kancalarını yüklemez. Yalnızca çalışma dizinine güvendiğiniz ve kancalarının oturumu etkilemesini istediğiniz durumlarda etkinleştirin:

from agent_framework.github import GitHubCopilotAgent, GitHubCopilotOptions
async def opt_in_to_file_hooks() -> None:
    """2. Opt in for a working directory whose hooks you trust."""
    print("=== 2. Opted in: file hooks from the working directory are loaded ===\n")

    agent: GitHubCopilotAgent[GitHubCopilotOptions] = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
        default_options=GitHubCopilotOptions(enable_file_hooks=True),
    )

    async with agent:
        result = await agent.run("In one sentence, what can you help me with?")
        print(f"Agent: {result}\n")

Warning

Dosya kancaları, uygulamanızı çalıştıran kullanıcı olarak komutları çalıştırır. Bunlar, on_permission_request veya diğer araç onayı geri çağrıları tarafından engellenmez.

Çalışma dizininde kancalar tanımlıysa ve enable_file_hooks öğesini belirtmezseniz, aracı bunu varsayılan olarak False yapar ve agent_framework.github_copilot günlükleyicisi aracılığıyla bir kez uyarı kaydeder. enable_file_hooks=False değerini açıkça ayarlamak, kancaları bu uyarı olmadan devre dışı bırakır.

Kendi anahtarını getir (BYOK)

Model isteklerini GitHub Copilot arka ucu yerine kendi OpenAI, Azure OpenAI, Anthropic veya OpenAI uyumlu uç noktanız üzerinden yönlendirmek için Copilot SDK'sının BYOK desteğini kullanın. ProviderConfig öğesini GitHubCopilotOptions(provider=...) aracılığıyla iletin ve hem sağlayıcı yapılandırmasında hem de oturum düzeyindeki model seçeneğinde aynı model tanımlayıcısını ayarlayın.

Çalıştırılabilir örnek şu ortam değişkenlerini kullanır:

Variable	Açıklama
`BYOK_PROVIDER_TYPE`	Sağlayıcı türü: `openai`, `azure`veya `anthropic`. Varsayılan değer `openai`’dır.
`BYOK_BASE_URL`	Sağlayıcı uç noktasının temel URL'si.
`BYOK_API_KEY`	Sağlayıcı uç noktası için statik API anahtarı.
`BYOK_MODEL_ID`	İstenecek model tanımlayıcısı. Varsayılan değer `gpt-4o`’dır.

Örnek statik BIR API anahtarı kullanır. Kimlik bilgilerini dönüşümlü olarak yenilemek için, ProviderConfig üzerindeki deneysel bearer_token_provider alanını, belirteç döndüren eşzamanlı veya eşzamansız bir geri çağırma işlevi olarak ayarlayın. Copilot SDK, her sağlayıcı isteğinde geri çağırma işlevini çalıştırır ve bu geri çağırma, belirteç edinme, önbelleğe alma ve yenileme işlemlerinden sorumludur. Bearer belirteci sağlayıcısı, bearer_token veya api_key da ayarlanmışsa, bunlara göre önceliklidir.

Warning

Statik API anahtarlarını ve belirteçlerini kaynak denetiminden uzak tutun. Bunları ortam değişkenlerinden veya gizli dizi deposundan yükleyin. Kullanımı ve faturalamayı GitHub değil, sağlayıcınız takip eder.

import asyncio
import os
from typing import Literal, cast

from agent_framework.github import GitHubCopilotAgent, GitHubCopilotOptions
from copilot.session import ProviderConfig


async def main() -> None:
    print("=== GitHub Copilot Agent with BYOK (Bring Your Own Key) ===\n")

    model_id = os.environ.get("BYOK_MODEL_ID", "gpt-4o")
    provider_type = cast(Literal["openai", "azure", "anthropic"], os.environ.get("BYOK_PROVIDER_TYPE", "openai"))

    # ProviderConfig routes the session through a custom endpoint instead of the GitHub
    # Copilot backend. `wire_api="completions"` is the broadly compatible choice; use
    # "responses" for providers that support the OpenAI Responses API.
    provider: ProviderConfig = {
        "type": provider_type,
        "base_url": os.environ["BYOK_BASE_URL"],
        "api_key": os.environ["BYOK_API_KEY"],
        "wire_api": "completions",
        "model_id": model_id,
    }

    # BYOK requires the model to also be set at the session level.
    agent: GitHubCopilotAgent[GitHubCopilotOptions] = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
        default_options=GitHubCopilotOptions(model=model_id, provider=provider),
    )

    async with agent:
        query = "What are the benefits of using your own API keys with an agent framework?"
        print(f"User: {query}")
        result = await agent.run(query)
        print(f"\nAgent: {result}\n")

Temsilci Özellikleri

Bağlam Sağlayıcıları

Python GitHubCopilotAgent da destekler context_providers=[...]. Sağlayıcılar her çağrıdan önce ve sonra çalışır, bu nedenle sağlayıcı tarafından eklenen iletiler ve yönergeler Copilot istemine dahil edilir ve geçmiş sağlayıcıları son yanıtı gözlemleyebilir.

from agent_framework import InMemoryHistoryProvider

agent = GitHubCopilotAgent(
    instructions="You are a helpful coding assistant.",
    context_providers=[InMemoryHistoryProvider()],
)

Yerleşik geçmiş sağlayıcılarını özel bağlam sağlayıcılarıyla birleştirebilirsiniz. Uygulama desenleri için bkz. Bağlam Sağlayıcıları.

İşlev Araçları

Ajanınızı özel işlevlerle donatın.

from typing import Annotated
from pydantic import Field

def get_weather(
    location: Annotated[str, Field(description="The location to get the weather for.")],
) -> str:
    """Get the weather for a given location."""
    return f"The weather in {location} is sunny with a high of 25C."

async def tools_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful weather agent.",
        tools=[get_weather],
    )

    async with agent:
        result = await agent.run("What's the weather like in Seattle?")
        print(result)

Akış Yanıtları

Daha iyi bir kullanıcı deneyimi için oluşturulan yanıtları alın:

async def streaming_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
    )

    async with agent:
        print("Agent: ", end="", flush=True)
        async for chunk in agent.run("Tell me a short story.", stream=True):
            if chunk.text:
                print(chunk.text, end="", flush=True)
        print()

Thread Yönetimi

Birden çok etkileşimde konuşma bağlamını koru.

async def thread_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant.",
    )

    async with agent:
        session = agent.create_session()

        # First interaction
        result1 = await agent.run("My name is Alice.", session=session)
        print(f"Agent: {result1}")

        # Second interaction - agent remembers the context
        result2 = await agent.run("What's my name?", session=session)
        print(f"Agent: {result2}")  # Should remember "Alice"

Permissions

Varsayılan olarak, aracı kabuk komutlarını yürütemez, dosyaları okuyamaz/yazamaz veya URL'leri getiremez. Bu özellikleri etkinleştirmek için bir izin işleyicisi sağlayın:

import asyncio

from copilot.generated.rpc import PermissionDecisionDeniedInteractivelyByUser
from copilot.session import PermissionHandler, PermissionRequestResult
from copilot.session_events import PermissionRequest


async def prompt_permission(
    request: PermissionRequest, context: dict[str, str]
) -> PermissionRequestResult:
    print(f"\n[Permission Request: {request.kind}]")
    response = (await asyncio.to_thread(input, "Approve? (y/n): ")).strip().lower()
    if response in ("y", "yes"):
        return PermissionHandler.approve_all(request, context)
    return PermissionDecisionDeniedInteractivelyByUser()

async def permissions_example():
    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant that can execute shell commands.",
        default_options={
            "on_permission_request": prompt_permission,
        },
    )

    async with agent:
        result = await agent.run("List the Python files in the current directory")
        print(result)

Tüm izinlerin otomatik olarak onaylanması gereken güvenilir ortamlar için yerleşik PermissionHandler.approve_all kullanın:

from copilot.session import PermissionHandler

agent = GitHubCopilotAgent(
    default_options={
        "on_permission_request": PermissionHandler.approve_all,
    },
)

İzin işleyicileri hem senkron hem de asenkron geri çağrı işlevlerini destekler. Olay döngüsünü engellememek için asenkron işleyicilerde etkileşimli istemler için asyncio.to_thread kullanın.

Araç Onayı

GitHub Copilot SDK’sı araç çağırma döngüsünü yönettiği için, özel işlev araçları için onay standart Agent Framework onay gidiş-dönüşü yerine SDK’nın yerel yürütme öncesi kancası üzerinden uygulanır. approval_mode="always_require" ile bildirilen bir aracı kaydettiğinizde ve kendi on_pre_tool_use kancanızı sağlamadığınızda, aracı bu araç için "ask" döndüren varsayılan bir kanca yükler ve kararı on_permission_request işleyicinize yönlendirir:

from agent_framework import tool
from agent_framework.github import GitHubCopilotAgent, GitHubCopilotOptions
from copilot.session import PermissionHandler


@tool(approval_mode="always_require")
def delete_file(path: str) -> str:
    """Delete a file."""
    return f"Deleted {path}."


agent = GitHubCopilotAgent(
    tools=[delete_file],
    # The "ask" decision is routed here; approve or deny the call.
    default_options=GitHubCopilotOptions(on_permission_request=PermissionHandler.approve_all),
)

Warning

Kendi on_pre_tool_use kancanızı sağlarsanız, bu öncelikli olur ve aracı varsayılan onay kancasını yüklemez. Ardından, herhangi bir approval_mode="always_require" aracı için onayı zorunlu kılmaktan tamamen siz sorumlu olursunuz (örneğin, bir "deny" veya "ask" kararı döndürerek). Ajan, hook’unuzun işlemesi gereken onay gerektiren tüm araçların adını veren bir uyarı kaydeder. Varsayılan olarak tüm izinleri reddeden izin işleyicisiyle, onaylayan bir on_permission_request bağlamadığınız sürece bir always_require araç reddedilir.

MCP Sunucuları

Genişletilmiş özellikler için yerel (stdio) veya uzak (HTTP) MCP sunucularına bağlanın:

from copilot.session import MCPServerConfig, PermissionHandler

async def mcp_example():
    mcp_servers: dict[str, MCPServerConfig] = {
        # Local stdio server
        "filesystem": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
            "tools": ["*"],
        },
        # Remote HTTP server
        "microsoft-learn": {
            "type": "http",
            "url": "https://learn.microsoft.com/api/mcp",
            "tools": ["*"],
        },
    }

    agent = GitHubCopilotAgent(
        instructions="You are a helpful assistant with access to the filesystem and Microsoft Learn.",
        default_options={
            "on_permission_request": PermissionHandler.approve_all,
            "mcp_servers": mcp_servers,
        },
    )

    async with agent:
        result = await agent.run("Search Microsoft Learn for 'Azure Functions' and summarize the top result")
        print(result)

Observability

GitHubCopilotAgent yerleşik OpenTelemetry izleme özelliğine sahiptir. Başlangıçta bir kez configure_otel_providers() çağırarak her çalışma için ölçümleri, günlükleri ve aralıkları etkinleştirin.

from agent_framework.observability import configure_otel_providers
from agent_framework.github import GitHubCopilotAgent

configure_otel_providers(enable_console_exporters=True)

async with GitHubCopilotAgent() as agent:
    response = await agent.run("Hello!")

Telemetri katmanı olmadan temel aracıya ihtiyacınız varsa (örneğin, özel bir katmana sarmak için), RawGitHubCopilotAgent öğesini agent_framework.github içeri aktarın.

OTLP ihracatçıları ve daha zengin örnekler için gözlemlenebilirlik örneklerine bakın.

Tools

Araç	Statü	Notes
İşlev Araçları	✅	Standart Python çağrılabilir nesneleri veya `@ai_function`.
Araç Onayı	✅	Çerçevenin işlev çağırma destekli sohbet istemcisi tarafından sağlanır; herhangi bir işlev aracı çağrısıyla çalışır.
Kod Yorumlayıcısı	❌	Copilot CLI özelliği değildir.
Dosya Arama	❌	Copilot CLI özelliği değildir.
Web Araması	❌	Barındırılan bir araç olarak kullanıma sunulmaz.
Komut satırı / dosya sistemi / URL alma	✅	Copilot CLI çalışma zamanına yerleşiktir ve sağladığınız Permissions işleyicisinin denetimine tabidir.
Barındırılan MCP Araçları	✅	`default_options["mcp_servers"]` aracılığıyla yapılandırılan uzak (HTTP) MCP sunucuları. Bkz. MCP Sunucuları.
Yerel MCP Araçları	✅	`default_options["mcp_servers"]` aracılığıyla yapılandırılan yerel (stdio) MCP sunucuları. Bkz. MCP Sunucuları.

Ajanı Kullanma

Aracı standart bir BaseAgent'dir ve tüm standart aracı işlemleri destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Başlangıç Yapmak

Microsoft Agent Framework Go modülünü ve Go için GitHub Copilot SDK'sını yükleyin. Agent Framework Go SDK'sı Go 1.25 veya üzerini gerektirir.

go get github.com/microsoft/agent-framework-go github.com/github/copilot-sdk/go

GitHub Copilot Aracısı Oluşturma

copilot.Client oluşturup başlatın, ardından bunu copilotprovider.NewAgent öğesine geçirin.

import (
    "context"
    "fmt"

    copilot "github.com/github/copilot-sdk/go"
    "github.com/microsoft/agent-framework-go/provider/copilotprovider"
)

ctx := context.Background()

copilotClient := copilot.NewClient(nil)
if err := copilotClient.Start(ctx); err != nil {
    panic(err)
}
defer func() { _ = copilotClient.Stop() }()

copilotAgent := copilotprovider.NewAgent(
    copilotClient,
    copilotprovider.AgentConfig{
        Instructions: "You are a helpful assistant.",
    },
)

response, err := copilotAgent.RunText(ctx, "What is Microsoft Agent Framework?").Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

Araçlar ve Yönergelerle

Aracıyı oluştururken işlev araçları ve özel yönergeler sağlayabilirsiniz:

import (
    "context"
    "fmt"

    copilot "github.com/github/copilot-sdk/go"
    "github.com/microsoft/agent-framework-go/agent"
    "github.com/microsoft/agent-framework-go/provider/copilotprovider"
    "github.com/microsoft/agent-framework-go/tool"
    "github.com/microsoft/agent-framework-go/tool/functool"
)

weatherTool := functool.MustNew(
    functool.Config{
        Name:        "GetWeather",
        Description: "Get the weather for a given location.",
    },
    func(_ context.Context, location string) (string, error) {
        return fmt.Sprintf("The weather in %s is sunny with a high of 25C.", location), nil
    },
)

copilotAgent := copilotprovider.NewAgent(
    copilotClient,
    copilotprovider.AgentConfig{
        Instructions: "You are a helpful weather agent.",
        Config: agent.Config{
            Tools: []tool.Tool{weatherTool},
        },
    },
)

response, err := copilotAgent.RunText(ctx, "What's the weather like in Seattle?").Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

Temsilci Özellikleri

Akış Yanıtları

Oluşturulan yanıtları alın:

for update, err := range copilotAgent.RunText(ctx, "Tell me a short story.", agent.Stream(true)) {
    if err != nil {
        panic(err)
    }
    fmt.Print(update)
}

fmt.Println()

Oturum Yönetimi

Oturumları kullanarak birden çok etkileşimde konuşma bağlamı sağlama:

session, err := copilotAgent.CreateSession(ctx)
if err != nil {
    panic(err)
}

// First turn
response, err := copilotAgent.RunText(ctx, "My name is Alice.", agent.WithSession(session)).Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

// Second turn - the agent remembers the context
response, err = copilotAgent.RunText(ctx, "What is my name?", agent.WithSession(session)).Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

Permissions

Varsayılan olarak, aracı kabuk komutlarını yürütemez, dosyaları okuyamaz/yazamaz veya URL'leri getiremez. Bu özellikleri etkinleştirmek için aracılığıyla copilot.SessionConfigbir izin işleyicisi sağlayın:

import (
    "bufio"
    "fmt"
    "os"
    "strings"

    copilot "github.com/github/copilot-sdk/go"
    "github.com/github/copilot-sdk/go/rpc"
    "github.com/microsoft/agent-framework-go/provider/copilotprovider"
)

func promptPermission(request copilot.PermissionRequest, _ copilot.PermissionInvocation) (rpc.PermissionDecision, error) {
    fmt.Printf("\n[Permission Request: %s]\n", request.Kind())
    fmt.Print("Approve? (y/n): ")

    input, _ := bufio.NewReader(os.Stdin).ReadString('\n')
    input = strings.TrimSpace(strings.ToUpper(input))
    if input == "Y" || input == "YES" {
        return &rpc.PermissionDecisionApproveOnce{}, nil
    }
    return &rpc.PermissionDecisionReject{}, nil
}

copilotAgent := copilotprovider.NewAgent(
    copilotClient,
    copilotprovider.AgentConfig{
        SessionConfig: &copilot.SessionConfig{
            OnPermissionRequest: promptPermission,
        },
    },
)

response, err := copilotAgent.RunText(ctx, "List all files in the current directory").Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

MCP Sunucuları

Genişletilmiş özellikler için yerel (stdio) veya uzak (HTTP) MCP sunucularına bağlanın:

import (
    copilot "github.com/github/copilot-sdk/go"
    "github.com/microsoft/agent-framework-go/provider/copilotprovider"
)

mcpServers := map[string]copilot.MCPServerConfig{
    // Local stdio server
    "filesystem": copilot.MCPStdioServerConfig{
        Command: "npx",
        Args:    []string{"-y", "@modelcontextprotocol/server-filesystem", "."},
        Tools:   []string{"*"},
    },
    // Remote HTTP server
    "microsoft-learn": copilot.MCPHTTPServerConfig{
        URL:   "https://learn.microsoft.com/api/mcp",
        Tools: []string{"*"},
    },
}

copilotAgent := copilotprovider.NewAgent(
    copilotClient,
    copilotprovider.AgentConfig{
        Instructions: "You are a helpful assistant with access to the filesystem and Microsoft Learn.",
        SessionConfig: &copilot.SessionConfig{
            OnPermissionRequest: promptPermission,
            MCPServers:          mcpServers,
        },
    },
)

response, err := copilotAgent.RunText(ctx, "Search Microsoft Learn for 'Azure Functions' and summarize the top result").Collect()
if err != nil {
    panic(err)
}
fmt.Println(response)

Tip

Tam bir çalıştırılabilir örnek için Go GitHub Copilot örneğine bakın.

Tools

Araç	Statü	Notes
İşlev Araçları	✅	`tool.Tool` işlevleri de dahil olmak üzere, Standart Go `functool` örnekleri.
Araç Onayı	✅	Fonksiyon araçları standart Go araç onayı desteğini kullanabilir; Copilot çalışma zamanı izinleri `SessionConfig.OnPermissionRequest` tarafından yönetilir.
Kod Yorumlayıcısı	❌	Copilot CLI özelliği değildir.
Dosya Arama	❌	Copilot CLI özelliği değildir.
Web Araması	❌	Barındırılan bir araç olarak kullanıma sunulmaz.
Komut satırı / dosya sistemi / URL alma	✅	Copilot CLI çalışma zamanına yerleşiktir ve sağladığınız Permissions işleyicisinin denetimine tabidir.
Barındırılan MCP Araçları	✅	`copilot.SessionConfig.MCPServers` aracılığıyla yapılandırılan uzak (HTTP) MCP sunucuları. Bkz. MCP Sunucuları.
Yerel MCP Araçları	✅	`copilot.SessionConfig.MCPServers` aracılığıyla yapılandırılan yerel (stdio) MCP sunucuları. Bkz. MCP Sunucuları.

Ajanı Kullanma

Aracı standart bir *agent.Agent'dir ve tüm standart aracı işlemleri destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Sonraki Adımlar

Copilot Studio

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-09-11

GitHub Copilot

Başlangıç Yapmak

GitHub Copilot Aracısı Oluşturma

Araçlar ve Yönergelerle

Temsilci Özellikleri

Akış Yanıtları

Oturum Yönetimi

Permissions

Araç Onayı

MCP Sunucuları

Tools

Ajanı Kullanma

Prerequisites

Configuration

Başlangıç Yapmak

GitHub Copilot Aracısı Oluşturma

Temel Ajan Oluşturma

Açık Yapılandırma ile

Çalışma alanı dosya kancalarını denetleme

Kendi anahtarını getir (BYOK)

Temsilci Özellikleri

Bağlam Sağlayıcıları

İşlev Araçları

Akış Yanıtları

Thread Yönetimi

Permissions

Araç Onayı

MCP Sunucuları

Observability

Tools

Ajanı Kullanma

Başlangıç Yapmak

GitHub Copilot Aracısı Oluşturma

Araçlar ve Yönergelerle

Temsilci Özellikleri

Akış Yanıtları

Oturum Yönetimi

Permissions

MCP Sunucuları

Tools

Ajanı Kullanma

Sonraki Adımlar

Geri Bildirim

Ek kaynaklar