> ## 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-ключа та model ID.

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

## Передумови

* Python 3.10+
* Python-пакет Agno
* Обліковий запис CometAPI з активним API-ключем — [отримайте його в dashboard](https://www.cometapi.com/console/token)

## Налаштування інтеграції

<Steps>
  <Step title="Встановіть Agno">
    Встановіть Agno у своєму Python-середовищі:

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

  <Step title="Укажіть свій API-ключ CometAPI">
    Збережіть свій API-ключ 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](/uk/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` як базовий URL за замовчуванням. Усередині він розширює OpenAI-сумісний інтерфейс моделей Agno, але у коді вашого застосунку слід імпортувати та створювати екземпляр `CometAPI`.

Ви також можете явно передати API-ключ або базовий 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](/uk/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](/uk/overview/quick-start)
* [Сторінка Models у CometAPI](/uk/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 key і 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": "Установіть свій CometAPI API key",
            "text": "Збережіть свій CometAPI API key у змінній середовища або в полі налаштувань, яке використовує інтеграція."
          },
          {
            "@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>