Agente Jitterbit GitHub com MCP

Visão Geral

A Jitterbit fornece o Agente GitHub com MCP a todos os clientes através do Jitterbit Marketplace. Este agente é projetado para fins de aprendizado, ajudando as organizações a adotarem facilmente a IA. Este agente utiliza a técnica de Geração Aumentada por Recuperação (RAG), que combina o raciocínio de LLM com acesso a ferramentas externas e fontes de dados.

Este agente aproveita o Protocolo de Contexto do Modelo (MCP) através do conector MCP Client. Ele consome as ferramentas fornecidas pelo Servidor MCP do GitHub e atua como um assistente, onde você pode interagir com ele como um chatbot.

Este documento explica a configuração e operação deste agente. Primeiro, cobre os pré-requisitos, em seguida, apresenta exemplos de prompts e limitações para mostrar o que o agente pode e não pode fazer, e por fim, fornece passos para instalar, configurar e operar o agente.

Pré-requisitos

Para usar este agente, os seguintes componentes são necessários ou assumidos no design do agente.

Componentes do Harmony

Você deve ter uma licença Jitterbit Harmony com acesso aos seguintes componentes:

• Jitterbit Studio
• Jitterbit API Manager

Agente privado

Para simplificar o design, este agente de IA é projetado para uso com agentes privados.

Endpoints suportados

Os seguintes endpoints estão incorporados no design do agente.

Modelo de linguagem grande (LLM)

O agente de IA utiliza OpenAI como o provedor de LLM para ajuste fino e inferência. Para usar o OpenAI, é necessário ter uma assinatura do OpenAI com permissões para criar e gerenciar chaves de API.

Cliente MCP

O servidor MCP do GitHub está conectado através do conector Cliente MCP. É necessário ter gerado um token de acesso pessoal do GitHub para usar com o conector Cliente MCP.

Exemplos de prompts e limitações

As seções a seguir descrevem o que este agente de IA pode e não pode fazer.

Exemplos de prompts

Aqui estão exemplos de prompts que este agente de IA pode lidar com acesso aos dados apropriados:

• "Quantas pull requests o usuário {{user-name}} criou para o repositório {{repository-name}} no GitHub? O proprietário do repositório é {{owner-name}}."

• "Quantas branches o {{repository-name}} tem no GitHub?"

Limitações

• Agente privado apenas: Para simplicidade de design, este agente de IA pode ser usado apenas com agentes privados e não é compatível com agentes em nuvem.

• Sem estado: O agente é sem estado e não conversacional. Ele processa cada solicitação como um prompt de turno único, o que significa que não armazena ou utiliza as informações de prompts anteriores para informar sua resposta atual. Sua capacidade é limitada a responder apenas ao prompt atual.

• Conhecimento limitado: Como este agente é apenas um exemplo básico, o agente de IA não será capaz de responder a todas as perguntas relacionadas ao GitHub, a menos que as ferramentas adequadas sejam implementadas no fluxo de trabalho Fluxos de Trabalho de Ferramentas.

• Sem interface gráfica: Como este agente é apenas um exemplo básico, ele não possui uma interface de chat para interagir com o agente de IA. No entanto, pode se conectar a qualquer interface, incluindo ferramentas como Slack, Microsoft Teams, WhatsApp ou qualquer interface personalizada construída com capacidades de conversa em chat. Para adicionar uma interface de chat, você pode incorporar os passos demonstrados em Agentes reativos, contextuais e de Q&A do Salesforce.

Instalação, configuração e operação

Siga estas etapas para instalar, configurar e operar este agente de IA:

1. Instalar o projeto Studio.
2. Revisar fluxos de trabalho do projeto.
3. Criar uma chave de API do OpenAI, e configurar e testar a conexão com o OpenAI.
4. Criar um token de acesso pessoal do GitHub, e configurar e testar a conexão com o Cliente MCP.
5. Implantar o projeto.
6. Criar a API personalizada do Jitterbit.
7. Acionar os fluxos de trabalho do projeto.
8. Solução de problemas.

Instalar o projeto

Siga estas etapas para instalar o projeto Studio para o agente de IA:

1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

2. Localize o agente de IA chamado GitHub Agent with MCP. Para localizar o agente, você pode usar a barra de pesquisa ou, no painel Filtros, sob Tipo, selecione Agente de IA para limitar a exibição aos agentes de IA disponíveis.

3. Clique no link Documentação do agente de IA para abrir sua documentação em uma nova aba. Mantenha a aba aberta para consultar depois de iniciar o projeto.

4. Clique em Iniciar Projeto para abrir uma caixa de diálogo de configuração para importar o agente de IA como um projeto Studio.

5. Insira um nome para o projeto e selecione um ambiente onde o projeto Studio será criado, em seguida, clique em Criar Projeto.

6. Uma caixa de diálogo de progresso é exibida. Depois que ela indicar que o projeto foi criado, use o link da caixa de diálogo Ir para o Studio ou abra o projeto diretamente na página Projetos do Studio.

Revisar fluxos de trabalho do projeto

No projeto Studio aberto, revise os fluxos de trabalho juntamente com as descrições abaixo para entender o que eles fazem.

Fluxo Principal de Entrada

Este fluxo gerencia as solicitações de chamadas de API recebidas. Ele possui uma operação, Main Entry - API Request Handler, que é acionada via API cada vez que uma solicitação HTTP é enviada.

Lógica de IA

Este fluxo gerencia a lógica de IA. Ele possui as seguintes operações:

1. AI Logic - Orchestrator

   Esta operação gerencia o fluxo controlando a execução de outras operações.

