> ## 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 LlamaIndex com CometAPI

> Use este guia para configurar o LlamaIndex com CometAPI definindo a URL base, a chave de API e as opções de model ou provider.

O LlamaIndex fornece a classe `CometLLM` como uma integração nativa com o CometAPI. Use-a para alimentar pipelines de RAG, agentes e cadeias de LLM com qualquer modelo no catálogo do CometAPI.

## Pré-requisitos

* Python 3.8+
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua aqui](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Instale a integração do LlamaIndex com CometAPI">
    ```bash theme={null}
    pip install llama-index-llms-cometapi llama-index
    ```
  </Step>

  <Step title="Defina sua chave de API">
    ```python theme={null}
    from llama_index.llms.cometapi import CometLLM
    import os

    os.environ["COMETAPI_KEY"] = "<COMETAPI_KEY>"
    api_key = os.getenv("COMETAPI_KEY")
    ```

    <Note>
      Usar variáveis de ambiente é mais seguro do que inserir credenciais diretamente nos scripts.
    </Note>
  </Step>

  <Step title="Inicialize o modelo e faça chamadas de conclusão">
    ```python theme={null}
    from llama_index.core.llms import ChatMessage

    llm = CometLLM(
        api_key=api_key,
        max_tokens=256,
        context_window=4096,
        model="your-model-id",
    )

    # Chat call
    messages = [
        ChatMessage(role="system", content="You are a helpful assistant"),
        ChatMessage(role="user", content="Say 'Hi' only!"),
    ]
    resp = llm.chat(messages)
    print(resp)

    # Completion call
    resp = llm.complete("Who is Kaiming He?")
    print(resp)
    ```
  </Step>

  <Step title="Ative o streaming">
    Use `stream_chat` ou `stream_complete` para saída em blocos em tempo real:

    ```python theme={null}
    # Streaming chat
    message = ChatMessage(role="user", content="Tell me what ResNet is")
    for chunk in llm.stream_chat([message]):
        print(chunk.delta, end="")

    # Streaming completion
    for chunk in llm.stream_complete("Tell me about Large Language Models"):
        print(chunk.delta, end="")
    ```
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Dicas e solução de problemas">
    * **Models**: Veja a [página de Models da CometAPI](/pt/overview/models) para todas as opções disponíveis.
    * **Usando outros modelos**: Inicialize com um model ID atual diferente, por exemplo `CometLLM(api_key=api_key, model="your-model-id", max_tokens=1024)`.
    * **Fine-tuning**: Passe `temperature` e `max_tokens` diretamente para `CometLLM(...)`.
    * **Tratamento de erros**: Envolva as chamadas em `try/except` para capturar erros de chave ou problemas de rede.
    * **Segurança**: Nunca envie chaves de API para o controle de versão. Use variáveis de ambiente.
    * **Mais documentação**: [documentação do LlamaIndex](https://docs.llamaindex.ai/) — [início rápido do CometAPI](/pt/overview/quick-start) — [exemplo no Colab](https://colab.research.google.com/github/run-llama/llama_index/blob/main/docs/docs/examples/llm/cometapi.ipynb)
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/llamaindex#howto",
        "name": "Usar LlamaIndex com CometAPI",
        "description": "Use este guia para configurar o LlamaIndex com CometAPI definindo a URL base, a chave de API e as opções de modelo ou provedor.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/llamaindex#step-1",
            "position": 1,
            "name": "Instale a integração do LlamaIndex com CometAPI",
            "text": "Conclua a etapa Instale a integração do LlamaIndex com CometAPI no guia Usar LlamaIndex com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/llamaindex#step-2",
            "position": 2,
            "name": "Defina sua chave de API",
            "text": "Armazene sua chave de API da CometAPI na variável de ambiente ou no campo de configurações usado pela integração."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/llamaindex#step-3",
            "position": 3,
            "name": "Inicialize o modelo e faça chamadas de conclusão",
            "text": "Conclua a etapa Inicialize o modelo e faça chamadas de conclusão no guia Usar LlamaIndex com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/llamaindex#step-4",
            "position": 4,
            "name": "Ative o streaming",
            "text": "Conclua a etapa Ative o streaming no guia Usar LlamaIndex com CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação da 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 LlamaIndex com CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/llamaindex"
          }
        ]
      }
    ]
    }
    `}
</script>
