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

# CometAPI와 함께 Agno 사용하기

> 이 가이드를 사용해 CometAPI model provider, API 키, model ID로 Agno 에이전트를 CometAPI에 연결하세요.

[Agno](https://docs.agno.com/)를 사용하면 Python에서 AI 에이전트를 빌드하고 실행할 수 있습니다. Agno에는 공식 `CometAPI` model provider가 포함되어 있으므로, 커스텀 어댑터를 만들지 않고도 `agno.models.cometapi`에서 CometAPI를 직접 사용할 수 있습니다.

## 사전 요구 사항

* Python 3.10+
* Agno Python 패키지
* 활성 API 키가 있는 CometAPI 계정 — [대시보드에서 발급받기](https://www.cometapi.com/console/token)

## 통합 구성하기

<Steps>
  <Step title="Agno 설치">
    Python 환경에 Agno를 설치하세요:

    ```bash theme={null}
    pip install -U agno
    ```
  </Step>

  <Step title="CometAPI API 키 설정">
    CometAPI API 키를 `COMETAPI_KEY` 환경 변수에 저장하세요:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```
  </Step>

  <Step title="Agno 에이전트 생성">
    Agno의 공식 `CometAPI` provider를 사용하세요:

    ```python theme={null}
    from agno.agent import Agent
    from agno.models.cometapi import CometAPI

    agent = Agent(
        model=CometAPI(id="your-model-id"),
        markdown=True,
    )

    agent.print_response("Write a short product update in three bullet points.")
    ```

    `your-model-id`를 [CometAPI Models 페이지](/ko/overview/models)의 현재 model ID로 바꾸세요.
  </Step>

  <Step title="에이전트 실행">
    예제를 `agent.py`로 저장한 다음, 같은 셸 세션에서 실행하세요:

    ```bash theme={null}
    python agent.py
    ```

    응답이 성공적으로 반환되면 Agno가 CometAPI를 통해 모델 호출을 전송하고 있음을 확인할 수 있습니다.
  </Step>
</Steps>

## Agno가 CometAPI에 연결되는 방식

Agno의 공식 `CometAPI` provider는 환경에서 `COMETAPI_KEY`를 읽고, 기본 base URL로 `https://api.cometapi.com/v1`를 사용합니다. 내부적으로는 Agno의 OpenAI 호환 모델 인터페이스를 확장하지만, 애플리케이션 코드에서는 `CometAPI`를 import하고 인스턴스화해야 합니다.

런타임에서 환경 변수를 읽을 수 없는 경우에는 API 키나 base URL을 명시적으로 전달할 수도 있습니다:

```python theme={null}
import os

from agno.agent import Agent
from agno.models.cometapi import CometAPI

agent = Agent(
    model=CometAPI(
        id="your-model-id",
        api_key=os.environ["COMETAPI_KEY"],
        base_url="https://api.cometapi.com/v1",
    )
)

agent.print_response("Summarize the benefits of a unified AI API.")
```

## 사용 가능한 모델 목록 보기

Agno의 provider는 CometAPI 계정에서 사용할 수 있는 model ID를 확인하기 위해 `get_available_models()`를 제공합니다:

```python theme={null}
from agno.models.cometapi import CometAPI

model = CometAPI()
available_models = model.get_available_models()
print(available_models)
```

## 문제 해결

<AccordionGroup>
  <Accordion title="인증 오류">
    `agent.py`를 실행하는 동일한 셸 세션에서 `COMETAPI_KEY`가 설정되어 있는지 확인하세요. 변수가 없으면 Agno는 모델 요청을 보내기 전에 인증 오류를 발생시킵니다.
  </Accordion>

  <Accordion title="모델 오류">
    `id` 값이 [CometAPI Models 페이지](/ko/overview/models)의 model ID와 일치하는지 확인하세요. `CometAPI().get_available_models()`를 호출해 계정에서 사용할 수 있는 모델을 확인할 수도 있습니다.
  </Accordion>
</AccordionGroup>

## 관련 리소스

* [Agno CometAPI provider 문서](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Agno CometAPI provider 소스](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Agno CometAPI cookbook](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [CometAPI 빠른 시작](/ko/overview/quick-start)
* [CometAPI 모델 페이지](/ko/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "CometAPI와 함께 Agno 사용하기",
        "description": "이 가이드를 사용하여 CometAPI model provider, API key, model ID로 Agno 에이전트를 CometAPI에 연결하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Agno 설치",
            "text": "CometAPI와 함께 Agno 사용하기 가이드의 Agno 설치 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "CometAPI API key 설정",
            "text": "integration에서 사용하는 environment variable 또는 settings field에 CometAPI API key를 저장하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Agno 에이전트 생성",
            "text": "CometAPI와 함께 Agno 사용하기 가이드의 Agno 에이전트 생성 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "에이전트 실행",
            "text": "CometAPI와 함께 Agno 사용하기 가이드의 에이전트 실행 단계를 완료하세요."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "연동",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI와 함께 Agno 사용하기",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>