Desde que o Mannequin Context Protocol (MCP) foi anunciado pela Anthropic há um ano, vimos um imenso crescimento em grandes modelos de linguagem (LLMs) e casos de uso de agentes. Antes do MCP se tornar o padrão de agente de fato, os desenvolvedores que construíssem agentes sobre LLMs teriam que codificar o tecido conjuntivo entre o LLM e os aplicativos. Os desenvolvedores precisariam criar integrações personalizadas entre seu cliente LLM e os aplicativos exigidos pela solicitação do usuário remaining. Com o MCP, os desenvolvedores agora podem se conectar diretamente a fontes de dados externas, para que seu LLM possa ler e gravar dados nos aplicativos conectados.
Mas há um ponto de ruptura onde as coisas começam a desmoronar. A robustez e a eficácia das soluções de agente dependem da qualidade das interfaces de programação de aplicativos (APIs) usadas por um servidor MCP. MCPs expõem ferramentas que são invocados por LLMs, e essas ferramentas geralmente fazem referência a endpoints de API individuais. A qualidade das APIs, portanto, está diretamente correlacionada com a descoberta e execução precisas dos prompts do usuário pelo cliente LLM.
A hierarquia das necessidades do desenvolvedor
Fornecer APIs de qualidade, consistentes e intuitivas é uma questão de prioridades culturais de uma organização. Na Cisco, temos a sorte de contar com o patrocínio da liderança executiva para a área de superfície de API de nossa plataforma, o que nos ajuda a fornecer APIs de qualidade em toda a empresa.
Descobrimos que é útil priorizar roteiros de API com base em uma hierarquia de necessidades do desenvolvedor.
A hierarquia de necessidades de Maslow ilustra a teoria de que a motivação humana é impulsionada por cinco níveis de necessidade. Organizados em uma pirâmide, são eles: fisiológico, segurança, amor/pertencimento, estima e autorrealização. A teoria sugere que as pessoas são motivadas a satisfazer primeiro as necessidades básicas, antes de progredir para necessidades de nível superior de auto-realização.
Nossa hierarquia de necessidades do desenvolvedor pega a pirâmide de Maslow e a estende para classificar os pontos problemáticos e as soluções do desenvolvedor de acordo com as necessidades básicas, necessidades da empresa e necessidades verticais ou específicas do setor.
Os elementos fundamentais: cobertura e integridade da API
A hierarquia de necessidades do desenvolvedor oferece uma estrutura para que nossas equipes de produto e engenharia priorizem seus roteiros. Por exemplo, a base da qualidade da API é baseada na cobertura ou integridade. Sem os endpoints de API existentes, nada do upstream importa: nem documentação, exemplos de código ou esforços de relacionamento com desenvolvedores.
Figura 1: A hierarquia das necessidades do desenvolvedor oferece uma estrutura para priorização de roteiros de engenharia e produtos.
Em seguida, vem a necessidade de uma especificação OpenAPI (OAS) de alta qualidade e do ciclo de vida de desenvolvimento de API de engenharia interna. Um arquivo OAS pode ter muitas APIs, mas se a prosa em torno de cada endpoint for escassa ou se certos endpoints não tiverem esquemas e parâmetros documentados, isso forçará os desenvolvedores a adivinhar e testar ou fazer engenharia reversa de quais funções cada endpoint da API atende por meio de testes mecânicos. Ambas as opções oferecem uma experiência ruim para o desenvolvedor.
É importante para qualquer organização com movimento de desenvolvedor investir em linting e análise estática de novas APIs em desenvolvimento, para que os engenheiros internos possam enviar facilmente novas funcionalidades de API sem serem especialistas na estrutura de API. Um ótimo exemplo disso é a ferramenta de código aberto do Cisco DevNet, Informações sobre APIs, que permite aos desenvolvedores auditarem suas especificações de API para implementar as melhores práticas o mais cedo possível no ciclo de desenvolvimento. Além disso, muitas pessoas não estão cientes de que, se faltam esquemas na OEA, isso significa essencialmente que kits de desenvolvimento de software program (SDKs) e ferramentas de infraestrutura como código (IaC), como Terraform e Ansible, não podem usar esses endpoints, independentemente de seu standing de lançamento, uma vez que SDKs e ferramentas IaC exigem a capacidade de gerar automaticamente ferramentas da OEA.
Ethical da história: todas as coisas dependem da OEA, especialmente a IA.
Documentação e escalabilidade
O próximo nível de importância é ter documentação intuitiva. Se suas APIs são fantásticas, mas ninguém consegue descobrir qual delas faz o quê, ou se sua arquitetura de informações é um pesadelo, isso anula o esforço que sua equipe faz para enviar APIs e OAS de qualidade. Os desenvolvedores não são monólitos. Alguns são engenheiros de software program de carreira, mas muitos, especialmente no setor de redes, são profissionais técnicos, como engenheiros de redes, que estão aprendendo a escrever scripts ou a construir aplicativos net básicos usando APIs REST pela primeira vez em suas carreiras. Conseqüentemente, uma boa documentação do desenvolvedor é obrigatória antes que alguém possa entender o que é possível para um caso de uso de agente de IA.
Passando para o próximo nível de necessidades do desenvolvedor, temos escala e qualidade empresarial. As organizações que vendem para empresas Fortune 500 ou empresas brownfield sabem que a escala e a tríade da CIA (confidencialidade, integridade, disponibilidade) são princípios de missão crítica. Esses princípios devem ser garantidos antes que os desenvolvedores se sintam confortáveis em criar soluções personalizadas com base em uma API, independentemente de essas soluções serem scripts tradicionais, integrações de aplicativos ou soluções de solução de problemas de agente.
Na Cisco, temos orgulho de fazer parceria estreita com nossos maiores clientes e parceiros provedores de serviços gerenciados para garantir que nossa plataforma funcione perfeitamente para todos, desde uma loja física acquainted até um conglomerado international da Fortune 100 que precisa de redundância, imensa escala e limites de taxa, bem como o maior tempo de atividade disponível.
Simplificando o consumo de API e aplicação vertical
Nosso penúltimo nível de necessidades do desenvolvedor é onde entramos na abstração e ofuscação para simplificar a forma como as APIs são consumidas. SDKs e ferramentas IaC como Ansible e Terraform são a base de grandes empresas que exigem automação generalizada. As equipes de TI estão cada vez mais enxutas e espera-se que os engenheiros de rede façam mais com menos. Se todas as outras necessidades do desenvolvedor forem atendidas, será fácil para uma organização gerar e manter SDKs e ferramentas de desenvolvedor, como um servidor MCP.
Por exemplo, Cisco Meraki e Cisco Catalyst Middle mantêm arquivos OAS de qualidade, que os clientes podem usar para gerar um servidor MCP em poucos minutos com ferramentas API populares como Postman. Isso permite que um desenvolvedor que esteja tentando criar um agente personalizado possa fazê-lo em dias, não em semanas ou meses, tudo por causa da qualidade de nossas APIs, OAS e documentos, e de nossa capacidade de garantir essa qualidade em escala empresarial.
Finalmente, o que realmente que fazem brilhar uma plataforma de desenvolvedor são amostras de código e integrações. Se todas as outras necessidades dos desenvolvedores forem atendidas, isso criará uma condição de ecossistema onde os desenvolvedores poderão facilmente criar novos scripts, integrações e ferramentas e compartilhá-los com a comunidade da plataforma na forma de amostras de código, bibliotecas e integrações.
Em última análise, o fornecimento de APIs completas e de alta qualidade, documentação robusta e um ecossistema engajado estabelece as bases para a inovação e garante que as soluções de agente possam atingir todo o seu potencial.