> ## 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.

# Usa Agno con CometAPI

> Usa questa guida per collegare gli agenti Agno a CometAPI con il model provider CometAPI, la chiave API e il model ID.

[Agno](https://docs.agno.com/) ti consente di creare ed eseguire agenti AI in Python. Agno include un model provider ufficiale `CometAPI`, quindi puoi usare CometAPI direttamente da `agno.models.cometapi` senza creare un adattatore personalizzato.

## Prerequisiti

* Python 3.10+
* Il pacchetto Python di Agno
* Un account CometAPI con una chiave API attiva — [ottieni la tua nella dashboard](https://www.cometapi.com/console/token)

## Configura l'integrazione

<Steps>
  <Step title="Installa Agno">
    Installa Agno nel tuo ambiente Python:

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

  <Step title="Imposta la tua chiave API CometAPI">
    Salva la tua chiave API CometAPI nella variabile d'ambiente `COMETAPI_KEY`:

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

  <Step title="Crea un agente Agno">
    Usa il provider ufficiale `CometAPI` di 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.")
    ```

    Sostituisci `your-model-id` con un model ID attuale dalla [pagina dei modelli CometAPI](/it/overview/models).
  </Step>

  <Step title="Esegui l'agente">
    Salva l'esempio come `agent.py`, quindi eseguilo dalla stessa sessione della shell:

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

    Una risposta riuscita conferma che Agno sta inviando le chiamate al modello tramite CometAPI.
  </Step>
</Steps>

## Come Agno si collega a CometAPI

Il provider ufficiale `CometAPI` di Agno legge `COMETAPI_KEY` dal tuo ambiente e usa `https://api.cometapi.com/v1` come URL di base predefinito. Internamente estende l'interfaccia di modello compatibile con OpenAI di Agno, ma il codice della tua applicazione dovrebbe importare e istanziare `CometAPI`.

Puoi anche passare esplicitamente la chiave API o l'URL di base quando il tuo runtime non può leggere le variabili d'ambiente:

```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.")
```

## Elenca i modelli disponibili

Il provider di Agno espone `get_available_models()` per controllare i model ID disponibili tramite il tuo account CometAPI:

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

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

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Errori di autenticazione">
    Verifica che `COMETAPI_KEY` sia impostata nella stessa sessione della shell che esegue `agent.py`. Se la variabile manca, Agno genera un errore di autenticazione prima di inviare la richiesta al modello.
  </Accordion>

  <Accordion title="Errori del modello">
    Verifica che il valore `id` corrisponda a un model ID dalla [pagina dei modelli CometAPI](/it/overview/models). Puoi anche chiamare `CometAPI().get_available_models()` per verificare la disponibilità dei modelli dal tuo account.
  </Accordion>
</AccordionGroup>

## Risorse correlate

* [Documentazione del provider Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Codice sorgente del provider Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Cookbook di Agno CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Guida rapida di CometAPI](/it/overview/quick-start)
* [Pagina Models di CometAPI](/it/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Usare Agno con CometAPI",
        "description": "Usa questa guida per collegare gli agenti Agno a CometAPI con il provider di modelli CometAPI, la chiave API e il model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Installare Agno",
            "text": "Completa il passaggio Installare Agno nella guida Usare Agno con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Imposta la tua chiave API CometAPI",
            "text": "Memorizza la tua chiave API CometAPI nella variabile d'ambiente o nel campo delle impostazioni usato dall'integrazione."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Creare un agente Agno",
            "text": "Completa il passaggio Creare un agente Agno nella guida Usare Agno con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Eseguire l'agente",
            "text": "Completa il passaggio Eseguire l'agente nella guida Usare Agno con CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usare Agno con CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>