As ações de API requerem conhecimento técnico de configuração de servidores ou interfaces.
Por favor, note que este tutorial está disponível apenas em inglês, pois é destinado principalmente a usuários com um perfil mais técnico, para quem o inglês é o padrão de facto.
As ações de API permitem conectar sistemas e serviços externos aos seus fluxos de trabalho, fazendo solicitações HTTP aos seus endpoints. Elas permitem enviar dados para ou recuperar dados de aplicativos de terceiros, bancos de dados ou servidores personalizados de forma programática. Você pode configurar o método de solicitação (GET, PATCH, POST, PUT, DELETE), cabeçalhos, autenticação e parâmetros do corpo para atender aos requisitos da API. As ações de API são particularmente úteis quando a integração MCP não está disponível ou quando você precisa de controle direto sobre a comunicação HTTP. Uma vez configuradas, essas ações podem ser acionadas automaticamente dentro de seus fluxos de trabalho ou por Agentes de IA para automatizar tarefas e sincronizar dados entre plataformas.
Aviso!
A qualidade dos seus dados realmente importa! Se você fornecer informações de baixa qualidade à IA, receberá resultados de baixa qualidade de volta (pense em "lixo entra, lixo sai")
Jedes KI-Modell arbeitet mit Context Limits, also einer Limitierung der Datenmenge, die es von externen Systemen z.B. per API oder über einen MCP Server zur Verfügung gestellt wird.
Um die bestmögliche Antwortqualität zu erhalten, ist es essentiell, die Informationen so stark wie möglich vorzufiltern. Das Ziel ist, dass das KI-Modell ausschließlich exakt die Informationen erhält, die für die Beantwortung genau dieser einen Nachricht benötigt werden.
Ansonsten wird das KI-Modell mit ungefilterten Informationen, und damit auch einer unnötig großen Datenmenge “vollgeladen”, in der Hoffnung, dass die KI daraus eine sinnvolle Antwort erstellt, und das möglichst auch noch rasend schnell. Dies ist nicht realistisch.
Nutzen Sie daher bestmöglich die Übergabemöglichkeiten von Parametern sowohl auf Basis der Eingaben des Kontakts, als auch bei der Rückgabe von Daten per API.
Cada modelo de IA trabalha com limites de contexto, ou seja, uma limitação da quantidade de dados que lhe é disponibilizada por sistemas externos, por exemplo, via API ou através de um servidor MCP.
Para obter a melhor qualidade de resposta possível, é essencial pré-filtrar as informações o máximo possível. O objetivo é que o modelo de IA receba exclusivamente as informações exatas necessárias para responder a esta mensagem específica.
Caso contrário, o modelo de IA será "sobrecarregado" com informações não filtradas e, portanto, com uma quantidade de dados desnecessariamente grande, na esperança de que a IA crie uma resposta sensata a partir disso, e de preferência muito rapidamente. Isso não é realista.
Portanto, utilize da melhor forma possível as possibilidades de passagem de parâmetros, tanto com base nas entradas do contato quanto no retorno de dados via API.
Dê à sua ação de API um nome interno e forneça instruções para o seu Agente de IA sobre quando acionar esta ação.
Adicione o URL do endpoint designado e o método.
Configure cabeçalhos, corpo e espaços reservados, se necessário.
Tenha em mente que você precisa ativar sua nova ação de API para cada Agente de IA ao qual deseja dar acesso na aba Ações do sistema da sua página de configuração do Agente de IA.
Exemplos de configuração
Exemplos de configuração