> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudThinker Language

> @agent #tool 문법 참조: 에이전트 멘션, 도구 태그, 컨텍스트 수정자, 모든 에이전트에 대한 프롬프트 패턴

CloudThinker Language는 모든 에이전트, 채팅, [Slack](/ko/guide/slack-integration), 자동화에서 동일하게 작동하는 구조화된 프롬프트 문법입니다. 에이전트를 언급하고, 원하는 출력에 태그를 달고, 일반 언어로 지시사항을 작성하세요.

## 문법

모든 프롬프트는 하나의 표준 형식을 따릅니다:

```text theme={null}
@agent #tool instruction
```

| 구성 요소         | 필수 여부 | 설명                                                 |
| ------------- | ----- | -------------------------------------------------- |
| `@agent`      | 예     | 요청을 특정 에이전트로 라우팅합니다. 교차 도메인 작업에는 여러 에이전트를 언급하세요.   |
| `#tool`       | 아니오   | 출력 형식 또는 기능. 멘션 바로 뒤에 배치하고, 여러 출력에는 태그를 조합하세요.     |
| `instruction` | 예     | 원하는 내용을 자신의 언어로 — 범위, 기간, 임계값, 제약 조건을 인라인으로 포함하세요. |

## 에이전트 멘션

| 멘션        | 역할              | 최적 용도                       |
| --------- | --------------- | --------------------------- |
| `@alex`   | 클라우드 엔지니어       | 비용 분석, 리소스 최적화, 멀티 클라우드 인프라 |
| `@oliver` | 보안 엔지니어         | 감사, 취약성 스캔, IAM, 컴플라이언스     |
| `@tony`   | 데이터베이스 엔지니어     | 쿼리 최적화, 성능 튜닝, 백업           |
| `@kai`    | Kubernetes 엔지니어 | 클러스터 관리, 파드 최적화, 스케일링       |
| `@anna`   | 총괄 매니저          | 멀티 에이전트 조율, 경영진 보고          |

각 에이전트의 전체 기능은 [에이전트 레퍼런스](/ko/guide/agents)를 참고하세요.

## 도구 태그

| 태그           | 출력                            | 예시                                                   |
| ------------ | ----------------------------- | ---------------------------------------------------- |
| `#dashboard` | 모니터링 및 프레젠테이션을 위한 인터랙티브 시각화   | `@alex #dashboard monthly cost trends with forecast` |
| `#report`    | 발견 항목과 증거가 포함된 상세 분석 문서       | `@oliver #report SOC 2 compliance assessment`        |
| `#recommend` | 구현 단계가 포함된 우선순위별 실행 가능한 추천 사항 | `@tony #recommend index changes for slow queries`    |
| `#alert`     | 정의한 조건에 대한 모니터링 알림            | `@kai #alert on pod OOMKilled events`                |
| `#chart`     | 독립형 데이터 시각화                   | `@alex #chart spending by service`                   |
| `#kb`        | 조직 문서 전체에 대한 지식 베이스 검색        | `@alex #kb cloud governance policies`                |

둘 이상의 출력을 원할 때는 태그를 조합하세요: `@alex #dashboard #recommend cost optimization opportunities`.

## 컨텍스트 수정자

지시사항 안에 컨텍스트를 추가하여 범위를 좁히고 정확도를 높이세요.

| 유형   | 예시                                                                    |
| ---- | --------------------------------------------------------------------- |
| 기간   | `over the last 30 days`, `since January`, `in the last 24 hours`      |
| 범위   | `in us-east-1`, `on the production cluster`, `on the orders database` |
| 임계값  | `with CPU below 15%`, `costing over $1,000/month`, `P95 above 500ms`  |
| 제외   | `excluding production-tagged resources`, `except backup buckets`      |
| 우선순위 | `prioritizing quick wins`, `critical severity first`                  |

## 프롬프트 패턴

| 패턴  | 형식                                           | 예시                                                                    |
| --- | -------------------------------------------- | --------------------------------------------------------------------- |
| 분석  | `@agent #tool analyze <target> <context>`    | `@alex analyze EC2 spending by instance family over the last quarter` |
| 감사  | `@agent #tool audit <target> for <criteria>` | `@oliver audit S3 buckets for public access and encryption`           |
| 최적화 | `@agent #recommend <target> <constraints>`   | `@kai #recommend HPA policies for variable workloads`                 |
| 조사  | `@agent investigate <issue> <scope>`         | `@tony investigate slow query performance on the orders table`        |
| 조율  | `@anna coordinate <project> with <agents>`   | `@anna coordinate quarterly review with @alex @oliver @tony @kai`     |

Slack에서는 봇 접두사와 함께 동일한 문법이 작동합니다: `@CloudThinker alex what's our AWS spend this week?` — [Slack 연동](/ko/guide/slack-integration)을 참고하세요.

## 예시

직접 요청 — 에이전트를 선택하고, 출력에 태그를 달고, 대상을 명시하세요:

```text theme={null}
@alex #dashboard AWS spending by service and region
@oliver #report SOC 2 compliance assessment with evidence
@tony #recommend index changes for queries slower than 500ms
```

컨텍스트 수정자를 쌓아 결과를 정밀하고 실행 가능하게 만드세요:

```text theme={null}
@alex #recommend right-sizing for EC2 instances in us-east-1 with CPU below 15% over the last 30 days, excluding production-tagged resources
```

교차 도메인 문제에는 여러 에이전트를 언급하세요:

```text theme={null}
@alex @tony investigate the cost spike on database infrastructure last week
@anna coordinate security remediation with @oliver leading and @alex @kai supporting
```

점진적으로 정제하세요 — 넓게 시작한 후 에이전트가 발견한 내용으로 드릴다운하세요:

```text theme={null}
@alex #dashboard cloud spending trends
@alex #chart November cost spike broken down by service
@alex #recommend RDS optimization prioritizing underutilized instances
```

<Tip>
  구체적으로 작성하세요. `@alex #recommend right-sizing for EC2 in us-east-1 with CPU below 15%`는 실행 가능한 답변을 얻고, `@alex check our servers`는 명확한 질문을 받게 됩니다.
</Tip>

## 관련 항목

<CardGroup cols={2}>
  <Card title="에이전트" icon="robot" href="/ko/guide/agents">
    각 에이전트의 전문성, 기능, 프롬프트 패턴 상세 설명
  </Card>

  <Card title="Capabilities" icon="wand-magic-sparkles" href="/ko/guide/capabilities">
    \#dashboard, #report, #recommend 등의 도구 태그가 생성하는 출력
  </Card>

  <Card title="Operations Hub" icon="play" href="/ko/guide/operations-hub">
    이 문법으로 실행할 준비가 된 사전 구축된 운영 작업
  </Card>

  <Card title="Slack 연동" icon="slack" href="/ko/guide/slack-integration">
    @CloudThinker 접두사로 Slack에서 동일한 문법 사용
  </Card>
</CardGroup>