Amazon Bedrock

Amazon Bedrock, AWS aracılığıyla temel modeller için yönetilen çıkarım sağlar. Agent Framework bir Bedrock IChatClient sarmalayabilir veya standart aracı, oturum, ara yazılım ve araç API'lerini tutarken Python BedrockChatClient kullanabilir.

Important

Amazon Bedrock üçüncü taraf bir sistemdir. Uygulama verilerini göndermeden önce AWS hizmet koşullarını, veri işlemeyi, bölgesel kullanılabilirliği, model erişimini ve kullanım maliyetlerini gözden geçirin.

Paketleri yükleme

dotnet add package AWSSDK.Extensions.Bedrock.MEAI
dotnet add package Microsoft.Agents.AI --prerelease

Configuration

AWS_REGION="us-east-1"
BEDROCK_MODEL_ID="anthropic.claude-3-5-sonnet-20241022-v2:0"

Kimlik doğrulaması ortam değişkenleri, paylaşılan profiller, iş yükü kimliği ve IAM rolleri dahil olmak üzere standart AWS kimlik bilgileri zincirini kullanır.

AWS Bedrock çalışma zamanı istemcisini oluşturun, öğesine IChatClientdönüştürün ve ardından bir Agent Framework aracısı oluşturun.

var awsRegion = Environment.GetEnvironmentVariable("AWS_REGION") ?? "us-east-1";
var modelId = Environment.GetEnvironmentVariable("BEDROCK_MODEL_ID") ?? "anthropic.claude-3-5-sonnet-20241022-v2:0";
// Create the Bedrock runtime client.
var bedrockRuntime = new AmazonBedrockRuntimeClient(RegionEndpoint.GetBySystemName(awsRegion));
IChatClient chatClient = bedrockRuntime.AsIChatClient(modelId);

AIAgent agent = chatClient.AsAIAgent(
    instructions: "You are a helpful assistant.",
    name: "BedrockAgent");

AWS kimlik bilgileri standart AWS kimlik bilgileri zincirini izler. Yalnızca uygulamanın ihtiyaç duyduğu Bedrock modeli eylemlerini verin.

Paketi yükle

pip install agent-framework-bedrock --pre

Configuration

BEDROCK_REGION="us-east-1"
BEDROCK_CHAT_MODEL="anthropic.claude-3-5-sonnet-20241022-v2:0"
AWS_ACCESS_KEY_ID="<access-key>"
AWS_SECRET_ACCESS_KEY="<secret-key>"
# Optional temporary credentials:
AWS_SESSION_TOKEN="<session-token>"
# Optional shared profile:
AWS_PROFILE="<profile>"

BedrockChatClient model, bölge ve AWS kimlik bilgilerini ayarlarından veya açık oluşturucu değerlerinden okur.

async def main() -> None:
    """Run a Bedrock-backed agent with one tool call."""
    # 1. Create an agent with Bedrock chat client and one tool.
    agent = Agent(
        client=BedrockChatClient(),
        instructions="You are a concise travel assistant.",
        name="BedrockWeatherAgent",
        tools=[get_weather],
        default_options=BedrockChatOptions(tool_choice="auto"),
    )

    # 2. Run a query that uses the weather tool.
    query = "Use the weather tool to check the forecast for New York."
    print(f"User: {query}")
    response = await agent.run(query)
    print(f"Assistant: {response.text}")

Bedrock'a özgü istek seçenekleri için ve BedrockGuardrailConfig dağıtımınız Bedrock guardrails kullandığında kullanınBedrockChatOptions.

Eklemeler oluşturma

BedrockEmbeddingClient Amazon Titan ekleme modelleri ile eklemeler oluşturur. ve 'yi yapılandırın BEDROCK_EMBEDDING_MODEL , BEDROCK_REGIONardından ile aynı AWS kimlik bilgileri zincirini BedrockChatClientkullanın.

Şu anda bu istemci için çalıştırılabilir Agent Framework ekleme örneği yayımlanmamış.

Uyarı

Amazon Bedrock tümleştirmesi şu anda Agent Framework Go için kullanılamıyor. En son durum için bkz. Agent Framework Go deposu .

Tools

Bedrock, yerel olarak çağrılan Agent Framework araçlarını destekler ancak sağlayıcı tarafından barındırılan araç fabrikalarını kullanıma sunmaz.

Araç	C#	Python	Notlar
İşlev Araçları	✅	✅	Model desteği seçilen Bedrock modeline göre değişir.
Araç Onayı	✅	✅	Agent Framework işlev çağırma döngüsü tarafından uygulanır.
Kod Yorumlayıcısı	❌	❌	Bedrock tarafından barındırılan kod yorumlayıcı tümleştirmesi yok.
Dosya Arama	❌	❌	Bedrock tarafından barındırılan dosya arama tümleştirmesi yok.
Web Araması	❌	❌	Bedrock tarafından barındırılan web araması tümleştirmesi yok.
Barındırılan MCP Araçları	❌	❌	Bedrock tarafından barındırılan MCP tümleştirmesi yok.
Yerel MCP Araçları	✅	✅	Uygulama işleminde çalışır.

Sonraki Adımlar

Google Gemini