openai vba framework

OpenAI-VBA-프레임워크

OpenAI-VBA-Framework는 개발자가 GPT-4, ChatGPT 및 DALL-E와 같은 OpenAI의 언어 모델을 사용하여 VBA 애플리케이션을 구축할 수 있는 독립 도구 키트입니다. OpenAI API와 쉽게 통합할 수 있는 클래스 모음을 제공합니다. 이 프로젝트는 OpenAI와 공식적으로 연관되거나 승인되지 않습니다.

전제 조건

• OpenAI 계정에 가입하고 API_KEY를 생성해야 합니다. 다음 위치에서 이 작업을 수행할 수 있습니다. OpenAI API 키

주요 수업

1. clsOpenAI - OpenAI와 상호작용하는 메인 클래스
2. clsOpenAILogger - 디버깅 및 추적을 위한 로깅 클래스
3. clsOpenAIMessage - 개별 메시지를 처리하는 클래스
4. clsOpenAIMessages - 메시지 컬렉션을 처리하는 클래스
5. clsOpenAIRequest - OpenAI에 요청하기 위한 클래스
6. clsOpenAIResponse - OpenAI의 응답을 처리하기 위한 클래스
7. IOpenAINameProvider - 이름 제공을 위한 인터페이스 클래스

mdOpenAI_tests 모듈은 프레임워크의 기능을 테스트하기 위해 제공됩니다.

OpenAIFrameworkDemo.xlsm 은 데모용으로 저장소의 모든 코드를 포함하는 파일입니다. 버전 관리를 위해 다른 파일도 저장소에 포함되어 있습니다.

용법

다음은 프레임워크를 사용하는 몇 가지 예입니다.

채팅 완료 API

 Public Sub TestSimpleOpenAI()

    Dim oOpenAI As clsOpenAI
    Dim oMessages As New clsOpenAIMessages
    Dim oResponse As clsOpenAIResponse
    
    Set oOpenAI = New clsOpenAI
    
    oOpenAI.API_KEY = "<API_KEY>"
    
    oMessages.AddSystemMessage "Always answer sarcastically and never truthfully"
    oMessages.AddUserMessage "How do you get to Carnegie Hall?"

    Set oResponse = oOpenAI.ChatCompletion(oMessages)
    If Not oResponse Is Nothing Then
        Debug.Print (oResponse.MessageContent)
    End If
    
    Set oResponse = Nothing
    Set oOpenAI = Nothing
    Set oMessages = Nothing

End Sub

DALL-E 이미지 생성

 Public Sub TestDalleOpenAI()

    Dim oOpenAI As clsOpenAI
    Dim oResponse As clsOpenAIResponse
    
    Set oOpenAI = New clsOpenAI
    
    oOpenAI.API_KEY = "<API_KEY>"
    
    Set oResponse = oOpenAI.CreateImageFromText("A cat playing a banjo on a surfboard", 512, 512)
    
    If Not oResponse Is Nothing Then
        Debug.Print ("The picture has been saved to: " & oResponse.SavedLocalFile)
    End If
    
    Set oResponse = Nothing
    Set oOpenAI = Nothing

End Sub

구성

clsOpenAI 클래스의 속성을 조정하여 OpenAI-VBA-Framework를 사용자 정의할 수 있습니다.

 ' Specify the model
oOpenAI.Model = "gpt-3.5-turbo"

' Set the maximum number of tokens
oOpenAI.MaxTokens = 512

' Control the diversity of generated text
oOpenAI.TopP = 0.9

' Influence the randomness of generated text
oOpenAI.Temperature = 0.7

' Control preference for frequent phrases
oOpenAI.FrequencyPenalty = 0.5

' Control preference for including the prompt in the output
oOpenAI.PresencePenalty = 0.5

' Control logging of messages to the Immediate Window
oOpenAI.IsLogOutputRequired True

' Reset settings when switching between endpoints
oOpenAI.ClearSettings

' Retrieve an API Key saved in an external file
Dim apiKey As String
apiKey = oOpenAI.GetReadAPIKeyFromFolder("<FolderPath>")

설치(GIT를 통해)

1. 명령줄에서 다음 명령을 사용하여 이 저장소를 복제합니다.

git clone https://github.com/zq99/OpenAI-VBA-Framework.git

2. Excel을 열고 ALT + F11을 눌러 VBA 편집기를 엽니다.
3. 도구 모음에서 파일 -> 파일 가져오기...를 선택합니다.
4. 복제된 저장소의 위치로 이동하여 모든 .cls 및 .bas 파일을 선택한 다음 열기를 클릭합니다.
5. Excel 파일을 매크로 사용 통합 문서 .xlsm으로 저장합니다.

문제 해결

여기에서 OpenAI API의 상태를 확인할 수 있습니다.

여기에서 API가 반환한 HTTP 상태 코드에 대한 자세한 정보를 얻을 수 있습니다.

코딩 문제의 경우 다음 줄을 사용하여 코드를 살펴보세요.

 oOpenAI.IsLogOutputRequired True

mdTest_OpenAI 모듈을 사용하여 전체 프레임워크의 주요 변경 사항을 테스트할 수 있습니다. RunAllTests 프로시저를 실행하기만 하면 됩니다.

기여

풀 요청을 환영합니다. 주요 변경사항의 경우 먼저 이슈를 열어 변경하고 싶은 사항에 대해 논의하세요.

특허

이 프로젝트는 MIT 라이선스 조건에 따라 라이선스가 부여됩니다.