Arcade 도우미(베타) 사용

Arcade 도우미(베타)는 인공 지능(AI)을 사용하여 자연어로 입력한 명령어에서 ArcGIS Arcade 식을 생성합니다.

Arcade는 레이어 스타일 지정, 팝업 구성, 레이블 구성과 같은 다양한 매핑 컨텍스트에서 커스텀 데이터 기반 콘텐츠를 생성하는 데 사용할 수 있습니다. 예를 들어, Arcade를 사용하여 정의한 데이터 값 및 임계값을 기반으로 레이어의 기존 필드에서 새 정보를 동적으로 표시할 수 있습니다. 다른 코딩 언어와 마찬가지로 Arcade 식의 오류를 작성하고 진단하는 데 시간이 소요될 수 있습니다. Arcade 도우미(베타)는 코드를 작성하지 않고도 식 또는 식의 일부를 생성하여 이 프로세스의 효율성을 높이는 데 도움이 될 수 있습니다.

비고:

크레딧 소비, 보안 및 개인정보보호정책, 제한 사항 및 편향 등 도우미에 대한 자세한 내용은 Arcade 도우미(베타)를 참고하세요.

도우미 사용

Arcade 도우미(베타)는 자연어를 사용하여 Arcade 코드를 생성합니다. 최상의 결과를 얻으려면 명확하고 쉬운 언어를 사용하고 수신한 응답을 반복 처리하세요.

비고:

ArcGIS Online 도우미는 기관 수준에서 관리되며 관리자가 비활성화할 수 있습니다.

도우미를 사용하려면 다음을 수행합니다.

1. 기관에 로그인했는지 확인합니다.
2. 앱 실행 프로그램 을 클릭하고 Map Viewer를 선택합니다. 열리는 새 맵을 사용하여 맵에 레이어를 추가하거나 기존 맵을 엽니다.
3. 스타일, 팝업, 레이블 피처 창에서 속성 식 편집기 창을 엽니다.

   비고:

   식을 사용하여 레이어에 스타일을 지정하는 방법에 대한 자세한 내용은 스타일 적용을 참고하세요. 식을 사용하여 팝업을 구성하려면 식 사용을 참고하세요. 식을 사용하여 레이블을 구성하려면 레이블 적용을 참고하세요.

4. Arcade 도우미 를 클릭합니다.

   Arcade 도우미 창이 열립니다.

5. 다음 중 하나를 수행하여 도우미를 사용합니다.
   • 제안을 클릭하고 수정하여 데이터에 맞는 프롬프트를 생성합니다.
   • 원하는 언어로 프롬프트를 입력하여 Arcade 식을 생성합니다.
6. 생성을 클릭하여 쿼리를 수행합니다.

   Arcade 도우미(베타)는 Arcade 도우미 창을 통해 식을 제안합니다.

   팁:

   프로파일 컨텍스트 버튼 위에 마우스를 놓으면 제안된 식이 레이어 구성에서 어느 위치에 적용될지 확인할 수 있습니다. 레이어 컨텍스트 버튼 위에 마우스를 놓으면 도우미에 제공되어 제안된 식을 생성하는 데 사용되는 레이어 메타데이터를 확인할 수 있습니다.

7. 제안과 상호작용하려면 다음 중 하나를 수행합니다.
   • 편집기에 추가를 클릭하여 식 빌더 창에 식을 추가합니다.

     팁:

     식 빌더 창에서 콘텐츠를 추가할 위치에 커서를 놓습니다. 예를 들어, 식 빌더 창에서 커서를 이동하여 기존 코드 라인 앞을 클릭합니다. Arcade 도우미 창에서 편집기에 추가를 클릭하면 제안된 식이 식 빌더 창의 커서 위치에 추가됩니다.

   • 편집기의 모든 코드 교체 를 클릭하여 식 빌더 창의 기존 콘텐츠를 제안된 식으로 교체합니다.
   • 코드를 클립보드에 복사 를 클릭하여 제안된 식을 클립보드에 복사합니다.
   • 프롬프트를 조정하려면 텍스트 영역에서 이전 프롬프트를 편집하거나 이전 프롬프트를 복사하여 붙여넣은 다음, 세부 조정을 클릭하여 수정된 쿼리를 제출합니다.
   • 도우미에 대한 피드백을 제공하려면 유용함 또는 유용하지 않음 버튼을 클릭하고 현장조사를 완료합니다. 피드백은 향후 개발 시 참고 자료로 사용됩니다.

모범 사례 이해

다음은 Arcade 도우미(베타)를 사용하여 Arcade 식을 생성하는 데 도움이 되는 지침입니다.

• 요청 사항을 명확하고 간결하게 작성합니다.
• 모호하고 불분명한 표현을 지양합니다.
• 정확한 필드 이름을 사용할 필요는 없지만, 충분한 세부정보를 제공하는 것을 권장합니다.

팁:

레이블을 구성하는 식을 생성할 때 효과적인 프롬프트와 비효과적인 프롬프트의 예시는 다음을 참고하세요.

• 효과적인 프롬프트: "각 카운티에 작년 총 밀 수확량을 나타내는 레이블을 표시해 줘. 카운티에서 밀을 생산하지 않은 경우 레이블을 표시하지 말아줘." 이 프롬프트는 명확하고 간결하며 실행 가능하므로 효과적입니다.
• 비효과적인 프롬프트: "피처에 사용할 레이블을 선택해 줘." 이 프롬프트는 도우미가 피처에 레이블을 지정하는 방법을 선택하지 않으므로 비효과적입니다. 도우미는 작성자의 명령어에 따라서만 식을 생성합니다. 맵 작성자는 레이블을 지정할 피처 및 레이블을 지정할 방법을 결정한 다음, 도우미에게 목표를 달성할 식을 생성하라고 요청해야 합니다.

