.NET 용 OpenAI API 클라이언트 라이브러리. OpenAI 및 Azure-Openai API를 지원합니다. 이 라이브러리는 공개 사용을 위해 개발되었으며 자유롭게 사용할 수 있습니다. 지원되는 .NET 버전 :
x> = v4.6.1,
x> = 넷 스탠드 2.0,
x> = dotnetcore 3.1,
.NET 6.0,
.NET 7.0
.NET 8.0
Blazor WebAssembly 및 Blazor Server와 함께 작동합니다.
패키지를 설치하려면 다음 줄을 추가하여 XXX를 최신 버전 번호로 대체하는 CSPROJ 파일을 추가하십시오.
<PackageReference Include="Forge.OpenAI" Version="x.x.x" />
다음 명령으로 .NET CLI를 통해 설치할 수도 있습니다.
dotnet add package Forge.OpenAI
Visual Studio를 사용하는 경우 내장 NUGET 패키지 관리자를 통해 설치할 수도 있습니다.
OpenAI API와 함께 작업하려면 Apikey를 만들어야합니다.
OpenAI에 계정이없는 경우 여기에 계정을 만듭니다. https://platform.openai.com/
https://platform.openai.com/account/api-keys로 이동하는 것보다
기본적 으로이 라이브러리는 Microsoft Dependency Injection을 사용하지만 필요하지 않습니다.
응용 프로그램에서 startup.cs / program.cs 파일에 서비스 컬렉션으로 클라이언트 서비스를 등록 할 수 있습니다.
public void ConfigureServices ( IServiceCollection services )
{
services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
}또는 프로그램에서 CS 파일에서.
public static async Task Main ( string [ ] args )
{
var builder = WebAssemblyHostBuilder . CreateDefault ( args ) ;
builder . RootComponents . Add < App > ( " app " ) ;
builder . Services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = builder . Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
await builder . Build ( ) . RunAsync ( ) ;
}또는
public static async Task Main ( string [ ] args )
{
using var host = Host . CreateDefaultBuilder ( args )
. ConfigureServices ( ( builder , services ) =>
{
services . AddForgeOpenAI ( options => {
options . AuthenticationInfo = builder . Configuration [ " OpenAI:ApiKey " ] ! ;
} ) ;
} )
. Build ( ) ;
}OpenAI API 키와 선택적으로 조직을 제공하여 서비스를 부팅해야합니다. 구성에서 제공하지 않으면 서비스는 환경 변수, JSON 파일 (.openai) 또는 환경 파일 (.env)에서 필요한 정보를 자동으로 조회합니다.
환경 변수의 예 :
OpenAi_Key 또는 OpenAi_api_key 또는 OpenAi_Secret_key 또는 test_openai_secret_key가 API 키를 확인합니다.
조직 키가 조직을 확인했습니다
JSON 파일의 예 :
{ "apikey": "your_api_key", "조직": "orgulation_id"}
환경 파일은이 형식 {key} = {value}의 키/값 쌍을 포함해야합니다.
' 키 '의 경우 위의 환경 변수에 설명 된 동일한 값 중 하나를 사용하십시오.
환경 파일의 예 :
openai_key = Your_api_key
조직 = 옵션 _your_organization
OpenAI 및 종속 서비스에는 종속성 주입을 사용하는 경우 수동으로 제공 될 수 있거나 발생합니다. 여러 개의 OpenAI 서비스 인스턴스를 동시에 사용해야하는 경우이 옵션에 다른 설정 및 인증 자격 증명을 개별적으로 제공해야합니다.
옵션에는 많은 URI 설정이 있으며 정상적으로 닿지 않았습니다. 가장 중요한 옵션은 Apikey 및 조직 ID를 포함하는 AuthenticationInfo 속성입니다.
또한 HTTPMessageHandlerFactory라는 추가 옵션이 있으며, 예를 들어 HTTPClient의 일부 동작을 무시하려는 경우 일부 특수한 경우 HTTPClient에 대한 HTTPMESSAGEHANDLER를 구성합니다.
LogRequestSandResponses라는 테스트 및 디버깅 목적으로 단지 내장 된 로깅 기능이 있으며, 이는 폴더 (LogRequestSandResponsesSESSFOLDER)의 모든 요청 및 응답을 지속합니다. 이 기능을 사용하면 낮은 레벨 메시지를 확인할 수 있습니다. 생산 환경에서 사용하는 것이 좋습니다.
API 기능에 대해 자세히 알아 보려면 API 키를 생성하려면 https://platform.openai.com/docs/api-Reference를 방문하십시오. https://platform.openai.com/account/api-keys
이 솔루션의 일부인 놀이터를 만들었습니다. 이 라이브러리가 제공하는 모든 기능을 다룹니다. 이 예제를 통해 자유롭게 실행하고 설정을 사용하십시오.
또한 여기에 Openai Playground가 있습니다. 여기에는 사용법에 대한 예제를 찾을 수 있습니다 : https://platform.openai.com/playground/p/default-chat?lang=node.js&mode=complete&model=text-davinciic 003
Azure-Openai 제공 업체를 사용하여 서비스를 설정하려면 Azure Openai 리소스의 이름과 모델 배포 ID를 지정해야합니다.
전제 조건 : https://learn.microsoft.com/en-us/azure/cognitive-services/openai/quickstart?tabs=command-line&pivots=programming-language-studio 문서화 : https://learn.microsoft.com/en-us/azure/cognitive-service/opresceation
예 : https://github.com/jzo001/forge.openai/blob/main/playgrounds/azure-openai_setup_example/program.cs