메인 콘텐츠로 건너뛰기

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.

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

​
사전 요구 사항

​
통합 구성하기

1

Agno 설치

Python 환경에 Agno를 설치합니다:
pip install -U agno
2

CometAPI API 키 설정

CometAPI API 키를 COMETAPI_KEY 환경 변수에 저장합니다:
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
3

Agno 에이전트 생성

Agno의 공식 CometAPI provider를 사용합니다:
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 page의 현재 model ID로 바꾸세요.
4

에이전트 실행

예제를 agent.py로 저장한 다음, 같은 셸 세션에서 실행합니다:
python agent.py
응답이 성공적으로 반환되면 Agno가 CometAPI를 통해 model 호출을 보내고 있음을 의미합니다.

​
Agno가 CometAPI에 연결되는 방식

Agno의 공식 CometAPI provider는 환경에서 COMETAPI_KEY를 읽고, 기본 base URL로 https://api.cometapi.com/v1을 사용합니다. 내부적으로는 Agno의 OpenAI 호환 model 인터페이스를 확장하지만, 애플리케이션 코드에서는 CometAPI를 import하고 인스턴스화해야 합니다. 런타임이 환경 변수를 읽을 수 없는 경우에는 API 키나 base URL을 명시적으로 전달할 수도 있습니다: 
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()를 제공합니다: 
from agno.models.cometapi import CometAPI

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

​
문제 해결

agent.py를 실행하는 동일한 셸 세션에 COMETAPI_KEY가 설정되어 있는지 확인하세요. 변수가 없으면 Agno는 model 요청을 보내기 전에 인증 오류를 발생시킵니다.
id 값이 CometAPI Models page의 model ID와 일치하는지 확인하세요. CometAPI().get_available_models()를 호출해 계정에서 사용 가능한 모델을 확인할 수도 있습니다.

​
관련 리소스