컨텍스트 제한 사항

Arcade 도우미(베타)를 사용할 때 다음 제한 사항을 고려하세요.

• 도우미는 챗봇이 아닙니다. 이전 프롬프트에 입력한 정보를 기억하지 않습니다. 이전 프롬프트를 세부 조정할 때는 도우미에게 처음 질문하는 것처럼 모든 관련 세부정보를 포함해야 합니다.

  팁:

  효과적인 프롬프트 시퀀스와 비효과적인 프롬프트 시퀀스의 예시는 다음을 참고하세요.

  • 효과적인 프롬프트 시퀀스:
    • "각 행이 모집단 필드인 HTML 테이블을 생성해 줘." 도우미가 테이블을 생성하지만 형식은 지정하지 않습니다.
    • "각 행이 모집단 필드인 HTML 테이블을 생성해 줘. 숫자는 쉼표로 형식을 지정해 줘." 필드 형식 지정을 요청하는 추가 세부정보와 함께 HTML 테이블을 생성하는 컨텍스트가 유지되어 효과적인 프롬프트 시퀀스가 ​​됩니다.
  • 비효과적인 프롬프트 시퀀스:
    • "각 행이 모집단 필드인 HTML 테이블을 생성해 줘."
    • 이제 숫자는 쉼표로 형식을 지정해 줘." 이제 HTML 테이블을 생성하는 컨텍스트가 없어졌기 때문에 비효과적인 프롬프트 시퀀스가 ​​됩니다.

• 도우미는 전에 생성한 Arcade 식이나 Arcade 편집기 또는 웹 맵의 기존 식을 인식하지 못합니다.

  팁:

  효과적인 프롬프트와 비효과적인 프롬프트의 예시는 다음을 참고하세요.

  • 효과적인 프롬프트: "이 식을 간소화해 줘: <여기에 식 삽입>." 이 프롬프트는 도우미가 식을 생성할 수 있도록 사용자가 충분한 컨텍스트를 제공하므로 효과적입니다.
  • 비효과적인 프롬프트: "편집기에서 식을 간소화해 줘." 이 프롬프트는 도우미가 편집기에서 식을 인식하지 못하므로 비효과적입니다.

• 도우미는 데이터를 쿼리하지 않습니다. 이러한 이유로 식을 생성할 대상 레이어에 존재하는 특정 데이터 값을 인식하지 못합니다. 도우미가 데이터 값을 기반으로 조건문을 작성하도록 하려면 프롬프트에 해당 값을 제공하거나 대규모 언어 모델에 값을 가정하도록 허용해야 합니다.

  팁:

  효과적인 프롬프트와 비효과적인 프롬프트의 예시는 다음을 참고하세요.

  • 효과적인 프롬프트: "점수가 100점을 넘으면 '좋음'을 반환해 줘. 점수가 75점을 넘으면 '보통'을 반환해 줘. 점수가 20점에서 75점 사이이면 '나쁨'을 반환해 줘. 점수가 20점 미만이면 '매우 나쁨'을 반환해 줘." 이 프롬프트는 값이 구체적이고 범주가 정의되어 있으므로 효과적입니다.
  • 비효과적인 프롬프트: "네츄럴 브레이크를 사용해서 점수 필드를 '좋음', '보통', '나쁨', '매우 나쁨'의 범주로 분류해 줘." 이 프롬프트는 도우미가 분류할 값의 범위를 알지 못하므로 비효과적입니다.

• 도우미를 사용하여 맵의 다른 레이어를 검색, 참조, 쿼리할 수 없습니다. 도우미가 아는 유일한 맥락은 식을 실행하는 레이어의 필드 이름과 별칭입니다. 또한 도우미는 레이어와 연관될 수 있는 첨부 파일 및 릴레이트 테이블을 인식하지 못합니다. 이러한 이유로 FeatureSet 함수를 사용한 식 생성은 제한적으로 지원됩니다. 다른 레이어의 데이터에 접근하려면 도우미가 식에 포함할 정보를 알 수 있도록 레이어 제목 또는 항목 ID를 입력해야 합니다. 이러한 정보를 입력하지 않으면 도우미가 제목 또는 ID를 생성하는데, 이때 생성한 식이 식 빌더 창에 추가될 때 사용자가 수동으로 교체해야 합니다.

  팁:

  효과적인 프롬프트와 비효과적인 프롬프트의 예시는 다음을 참고하세요.

  • 효과적인 프롬프트: "워싱턴주 경계 내에서 발생한 사건 수를 반환해 줘. us_states_2000 레이어의 NAME 필드를 사용하여 이 계산을 수행해 줘." 이 프롬프트는 식을 생성할 때 사용해야 하는 특정 지리적 경계 및 맵의 레이어를 정의하므로 효과적입니다.
  • 비효과적인 프롬프트: "워싱턴에서 발생한 사건 수를 반환해 줘." 이 프롬프트는 워싱턴주 또는 워싱턴 D.C. 중 어디를 지칭하는지 불확실하므로 비효과적입니다. 또한 쿼리를 수행할 때 맵에서 어떤 레이어를 사용해야 하는지도 불확실합니다.