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

# Conectar o Langflow ao CometAPI

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

[Langflow](https://www.langflow.org/) é um framework visual para criar fluxos de trabalho de agent e RAG. O Langflow inclui um componente CometAPI que chama modelos de linguagem do CometAPI por meio de endpoints compatíveis com OpenAI.

## Pré-requisitos

* Langflow Desktop, Langflow Cloud ou uma instância auto-hospedada do Langflow
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua no dashboard](https://www.cometapi.com/console/token)
* Um model ID da [página de Models do CometAPI](/pt/overview/models)

## Configurar a integração

<Steps>
  <Step title="Adicionar o componente CometAPI">
    No canvas do Langflow, abra o menu de componentes. Procure por **CometAPI** e, em seguida, adicione o componente de geração de texto do CometAPI ao seu fluxo.
  </Step>

  <Step title="Inserir sua chave de API do CometAPI">
    Selecione o componente CometAPI. No painel de inspeção do componente, insira sua chave de API do CometAPI no campo de chave de API.
  </Step>

  <Step title="Escolher um model ID">
    Defina o model ID com um valor da [página de Models do CometAPI](/pt/overview/models). Se o componente puder buscar modelos após você inserir a chave de API, selecione o model ID no menu de modelos.
  </Step>

  <Step title="Conectar a entrada e a saída do chat">
    Para um fluxo de teste mínimo, adicione os componentes **Chat Input** e **Chat Output**. Conecte **Chat Input** à entrada do componente CometAPI e, em seguida, conecte a saída do CometAPI a **Chat Output**.
  </Step>

  <Step title="Testar no Playground">
    Abra o Playground e envie uma mensagem curta. Uma resposta de chat bem-sucedida confirma que o Langflow está chamando o CometAPI.
  </Step>
</Steps>

## Usar o CometAPI em fluxos maiores

Altere o tipo de saída do componente CometAPI para **Language Model** quando outro componente do Langflow precisar de uma entrada de LLM. Isso é útil para fluxos de Agent, Prompt Template e Smart Transform.

Para chat direto, mantenha a saída padrão de resposta do modelo e conecte-a a um componente Chat Output.

## Executar o fluxo do CometAPI a partir do Python

Depois de testar o fluxo no Playground, você pode chamar o mesmo fluxo do Langflow a partir do Python. O código Python chama o seu servidor Langflow. Ele não envia solicitações diretamente ao CometAPI. Mantenha a chave de API do CometAPI e o model ID no componente CometAPI dentro do Langflow.

O exemplo da REST API envia uma entrada de chat para um flow ID ou nome de endpoint:

```python theme={null}
import os

import requests

langflow_url = os.environ.get("LANGFLOW_URL", "http://localhost:7860")
langflow_api_key = os.environ["LANGFLOW_API_KEY"]
flow_id = os.environ["LANGFLOW_FLOW_ID"]

response = requests.post(
    f"{langflow_url}/api/v1/run/{flow_id}",
    headers={
        "x-api-key": langflow_api_key,
        "Content-Type": "application/json",
    },
    json={
        "input_value": "Hello from CometAPI",
        "input_type": "chat",
        "output_type": "chat",
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

Para projetos que usam o SDK Python do Langflow, instale `langflow-sdk` e chame o mesmo fluxo por meio de `Client.run()`:

```python theme={null}
from langflow_sdk import Client

client = Client("http://localhost:7860", api_key="<LANGFLOW_API_KEY>")
response = client.run("FLOW_ID", input_value="Hello from CometAPI")
print(response.first_text_output())
```

Substitua `FLOW_ID` pelo flow ID ou nome do endpoint do Langflow. Substitua `<LANGFLOW_API_KEY>` pela sua chave de API do Langflow. Esse valor é diferente da sua chave de API do CometAPI.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O componente CometAPI está ausente">
    Atualize o Langflow para uma versão que inclua o pacote CometAPI. Se a sua implantação ocultar alguns componentes, verifique as configurações do pacote ou procure em componentes de modelo de linguagem.
  </Accordion>

  <Accordion title="A lista de modelos não carrega">
    Confirme que a chave de API do CometAPI é válida e que a conta tem acesso ao modelo selecionado. Você também pode inserir o model ID manualmente.
  </Accordion>

  <Accordion title="O fluxo é executado, mas retorna um erro">
    Verifique se o model ID corresponde exatamente ao CometAPI e se a entrada do fluxo está conectada à entrada do componente CometAPI.
  </Accordion>
</AccordionGroup>

## Recursos relacionados

* [Pacote CometAPI do Langflow](https://docs.langflow.org/bundles-cometapi)
* [Acionador de fluxo da API do Langflow](https://docs.langflow.org/concepts-publish)
* [Pacote langflow-sdk](https://pypi.org/project/langflow-sdk/)
* [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/langflow#howto",
        "name": "Conectar o Langflow ao CometAPI",
        "description": "Use este guia para conectar o Langflow ao 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/langflow#step-1",
            "position": 1,
            "name": "Adicionar o componente CometAPI",
            "text": "Conclua a etapa Adicionar o componente CometAPI no guia Conectar o Langflow ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-2",
            "position": 2,
            "name": "Insira sua chave de API do CometAPI",
            "text": "Conclua a etapa Insira sua chave de API do CometAPI no guia Conectar o Langflow ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-3",
            "position": 3,
            "name": "Escolher um model ID",
            "text": "Conclua a etapa Escolher um model ID no guia Conectar o Langflow ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-4",
            "position": 4,
            "name": "Conectar entrada e saída do chat",
            "text": "Conclua a etapa Conectar entrada e saída do chat no guia Conectar o Langflow ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-5",
            "position": 5,
            "name": "Testar no Playground",
            "text": "Conclua a etapa Testar no Playground no guia Conectar o Langflow ao 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": "Conectar o Langflow ao CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/langflow"
          }
        ]
      }
    ]
    }
    `}
</script>
