CometAPI와 함께 Agno 사용하기

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

사전 요구 사항

Python 3.10+
Agno Python 패키지
활성 API 키가 있는 CometAPI 계정 — 대시보드에서 발급받기

통합 구성하기

Agno 설치

Python 환경에 Agno를 설치하세요:

pip install -U agno

CometAPI API 키 설정

CometAPI API 키를 COMETAPI_KEY 환경 변수에 저장하세요:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

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 페이지의 현재 model ID로 바꾸세요.

에이전트 실행

예제를 agent.py로 저장한 다음, 같은 셸 세션에서 실행하세요:

python agent.py

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

Agno가 CometAPI에 연결되는 방식

Agno의 공식 CometAPI provider는 환경에서 COMETAPI_KEY를 읽고, 기본 base URL로 https://api.cometapi.com/v1를 사용합니다. 내부적으로는 Agno의 OpenAI 호환 모델 인터페이스를 확장하지만, 애플리케이션 코드에서는 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는 모델 요청을 보내기 전에 인증 오류를 발생시킵니다.

모델 오류

id 값이 CometAPI Models 페이지의 model ID와 일치하는지 확인하세요. CometAPI().get_available_models()를 호출해 계정에서 사용할 수 있는 모델을 확인할 수도 있습니다.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

사전 요구 사항

통합 구성하기

Agno가 CometAPI에 연결되는 방식

사용 가능한 모델 목록 보기

문제 해결

관련 리소스

​사전 요구 사항

​통합 구성하기

​Agno가 CometAPI에 연결되는 방식

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

​문제 해결

​관련 리소스

사전 요구 사항

통합 구성하기

Agno가 CometAPI에 연결되는 방식

사용 가능한 모델 목록 보기

문제 해결

관련 리소스