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

# Utiliser Agno avec CometAPI

> Utilisez ce guide pour connecter des agents Agno à CometAPI avec le fournisseur de modèle CometAPI, la clé API et le model ID.

[Agno](https://docs.agno.com/) vous permet de créer et d’exécuter des agents IA en Python. Agno inclut un fournisseur de modèle officiel `CometAPI`, vous pouvez donc utiliser CometAPI directement depuis `agno.models.cometapi` sans créer d’adaptateur personnalisé.

## Prérequis

* Python 3.10+
* Le package Python Agno
* Un compte CometAPI avec une clé API active — [obtenez la vôtre dans le tableau de bord](https://www.cometapi.com/console/token)

## Configurer l’intégration

<Steps>
  <Step title="Installer Agno">
    Installez Agno dans votre environnement Python :

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

  <Step title="Définir votre clé API CometAPI">
    Stockez votre clé API CometAPI dans la variable d’environnement `COMETAPI_KEY` :

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

  <Step title="Créer un agent Agno">
    Utilisez le fournisseur officiel `CometAPI` d’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.")
    ```

    Remplacez `your-model-id` par un model ID actuel depuis la [page des modèles CometAPI](/fr/overview/models).
  </Step>

  <Step title="Exécuter l’agent">
    Enregistrez l’exemple sous `agent.py`, puis exécutez-le depuis la même session shell :

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

    Une réponse réussie confirme qu’Agno envoie les appels au modèle via CometAPI.
  </Step>
</Steps>

## Comment Agno se connecte à CometAPI

Le fournisseur officiel `CometAPI` d’Agno lit `COMETAPI_KEY` depuis votre environnement et utilise `https://api.cometapi.com/v1` comme URL de base par défaut. En interne, il étend l’interface de modèle compatible OpenAI d’Agno, mais le code de votre application doit importer et instancier `CometAPI`.

Vous pouvez également transmettre explicitement la clé API ou l’URL de base lorsque votre environnement d’exécution ne peut pas lire les variables d’environnement :

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

## Lister les modèles disponibles

Le fournisseur d’Agno expose `get_available_models()` pour vérifier les model IDs disponibles via votre compte CometAPI :

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

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

## Dépannage

<AccordionGroup>
  <Accordion title="Erreurs d’authentification">
    Vérifiez que `COMETAPI_KEY` est défini dans la même session shell que celle qui exécute `agent.py`. Si la variable est absente, Agno renvoie une erreur d’authentification avant d’envoyer la requête au modèle.
  </Accordion>

  <Accordion title="Erreurs de modèle">
    Vérifiez que la valeur `id` correspond à un model ID de la [page des modèles CometAPI](/fr/overview/models). Vous pouvez également appeler `CometAPI().get_available_models()` pour examiner la disponibilité des modèles depuis votre compte.
  </Accordion>
</AccordionGroup>

## Ressources associées

* [Documentation du fournisseur Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Code source du fournisseur Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Cookbook Agno CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Démarrage rapide CometAPI](/fr/overview/quick-start)
* [Page des modèles CometAPI](/fr/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Utiliser Agno avec CometAPI",
        "description": "Utilisez ce guide pour connecter des agents Agno à CometAPI avec le fournisseur de modèle CometAPI, une clé API et un model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Installer Agno",
            "text": "Effectuez l’étape Installer Agno dans le guide Utiliser Agno avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Définir votre clé API CometAPI",
            "text": "Stockez votre clé API CometAPI dans la variable d’environnement ou le champ de paramètres utilisé par l’intégration."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Créer un agent Agno",
            "text": "Effectuez l’étape Créer un agent Agno dans le guide Utiliser Agno avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Exécuter l’agent",
            "text": "Effectuez l’étape Exécuter l’agent dans le guide Utiliser Agno avec CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Utiliser Agno avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>