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

# Use o Agno com CometAPI

> Use este guia para conectar agentes Agno ao CometAPI com o provedor de modelo CometAPI, chave de API e model ID.

[Agno](https://docs.agno.com/) permite criar e executar agentes de IA em Python. O Agno inclui um provedor de modelo `CometAPI` oficial, para que você possa usar o CometAPI diretamente de `agno.models.cometapi` sem criar um adaptador personalizado.

## Pré-requisitos

* Python 3.10+
* O pacote Python Agno
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua no dashboard](https://www.cometapi.com/console/token)

## Configurar a integração

<Steps>
  <Step title="Instalar o Agno">
    Instale o Agno no seu ambiente Python:

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

  <Step title="Definir sua chave de API do CometAPI">
    Armazene sua chave de API do CometAPI na variável de ambiente `COMETAPI_KEY`:

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

  <Step title="Criar um agente Agno">
    Use o provedor oficial `CometAPI` do 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.")
    ```

    Substitua `your-model-id` por um model ID atual da [página de modelos do CometAPI](/pt/overview/models).
  </Step>

  <Step title="Executar o agente">
    Salve o exemplo como `agent.py` e depois execute-o na mesma sessão do shell:

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

    Uma resposta bem-sucedida confirma que o Agno está enviando chamadas de modelo por meio do CometAPI.
  </Step>
</Steps>

## Como o Agno se conecta ao CometAPI

O provedor oficial `CometAPI` do Agno lê `COMETAPI_KEY` do seu ambiente e usa `https://api.cometapi.com/v1` como base URL padrão. Internamente, ele estende a interface de modelo compatível com OpenAI do Agno, mas o código da sua aplicação deve importar e instanciar `CometAPI`.

Você também pode passar a chave de API ou a base URL explicitamente quando seu runtime não puder ler variáveis de 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.")
```

## Listar modelos disponíveis

O provedor do Agno expõe `get_available_models()` para verificar os model IDs disponíveis por meio da sua conta CometAPI:

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

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

## Solução de problemas

<AccordionGroup>
  <Accordion title="Erros de autenticação">
    Confirme que `COMETAPI_KEY` está definida na mesma sessão do shell que executa `agent.py`. Se a variável estiver ausente, o Agno gera um erro de autenticação antes de enviar a solicitação ao modelo.
  </Accordion>

  <Accordion title="Erros de modelo">
    Confirme que o valor de `id` corresponde a um model ID da [página de modelos do CometAPI](/pt/overview/models). Você também pode chamar `CometAPI().get_available_models()` para inspecionar a disponibilidade de modelos na sua conta.
  </Accordion>
</AccordionGroup>

## Recursos relacionados

* [Documentação do provedor Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Código-fonte do provedor Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Cookbook do Agno CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Início rápido do CometAPI](/pt/overview/quick-start)
* [Página de Models do CometAPI](/pt/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 com CometAPI",
        "description": "Use este guia para conectar agentes Agno ao CometAPI com o provedor de model CometAPI, chave de API e model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Instalar Agno",
            "text": "Conclua a etapa Instalar Agno no guia Usar Agno com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Defina sua chave de API do CometAPI",
            "text": "Armazene sua chave de API do CometAPI na variável de ambiente ou no campo de configurações usado pela integração."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Criar um agente Agno",
            "text": "Conclua a etapa Criar um agente Agno no guia Usar Agno com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Executar o agente",
            "text": "Conclua a etapa Executar o agente no guia Usar Agno com CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação do CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Usar Agno com CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>