> ## 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 esta guía para conectar agentes de Agno a CometAPI con el proveedor de modelos de CometAPI, la clave API y el model ID.

[Agno](https://docs.agno.com/) te permite crear y ejecutar agentes de IA en Python. Agno incluye un proveedor oficial de modelos `CometAPI`, por lo que puedes usar CometAPI directamente desde `agno.models.cometapi` sin crear un adaptador personalizado.

## Requisitos previos

* Python 3.10+
* El paquete de Python de Agno
* Una cuenta de CometAPI con una clave API activa — [obtén la tuya en el panel](https://www.cometapi.com/console/token)

## Configurar la integración

<Steps>
  <Step title="Instalar Agno">
    Instala Agno en tu entorno de Python:

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

  <Step title="Establecer tu clave API de CometAPI">
    Guarda tu clave API de CometAPI en la variable de entorno `COMETAPI_KEY`:

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

  <Step title="Crear un agente de Agno">
    Usa el proveedor oficial `CometAPI` de 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.")
    ```

    Reemplaza `your-model-id` por un model ID actual de la [página de modelos de CometAPI](/es/overview/models).
  </Step>

  <Step title="Ejecutar el agente">
    Guarda el ejemplo como `agent.py` y luego ejecútalo desde la misma sesión de shell:

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

    Una respuesta correcta confirma que Agno está enviando llamadas al modelo a través de CometAPI.
  </Step>
</Steps>

## Cómo Agno se conecta a CometAPI

El proveedor oficial `CometAPI` de Agno lee `COMETAPI_KEY` desde tu entorno y usa `https://api.cometapi.com/v1` como base URL predeterminada. Internamente extiende la interfaz de modelo compatible con OpenAI de Agno, pero el código de tu aplicación debe importar e instanciar `CometAPI`.

También puedes pasar la clave API o la base URL explícitamente cuando tu entorno de ejecución no puede leer variables de entorno:

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

## Listar modelos disponibles

El proveedor de Agno expone `get_available_models()` para comprobar los model IDs disponibles a través de tu cuenta de CometAPI:

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

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

## Solución de problemas

<AccordionGroup>
  <Accordion title="Errores de autenticación">
    Confirma que `COMETAPI_KEY` esté configurada en la misma sesión de shell que ejecuta `agent.py`. Si falta la variable, Agno genera un error de autenticación antes de enviar la solicitud al modelo.
  </Accordion>

  <Accordion title="Errores de modelo">
    Confirma que el valor de `id` coincida con un model ID de la [página de modelos de CometAPI](/es/overview/models). También puedes llamar a `CometAPI().get_available_models()` para inspeccionar la disponibilidad de modelos desde tu cuenta.
  </Accordion>
</AccordionGroup>

## Recursos relacionados

* [Documentación del proveedor CometAPI de Agno](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Código fuente del proveedor CometAPI de Agno](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Recetario de Agno para CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Inicio rápido de CometAPI](/es/overview/quick-start)
* [Página de modelos de CometAPI](/es/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Usar Agno con CometAPI",
        "description": "Usa esta guía para conectar agentes de Agno a CometAPI con el proveedor de modelos de CometAPI, la clave API y el model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Instalar Agno",
            "text": "Completa el paso Instalar Agno en la guía Usar Agno con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Configura tu clave API de CometAPI",
            "text": "Guarda tu clave API de CometAPI en la variable de entorno o el campo de configuración utilizado por la integración."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Crear un agente de Agno",
            "text": "Completa el paso Crear un agente de Agno en la guía Usar Agno con CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Ejecutar el agente",
            "text": "Completa el paso Ejecutar el agente en la guía Usar Agno con CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentación de CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraciones",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usar Agno con CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>