대화형 작업이 2023년 6월 13일에 지원 중단되었습니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
빌드 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
대화형 액션을 빌드하려면 다음 구성요소를 만들고 배포합니다.
- 작업 프로젝트: 모든 대화형 작업, 웹 서비스, 웹 앱의 논리적 컨테이너입니다. 또한 Google 어시스턴트의 작업에 프로젝트를 배포하는 방법을 설명하는 프로젝트 설정과 리소스도 정의합니다.
- 호출 모델 - 사용자가 프로젝트 내에서 작업을 검색하고 시작하는 방법을 정의합니다. 인텐트와 유형으로 호출 모델을 빌드합니다.
- 대화 모델 - 사용자가 작업에 말할 수 있는 내용과 작업이 사용자에게 응답하는 방식을 정의합니다. 인텐트, 유형, 장면, 프롬프트를 사용하여 대화형 모델을 빌드합니다.
- 웹훅 - 액션은 웹훅을 트리거하여 프롬프트 생성, 데이터 검증 등 추가 로직을 이행 서비스에 위임할 수 있습니다.
- Interactive Canvas - 간단한 텍스트 응답이나 리치 카드 및 이미지를 전송하는 대신 HTML, CSS, JavaScript로 구동되는 전체 화면의 양방향 웹 앱을 제공할 수 있습니다.
다음 섹션에서는 작업을 빌드하는 데 사용하는 도구를 설명합니다.
작업
Actions API는 Google 어시스턴트용 작업을 빌드하기 위한 개발자 도구 집합입니다. 다음 기능으로 구성됩니다.
작업 프로젝트의 개방형 파일 기반 표현 - 인텐트, 유형, 장면, 프롬프트를 사용하여 호출 및 대화 모델을 빌드합니다. 좋아하는 텍스트 편집기로 Actions 프로젝트를 수정하고, 소스 제어에 체크인하고, 자동화된 프로세스를 빌드하는 등의 작업을 할 수 있습니다.
명령줄 인터페이스 (CLI) - gactions 도구는 작업 개발을 부트스트랩하고 자동화하는 CLI를 제공합니다. 표준 작업 프로젝트 파일을 초기화하고, Actions 콘솔로 업데이트를 푸시하고, 작업 프로젝트를 배포하는 등의 작업을 할 수 있습니다. 이 도구를 사용하면 기존 프로젝트 가져오기, 즐겨 사용하는 소스 관리 시스템을 사용하여 기능 브랜치에서 작업 시작 등 일반적인 워크플로를 많이 실행할 수 있습니다.
Actions API - Actions API는 gactions 도구에서 사용하는 API와 동일합니다. Actions API는 테스트 및 빌드를 비롯한 작업을 관리하는 REST 엔드포인트 목록을 제공합니다. 이 API를 사용하면 JSON 요청을 사용하여 여러 일반적인 워크플로를 실행할 수 있습니다. Actions API를 사용하는 경우 고려해야 할 특정 한도와 권장사항이 있습니다.
웹훅 및 Node.js 처리 라이브러리 - 작업은 웹훅과 JSON 기반 메시지 형식을 사용하여 비즈니스 로직을 웹 서비스에 위임할 수 있습니다. 대화 웹훅에 관용적 인터페이스를 제공하는 Node.js 처리 라이브러리가 제공됩니다. 이 라이브러리를 사용하면 일반적인 사용자 흐름을 쉽게 구현할 수 있습니다. 예를 들어 일부 기능에는 사용자 쿼리에서 매개변수를 추출하고 Google 어시스턴트를 위한 멀티모달 환경(음성 전용 및 음성 및 시각적 요소)을 생성하는 기능이 포함됩니다.
Actions Builder
Actions Builder는 Actions 콘솔에 통합된 강력하고 사용하기 쉬운 웹 기반 IDE를 제공합니다. Actions Builder는 Actions API와 동일한 기술을 기반으로 빌드되므로 필요에 따라 단독으로 또는 Actions API와 함께 사용할 수 있습니다.
Actions Builder UI는 다음 영역으로 나뉩니다.
- 상단 메뉴를 통해 Actions 콘솔의 다양한 영역에 액세스할 수 있으며 개발 탭에서 Actions Builder에 액세스할 수 있습니다.
- 왼쪽 메뉴를 사용하면 인텐트, 장면과 같은 작업을 빌드하는 데 필요한 모든 구성요소에 액세스할 수 있습니다.
- 빌드 영역을 사용하면 작업 중인 구성요소를 빌드할 수 있습니다.
- 세부정보 영역에서는 작업 중인 구성요소에 관한 세부정보를 더 많이 구성할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-24(UTC)
[null,null,["최종 업데이트: 2025-07-24(UTC)"],[[["\u003cp\u003eConversational Actions are built using an Actions project, an invocation model, a conversation model, webhooks, and optionally Interactive Canvas.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the Actions API, which includes an open file-based project representation, a command-line interface, a REST API, and webhook support with a Node.js library.\u003c/p\u003e\n"],["\u003cp\u003eActions Builder provides a web-based IDE within the Actions console, offering a user-friendly interface for building and managing conversational actions, integrated with the Actions API.\u003c/p\u003e\n"]]],[],null,["# Build overview\n\nTo build Conversational Actions, you create and deploy the following components:\n\n- **[Actions project](/assistant/conversational/build/projects)** - The logical container for all of your Conversational Actions, web services, and web apps. It also defines project settings and resources that describe how to deploy your project to Actions on Google.\n- **[Invocation model](/assistant/conversational/build/invocation)** - Defines how users discover and start the Actions inside your project. You build your invocation model with [intents](../intents) and [types](../types).\n- **[Conversation model](/assistant/conversational/build/conversation)** - Defines what users can say to your Actions and how your Actions respond to users. You build your conversational model with [intents](../intents), [types](../types), [scenes](../scenes), and [prompts](../prompts).\n- **[Webhooks](../webhooks)** - Actions can trigger webhooks to delegate additional logic to your fulfillment services, like generating prompts, validating data, and more.\n- **[Interactive Canvas](/assistant/interactivecanvas)** - Instead of sending simple text responses or rich cards and images, you can deliver a full-screen, interactive web app powered by HTML, CSS, and JavaScript.\n\nThe following sections describe the tools that you'll use to build Actions.\n\n### Actions\n\nThe Actions API is a set of developer tools for building Actions for the\nGoogle Assistant. It consists of the following features:\n\n- **An open, file-based representation of an Actions project** - Build your\n invocation and conversation models with\n [intents](/assistant/conversational/intents),\n [types](/assistant/conversational/types),\n [scenes](/assistant/conversational/scenes), and\n [prompts](/assistant/conversational/prompts). You can edit your Actions\n projects with your favorite text editor, check them into source control, build\n automated processes, and more.\n\n- **A command-line interface (CLI)** - The\n [`gactions` tool](/assistant/actionssdk/gactions) provides a CLI to bootstrap and\n automate development of your Actions. It lets you initialize standard Action\n project files, push updates to the Actions console, deploy Action projects,\n and more. The tool lets you perform many common workflows, such as importing\n existing projects or starting work on a feature branch using your favorite\n source control system.\n\n- **The Actions API** - The Actions API is the same API used by\n the `gactions` tool. The Actions API provides a list of REST endpoints to\n manage your Actions, including for testing and building. The API lets you use\n JSON requests to perform many common workflows. When\n [using the Actions API](/assistant/actions/api) there are\n certain limits and best practices that you should consider.\n\n- **Webhooks and a Node.js fulfillment library** - Your Actions can delegate\n business logic to your web services with webhooks and a JSON based messaging\n format. We provide a Node.js fulfillment library that provides idiomatic interfaces for the\n [Conversation Webhook](/assistant/conversational/webhooks). This library makes it\n easy to implement many common user flows. For example, some features include\n extracting parameters from a user query and generating a multimodal experience\n (voice only and voice and visuals) for Google Assistant.\n\n### Actions Builder\n\nActions Builder gives you a powerful and easy-to-use, web-based IDE that's\nintegrated into the Actions console. Since Actions Builder is built on the\nsame technologies as the Actions API, you can use it on its own or together with\nthe Actions API depending on your needs. \n\nThe Actions Builder UI is split into the following areas:\n\n1. The top menu provides access to the different areas of the Actions console, and you can access Actions Builder on the **Develop** tab.\n2. The left menu lets you access all the components to build Actions, like intents and scenes.\n3. The build area lets you build the component you're working on.\n4. The details area lets you configure more details about the component you're working on."]]
