Asana

• AI 에이전트가 이벤트나 사용자 요청에 응답하여 Asana 작업 및 프로젝트를 생성하거나 업데이트하도록 하고 싶을 때.
• 프로젝트와 워크스페이스 전반에 걸쳐 작업 상태, 담당자 또는 마감일을 프로그래밍 방식으로 조회해야 할 때.
• 작업이 변경될 때 외부 시스템에 알림이 전송되도록 Asana 웹훅을 설정하고 싶을 때.
• OAuth 자격 증명을 직접 관리하지 않고 Asana에서 읽거나 쓰는 워크플로 자동화를 구축할 때.

• Asana 이외의 서드파티 앱과 통합해야 하는 경우 — 대신 api-gateway skill을 사용하세요.
• Asana 플랜이 무료 티어이고 고급 검색이 필요한 경우 (작업 검색은 Asana 프리미엄 구독이 필요합니다).

모든 요청은 Maton 게이트웨이(gateway.maton.ai)를 통해 프록시되며, Asana OAuth 토큰이 자동으로 주입됩니다. MATON_API_KEY 하나만 있으면 되며, OAuth 설정, 토큰 갱신 로직, 또는 자격 증명 저장이 필요하지 않습니다.

모든 프로젝트에서 작업을 생성, 조회, 수정 및 삭제할 수 있습니다. 담당자, 완료 날짜, 프로젝트 GID별 필터링을 지원하며, 상위 작업 하위에 하위 작업을 생성하고 목록을 확인하는 기능도 제공합니다.

워크스페이스 내 프로젝트를 나열, 생성, 업데이트 및 삭제합니다. 프로그래밍 방식으로 사용자를 추가하거나 제거하여 워크스페이스 멤버십을 관리합니다.

워크스페이스, 팀 또는 개별 GID로 사용자를 검색합니다. /users/me 엔드포인트를 사용하여 현재 인증된 사용자를 조회합니다.

작업이나 프로젝트가 변경될 때 실시간 알림을 받기 위해 Asana webhook을 생성, 목록 조회, 업데이트 및 삭제합니다. 리소스 유형, 작업 및 특정 필드별 필터링을 지원합니다.

offset 매개변수를 통해 Asana의 기본 커서 기반 페이지네이션을 사용하여 대용량 결과 집합을 처리합니다. 응답에는 간편한 반복 처리를 위한 next_page 객체가 포함됩니다.

AI 에이전트가 사용자 요청(예: "금요일까지 Q2 보고서를 검토하는 작업을 Alice에게 생성해줘")을 받으면 이 스킬을 호출하여 올바른 담당자와 마감일이 설정된 작업을 해당 Asana 프로젝트에 자동으로 생성합니다 — 수동 입력이 전혀 필요하지 않습니다.

에이전트가 프로젝트의 모든 작업을 조회하고, 완료 상태와 마감일을 기준으로 필터링한 후, 팀 스탠드업을 위한 자연어 형태의 상태 요약 또는 대시보드 업데이트를 생성합니다.

다른 시스템에서 티켓이 종료되면, 상담원은 이 스킬을 사용하여 해당 Asana 작업을 완료로 표시하고 완료 메모를 추가함으로써 두 시스템을 동기화 상태로 유지합니다.

에이전트가 Asana 프로젝트에 webhook을 등록하여, 작업의 마감일이나 완료 상태가 변경될 때마다 다운스트림 파이프라인이 자동으로 트리거되도록 합니다.