contoso creative writer
1.0.0
| page_type | 언어 | 제품 | urlfragment | 이름 | 설명 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
견본 |
|
| Contoso-chreative-writer | Creative Writing Assistant -Prestty (Python 구현)를 사용하여 에이전트와 협력 | Python과 함께 Azure Openai Agent를 사용하여 Bing Search API 및 Azure AI 검색을 통합하여 사용자 주제 및 명령을 기반으로 기사를 만듭니다. |
터미널 창을 엽니 다.
Azure 계정에 로그인하십시오. Azure 개발자 CLI 및 Azure CLI에 로그인해야합니다.
나. Azure Developer CLI와 함께 먼저
azd auth loginII. 그런 다음 Azure Cli로 로그인하십시오
az login --use-device-code리소스를 제공하고 코드를 배포하십시오.
azd up 위치를 포함하여 배포 된 리소스에 대한 세부 정보를 선택하라는 메시지가 표시됩니다. 알림으로 우리는이 프로젝트의 지역으로 캐나다 이스트를 추천합니다. 배포가 완료되면 터미널에서 스크롤하여 앱이 배포 된 URL을 볼 수 있어야합니다. 이 Ingress Updated. Access your app at https://env-name.codespacesname.eastus2.azurecontainerapps.io/ . 링크로 이동하여 앱을 바로 시도하십시오!
위의 단계가 완료되면 샘플을 테스트 할 수 있습니다.
관련 옵션은 VS Code Dev 컨테이너이며, Dev Containers 확장을 사용하여 로컬 대 코드에서 프로젝트를 열 것입니다.
Docker Desktop 시작 (아직 설치되지 않은 경우 설치)
프로젝트 열기 :
열리는 VS 코드 창에서 프로젝트 파일이 나타나면 (몇 분이 걸릴 수 있음) 터미널 창을 엽니 다.
필수 패키지 설치 :
cd src/api
pip install -r requirements.txt이 단계를 완료 한 후에는 배포로 이동합니다.
참고 Windows 사용자의 경우 : 이 샘플을 실행하기 위해 컨테이너를 사용하지 않는 경우, 우리의 후크는 현재 쉘 스크립트입니다. 업데이트 작업을 수행하는 동안이 샘플을 올바르게 프로비저닝하려면 Git Bash를 사용하는 것이 좋습니다.
새 폴더를 만들고 터미널에서 전환 한 다음이 명령을 실행하여 프로젝트 코드를 다운로드하십시오.
azd init -t agent-openai-python-prompty이 명령은 git 저장소를 초기화 하므로이 저장소를 복제 할 필요가 없습니다.
필수 패키지 설치 :
cd src/api
pip install -r requirements.txt코드 스페이스, 개발자 컨테이너 또는 로컬에서 프로젝트를 열면 Azure에 배포 할 수 있습니다.
Azure 계정에 로그인하십시오. Azure 개발자 CLI 및 Azure CLI에 로그인해야합니다.
나. Azure Developer CLI와 함께 먼저
azd auth loginII. 그런 다음 Azure Cli로 로그인하십시오
az login --use-device-code 해당 명령에 문제가 있으면 azd auth login --use-device-code 시도 할 수도 있습니다.
이 배포에 대한 구성을 저장하기 위해 프로젝트에서 .azure/ 아래에 폴더가 생성됩니다. 원하는 경우 여러 AZD 환경이있을 수 있습니다.
리소스를 제공하고 코드를 배포하십시오.
azd up 이 프로젝트는 gpt-35-turbo-0613 , gpt-4-1106-Preview 및 gpt-4o-2024-05-13 사용하여 모든 Azure 지역에서 사용할 수 없습니다. 최신 지역 가용성을 확인하고 배포 중에 지역을 선택하십시오. 이 프로젝트에는 캐나다 동부를 사용하는 것이 좋습니다.
AZD UP을 실행 한 후 Github Setup 중에 다음 질문을받을 수 있습니다.
Do you want to configure a GitHub action to automatically deploy this repo to Azure when you push code changes ?
(Y/n) Y 필요한 단계가 아니기 때문에 N 으로 응답해야하며 설정하는 데 시간이 걸립니다.
이 샘플 리포지토리에는 각 에이전트의 하위 폴더가 포함 된 에이전트 폴더가 포함되어 있습니다. 각 에이전트 폴더에는 에이전트의 프롬프트가 정의되는 프롬프트 파일과 실행하는 데 사용되는 코드가있는 Python 파일이 포함되어 있습니다. 이 파일을 탐색하면 각 에이전트가 수행하는 작업을 이해하는 데 도움이됩니다. 에이전트의 폴더에는 전체 흐름을 실행하고 기사를 만드는 데 사용할 수있는 orchestrator.py 파일도 포함되어 있습니다. azd up 운영하면 제품 카탈로그가 Azure AI 검색 벡터 저장소에 업로드되었고 인덱스 이름 contoso-products 생성되었습니다.
샘플을 테스트하려면 :
FastApi 서버를 사용하여 예제 웹 앱을 로컬로 실행하십시오.
먼저 SRC/API 폴더로 이동하십시오
cd ./src/apiFastapi 웹 서버를 실행하십시오
fastapi dev main.py 중요 참고 사항 : Codespace에서 실행중인 경우 API의 8000 및 5173 포트의 가시성을 VS Code Terminal의 PORTS 탭에서 public 로 변경해야합니다. 포트 탭은 다음과 같습니다.
브라우저에서 서버 링크를 열면 URL이 발견되지 않은 오류가 표시됩니다. 이는 Fastapi에서 홈 URL 경로를 만들지 않았기 때문입니다. 대신 에이전트 워크 플로우를 실행하는 get_article.py 파일에 컨텍스트와 지침을 직접 전달하는 데 사용되는 /get_article 경로를 만들었습니다.
(선택 사항) 다음에 실행할 웹 인터페이스를 만들었지 만 브라우저에서이를 실행하여 API를 테스트 할 수 있습니다.
http://127.0.0.1:8080/get_article?context=Write an article about camping in alaska&instructions=find specifics about what type of gear they would need and explain in detail
Fastapi 서버가 실행되면 이제 웹 앱을 실행할 수 있습니다. 이를 위해 새 터미널 창을 열고이 명령을 사용하여 웹 폴더로 이동하십시오.
cd ./src/web먼저 노드 패키지 설치 :
npm install그런 다음 로컬 데브 웹 서버로 웹 앱을 실행하십시오.
npm run dev이렇게하면 앱을 시작하여 예제 컨텍스트 및 지침을 사용하여 시작할 수 있습니다. '크리에이티브 팀'페이지에서 각 에이전트를 클릭하여 각 에이전트의 출력을 검사 할 수 있습니다. 앱은 다음과 같아야합니다.
선택한 기사를 만들려면 지침과 컨텍스트를 변경하십시오.
디버깅 목적으로 오케스트레이터 로직을 사용하여 파이썬으로 테스트 할 수 있습니다.
오케스트레이터 로직 만 사용하여 샘플을 실행하려면 다음 명령을 사용하십시오.
cd ./src/api
python -m orchestrator
Prompty Tracing 서버를 활성화하려면 :
export LOCAL_TRACING=true
그런 다음 오케스트레이터를 시작하십시오.
cd ./src/api
python -m orchestrator
기사가 생성 된 것을 볼 수 있으면 .runs 폴더가 ./src/api 에 나타납니다. 이 폴더를 선택하고 .tracy 파일을 클릭하십시오. 이것은 기사를 생성하기 위해 호출 된 모든 파이썬 기능을 보여줍니다. 각 섹션을 살펴보고 찾을 수있는 유용한 정보를 확인하십시오.
Contoso Creative Writer는 평가자를 사용하여 응용 프로그램 응답 품질을 평가합니다. 이 프로젝트의 평가자가 평가하는 4 가지 메트릭은 일관성, 유창성, 관련성 및 근거입니다. 사용자 정의 evaluate.py .
cd ./src/api
python -m evaluate.evaluatesrc/api/evaluate/eval_inputs.jsonl 파일을여십시오.이 템플릿은 Repo를 변경할 때 CI/CD를 실행하도록 설정되었습니다. CI/CD가 구성되면 GITHUB 작업에서 평가가 GitHub 작업에서 자동으로 배포됩니다.
저장소에서 GitHub 작업으로 CI/CD를 설정하려면 다음 명령을 실행하십시오.
azd pipeline config 이 템플릿은 gpt-35-turbo-0613 , gpt-4-1106-Preview 및 gpt-4o-2024-05-13 사용하여 모든 Azure 영역에서 사용할 수 없습니다. 최신 지역 가용성을 확인하고 배포 중에 지역을 선택하십시오.
Azure의 가격 계산기 로이 프로젝트 아키텍처 비용을 추정 할 수 있습니다.
메모
이 템플릿을 구현할 때 템플릿이 관리 된 ID 또는 키 금고를 사용하는지 여부를 지정하십시오.
이 템플릿에는 개발자가 이러한 자격 증명을 관리 할 필요가 없도록 관리 된 ID 또는 Key Vault가 내장되어 있습니다. 응용 프로그램은 관리 된 ID를 사용하여 자격 증명을 관리하지 않고도 Microsoft Entra 토큰을 얻을 수 있습니다. 또한 인프라로 코드 파일을 스캔하고 감지 된 문제가 포함 된 보고서를 생성하는 GitHub 액션 도구를 추가했습니다. 저장소의 모범 사례를 보장하기 위해 템플릿을 기반으로 솔루션을 만드는 사람이라면 REPOS에서 GitHub 비밀 스캔 설정이 활성화되도록 권장합니다.
이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다.
자원:
자세한 내용은 추가 질문이나 의견이 있으면 행동 강령 FAQ 또는 [email protected]에 문의하십시오.
이 프로젝트는 책임있는 AI 가이드 라인 및 모범 사례 아래에 있습니다.이 프로젝트를 사용하기 전에 검토하십시오.