2. AI Logic - Contextualizing LLM

   Esta operação define o contexto inicial para o LLM por meio de um prompt configurado em uma atividade de Prompt do OpenAI.

   Citar

   Eu sou um Engenheiro de Software, e você será meu assistente pessoal para qualquer tópico relacionado ao GitHub. Por favor, ajude-me a responder perguntas e automatizar/executar tarefas conforme eu solicitar.

3. AI Logic - Listing and Registering the Tools

   Esta operação busca todas as ferramentas MCP fornecidas pelo Servidor MCP do GitHub e registra as mesmas ferramentas no LLM (neste exemplo, o modelo é o GPT-4).

4. AI Logic - Sending Prompt to LLM

   Esta operação envia ao LLM o prompt do usuário que é recebido através da API e gerenciado pela operação Main Entry - API Request Handler.

5. AI Logic - Replying Back to LLM

   Esta operação envia de volta a resposta da ferramenta (após a execução da ferramenta) para o LLM e retransmite a resposta final que será usada como a resposta final do agente.

Fluxos de Trabalho das Ferramentas

Este fluxo gerencia todas as ferramentas do Servidor GitHub desejadas implementadas como parte do agente e lida com as condições sob as quais as ferramentas devem ser executadas com base no prompt do usuário.

1. Tool - Search Pull Requests

   Invocar a operação Tool - Search Pull Requests do Servidor MCP do GitHub com base no nome da ferramenta e nos argumentos da ferramenta fornecidos, e invocar a operação AI Logic - Replying Back to LLM para construir a resposta final do agente para o usuário.

2. Tool - List Branches

   Invocar a operação Tool - List Branches do Servidor MCP do GitHub com base no nome da ferramenta e nos argumentos da ferramenta fornecidos, e invocar a operação AI Logic - Replying Back to LLM para construir a resposta final do agente ao usuário.

3. Tool - Not Implemented Tool

   Este fluxo de trabalho gerencia cenários em que o LLM sugere uma execução de ferramenta que não está implementada como parte das operações de Tool Workflows. Ele retorna uma mensagem amigável ao usuário, como a seguinte:

   {
       "chatId": "<string>",
       "response": "Oops! Sorry... I can't answer anything related to this question yet. Please trying asking something different..."
   }
   

   Esta mensagem pode ser personalizada substituindo a mensagem no campo de resposta da transformação Prepare Request #5.

Utility Workflows - Handling Unexpected Errors

Esta operação lida com cenários inesperados quando algo dá errado com a execução do agente e retorna uma mensagem amigável ao usuário, como a seguinte:

{
    "chatId": "<string>",
    "response": "An unexpected error has happened."
}

Esta mensagem pode ser personalizada substituindo a mensagem no campo de resposta da transformação Prepare Request #6.

Criar uma chave de API do OpenAI, e configurar e testar a conexão com o OpenAI

Siga estas etapas para gerar e configurar uma chave de API do OpenAI:

1. Vá para a página de chaves de API do OpenAI.

2. Clique em Criar nova chave secreta para gerar uma nova chave de API.

3. Copie a chave gerada e guarde-a em segurança. Você precisará dessa chave para configurar a conexão com o OpenAI.

4. No projeto do Studio, abra a configuração da conexão OpenAI.

5. Insira a chave da API no campo API/Secret Key.

6. Clique Testar para verificar a conectividade usando os valores configurados.

Criar um token de acesso pessoal do GitHub, e configurar e testar a conexão do Cliente MCP

1. Siga as instruções do GitHub para Criar um token de acesso pessoal (clássico).

Quando criar o token, adicione as permissões que o agente de IA precisa para executar as ferramentas que você estará implementando. Por exemplo, este agente de IA básico requer a permissão public_repo para acessar repositórios públicos.

1. No projeto do Studio, abra a configuração da conexão do Cliente MCP. Insira o seguinte:

   • URL do servidor MCP: O URL do servidor deve ser https://api.githubcopilot.com/mcp/. Não altere este valor.
   • Token Bearer: Insira seu token de acesso pessoal.

   Para mais informações, consulte a documentação do GitHub Configurando o Servidor MCP do GitHub.

2. Clique em Testar para verificar a conectividade usando os valores configurados.

Implantar o projeto

Implantar o projeto do Studio.

Para implantar o projeto, use o menu de ações do projeto para selecionar Implantar.

Criar a API personalizada do Jitterbit

Crie uma API personalizada para a operação Main Entry - API Request Handler no fluxo de trabalho Main Entry Workflow.

Para criar a API, use o menu de ações da operação para selecionar Publicar como uma API ou Publicar como uma API usando IA.

Configure as seguintes definições:

A atividade Request da API, como parte da operação Main Entry - API Request Handler, espera receber um JSON na seguinte estrutura:

{
    "prompt": "<string>"
}

Mantenha a URL do serviço da API publicada. A URL do serviço pode ser encontrada na gaveta de detalhes da API na aba Serviços, passando o mouse sobre a coluna Ações do serviço e clicando em Copiar URL do serviço da API.

Acionar os fluxos de trabalho do projeto

O fluxo de trabalho principal, Main Entry Workflow, é acionado pela API personalizada do Jitterbit.

Você pode enviar uma solicitação HTTP para esta API com os exemplos de prompts listados anteriormente.

Assim que você enviar a solicitação HTTP, a resposta fornecida pelo Agente será um JSON na seguinte estrutura:

{
    "chatId": "<string>",
    "response": "<string>"
}

Solução de problemas

Revise os logs da API e os logs de operações para informações detalhadas de solução de problemas.

Para assistência adicional, entre em contato com o suporte do Jitterbit.