Visual Studio中集成ChatGPT API实战指南：从配置到生产级应用

2次阅读

没有评论

共计 2631 个字符，预计需要花费 7 分钟才能阅读完成。

最近在项目中接入 ChatGPT API 时，发现原生 HTTP 调用存在两个明显痛点：

认证流程繁琐：每次请求都需要手动处理 Authorization 头，密钥管理分散在不同配置文件
流式响应解析困难：当启用 stream 模式时，传统的 HttpClient 需要自行处理分块数据，代码复杂度陡增

更麻烦的是，当需要实现生产级的重试机制和错误处理时，代码会迅速变得难以维护。

对比了三种主要实现方式：

原生 HTTP 请求：灵活性高但开发效率低
OpenAI 官方 SDK：功能全面但缺乏 VS 生态集成
VS 扩展 + 自定义封装：本文推荐的平衡方案

最终选择组合方案：

通过 VS 的 NuGet 安装必要的库
创建共享基础组件项目
开发 VS 扩展提供智能提示

首先在 VS 中新建类库项目，通过 NuGet 添加依赖：

dotnet add package OpenAI (官方客户端)
dotnet add package Polly (重试策略)
dotnet add package Microsoft.Extensions.Logging (日志记录)

密钥管理推荐使用 VS 内置的 Secret Manager：

dotnet user-secrets init
dotnet user-secrets set "OpenAI:ApiKey" "your-api-key"

以下是带自动重试的请求示例：

public class ChatService : IChatService
{
    private readonly IOpenAIClient _client;
    private readonly ILogger<ChatService> _logger;

    public ChatService(IOpenAIClient client, ILogger<ChatService> logger) 
    {
        _client = client;
        _logger = logger;
    }

    /// <summary>
    /// 发送对话请求并自动处理重试逻辑
    /// </summary>
    public async Task<ChatResponse> SendWithRetryAsync(ChatRequest request)
    {
        var policy = Policy
            .Handle<ApiException>(ex => ex.StatusCode == 429)
            .WaitAndRetryAsync(3, retryAttempt => 
                TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));

        return await policy.ExecuteAsync(async () => {
            try {return await _client.CreateChatCompletionAsync(request);
            } catch (ApiException ex) {_logger.LogError(ex, "API 请求失败");
                throw;
            }
        });
    }
}

使用 System.Text.Json 高效解析流数据：

async IAsyncEnumerable<string> StreamCompletionAsync(ChatRequest request)
{using var response = await _client.CreateChatCompletionStreamAsync(request);
    var stream = response.EnumerateAsync();

    await foreach (var chunk in stream)
    {if (chunk.Choices?.FirstOrDefault()?.Delta?.Content != null)
        {yield return chunk.Choices[0].Delta.Content;
        }
    }
}

使用 Polly 的 Bulkhead 策略限制并发
通过响应头的 x-ratelimit-remaining 动态调整
关键业务路径实现请求队列

建议在中间件层添加自动过滤：

public class ContentFilterMiddleware
{private static readonly Regex _pattern = new(@"\b(密码 | 银行卡 | 身份证)\b");

    public string Filter(string input)
    {return _pattern.Replace(input, "[敏感信息]");
    }
}

使用 Moq 模拟 API 响应：

[Test]
public async Task Should_Retry_When_RateLimited()
{
    // Arrange
    var mockClient = new Mock<IOpenAIClient>();
    mockClient.SetupSequence(x => x.CreateChatCompletionAsync(It.IsAny<ChatRequest>()))
        .Throws(new ApiException(429, "Too Many Requests"))
        .ReturnsAsync(new ChatResponse());

    var service = new ChatService(mockClient.Object, Mock.Of<ILogger<ChatService>>());

    // Act & Assert
    await service.SendWithRetryAsync(new ChatRequest());
    mockClient.Verify(x => x.CreateChatCompletionAsync(It.IsAny<ChatRequest>()), Times.Exactly(2));
}