> ## 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 с CometAPI

> Используйте это руководство, чтобы подключить агентов Agno к CometAPI с помощью провайдера моделей CometAPI, API key и model ID.

[Agno](https://docs.agno.com/) позволяет создавать и запускать AI-агентов на Python. Agno включает официальный провайдер моделей `CometAPI`, поэтому вы можете использовать CometAPI напрямую из `agno.models.cometapi` без создания собственного адаптера.

## Предварительные требования

* Python 3.10+
* Python-пакет Agno
* Учетная запись CometAPI с активным API key — [получите его в панели управления](https://www.cometapi.com/console/token)

## Настройка интеграции

<Steps>
  <Step title="Установите Agno">
    Установите Agno в ваше Python-окружение:

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

  <Step title="Установите ваш API key CometAPI">
    Сохраните ваш API key CometAPI в переменной окружения `COMETAPI_KEY`:

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

  <Step title="Создайте агента Agno">
    Используйте официальный провайдер `CometAPI` в Agno:

    ```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` на актуальный model ID со [страницы моделей CometAPI](/ru/overview/models).
  </Step>

  <Step title="Запустите агента">
    Сохраните пример как `agent.py`, затем запустите его в той же сессии shell:

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

    Успешный ответ подтверждает, что Agno отправляет вызовы модели через CometAPI.
  </Step>
</Steps>

## Как Agno подключается к CometAPI

Официальный провайдер `CometAPI` в Agno считывает `COMETAPI_KEY` из вашего окружения и использует `https://api.cometapi.com/v1` в качестве base URL по умолчанию. Внутри он расширяет OpenAI-совместимый интерфейс моделей Agno, но в коде вашего приложения следует импортировать и создавать экземпляр `CometAPI`.

Вы также можете явно передать API key или 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 предоставляет `get_available_models()` для проверки model ID, доступных через вашу учетную запись CometAPI:

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

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

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Ошибки аутентификации">
    Убедитесь, что `COMETAPI_KEY` задан в той же сессии shell, из которой запускается `agent.py`. Если переменная отсутствует, Agno вызовет ошибку аутентификации до отправки запроса к модели.
  </Accordion>

  <Accordion title="Ошибки модели">
    Убедитесь, что значение `id` соответствует model ID со [страницы моделей CometAPI](/ru/overview/models). Вы также можете вызвать `CometAPI().get_available_models()`, чтобы проверить доступность моделей в вашей учетной записи.
  </Accordion>
</AccordionGroup>

## Связанные ресурсы

* [Документация провайдера Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Исходный код провайдера Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Сборник рецептов Agno CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Быстрый старт CometAPI](/ru/overview/quick-start)
* [Страница Models CometAPI](/ru/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Использование Agno с CometAPI",
        "description": "Используйте это руководство, чтобы подключить агентов Agno к CometAPI с помощью провайдера моделей CometAPI, API-ключа и model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Установите Agno",
            "text": "Выполните шаг «Установите Agno» в руководстве «Использование Agno с CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Укажите ваш API-ключ CometAPI",
            "text": "Сохраните ваш API-ключ CometAPI в переменной окружения или поле настроек, используемом этой интеграцией."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Создайте агента Agno",
            "text": "Выполните шаг «Создайте агента Agno» в руководстве «Использование Agno с CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Запустите агента",
            "text": "Выполните шаг «Запустите агента» в руководстве «Использование Agno с CometAPI»."
          }
        ]
      },
      {
        "@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": "Использование Agno с CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>