samvaity

Azure Developer Experience Agent Architecture

➡️ Detailed overview of Azure Developer Experience Agent Architecture and per language MCP communication

Azure SDK MCP Scenarios Matrix

Overview

This document captures the end-to-end scenarios matrix for Azure SDK MCP implementations across languages, mapped to MCP standards, tsp-client capabilities, and implementation gaps.

---

samvaity

//Copyright (c) Microsoft Corporation. All rights reserved.
//Licensed under the MIT License.
package io.clientcore.annotation.processor.test.implementation;

import io.clientcore.core.http.models.HttpHeaderName;
import io.clientcore.core.http.models.HttpMethod;
import io.clientcore.core.http.models.HttpRequest;
import io.clientcore.core.http.models.RequestOptions;
import io.clientcore.core.http.models.Response;
import io.clientcore.core.http.pipeline.HttpPipeline;

samvaity

Pros and Cons of Committing Generated Code to the Repository

Pros:

1. Easier Debugging and Issue Reporting

   • Users can link directly to the broken source code when reporting issues.
   • In scenarios where generated code causes an error, having the code committed ensures visibility and simplifies troubleshooting.

2. Simplified Exploration

• Developers can quickly inspect the implementation without needing to regenerate code or resolve dependencies.

samvaity

Test Proxy Architecture

Sanitizers

Default Sanitizers

Custom Sanitizers

Recording tests with Test Proxy + SDK's

samvaity

LRO Poller never throws on failed status of the Long running OPeration. Here - https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/core/azure-core/src/main/java/com/azure/core/util/polling/PollerFlux.java#L225

In the usage context of Pollers in Form Recognizer, nothing much is gained out of LongRunningOperationState.FAILED.

LRO current implementation fail state usage:

recognizePoller.map(asyncPollResponse -> {
    if (asyncPollResponse.getStatus() == LRO.FAILED) {
       // inspect error or may be cancel server side op if it make sense.

samvaity

Java Usage

 if (formContent.getTextContentType().equals(TextContentType.WORD)) {
    FormWord formWordElement = (FormWord) (formContent);
    // do something
} else if (formContent.getTextContentType().equals(TextContentType.LINE)) {
    FormLine formLineElement = (FormLine) (formContent);
    // do something else
}

samvaity

TextAnalytics

TextAnalyticsClientBuilder

`public final class TextAnalyticsClientBuilder {

    public TextAnalyticsClientBuilder() {}

    public TextAnalyticsClient buildClient() {}

    public TextAnalyticsAsyncClient buildAsyncClient() {}

samvaity

import com.azure.core.util.Context;
import com.azure.data.appconfiguration.ConfigurationClient;
import com.azure.data.appconfiguration.ConfigurationClientBuilder;
import com.azure.data.appconfiguration.models.ConfigurationSetting;
import io.grpc.ManagedChannel;
import io.grpc.ManagedChannelBuilder;
import io.opentelemetry.context.Scope;
import io.opentelemetry.exporters.jaeger.JaegerGrpcSpanExporter;
import io.opentelemetry.sdk.trace.TracerSdk;
import io.opentelemetry.sdk.trace.export.SimpleSpansProcessor;

samvaity

Publishing Events with Azure Core Tracing OpenCensus

Publishing events is one of the common use-cases for event publishers. Following documentation describes instructions to run the sample program for publishing events with tracing instrumentation for Java SDK libraries.

Getting Started

Adding the Azure client library for Event Hubs package to your product:

samvaity

Sample Code

package com.example;

import com.azure.identity.credential.DefaultAzureCredentialBuilder;
import com.azure.security.keyvault.secrets.SecretClient;
import com.azure.security.keyvault.secrets.SecretClientBuilder;
import com.azure.security.keyvault.secrets.models.Secret;
import com.azure.security.keyvault.secrets.models.SecretBase;