Kit de ferramentas do Code Assist para a Plataforma Google Maps (experimental)

O kit de ferramentas do Google Maps Platform Code Assist é um servidor do Protocolo de Contexto de Modelo (MCP) que melhora as respostas de modelos de linguagem grandes (LLMs) usados para desenvolver aplicativos com a Plataforma Google Maps. Ele funciona fundamentando as respostas na documentação e nos exemplos de código oficiais e atualizados.

Como o servidor MCP acessa o conteúdo quando o modelo é solicitado, o contexto do LLM em relação à Plataforma Google Maps não precisa ser limitado aos dados disponíveis na data de treinamento do modelo.

Os recursos da Plataforma Google Maps que o servidor MCP pode acessar incluem:

  • Documentação da Plataforma Google Maps
  • Termos de Serviço da Plataforma Google Maps
  • Central de confiança da Plataforma Google Maps
  • Repositórios de código nas organizações oficiais do GitHub da Plataforma Google Maps

Ferramentas

O Maps Code Assist oferece ferramentas que permitem que os LLMs acessem os seguintes recursos:

  • retrieve-instructions: uma ferramenta auxiliar usada pelo cliente para receber instruções importantes do sistema sobre como raciocinar melhor sobre a intenção do usuário e formular chamadas eficazes para a ferramenta retrieve-google-maps-platform-docs.
  • retrieve-google-maps-platform-docs: a ferramenta principal. Ela recebe uma consulta em linguagem natural e a envia para um mecanismo de geração aumentada por recuperação (RAG, na sigla em inglês) hospedado. O mecanismo RAG pesquisa versões recentes da documentação oficial, tutoriais e exemplos de código da Plataforma Google Maps, retornando o contexto relevante para o LLM, para que ele gere uma resposta precisa.

Faturamento

Não há cobrança pelo uso do Maps Code Assist enquanto ele estiver na fase experimental.

Políticas e Termos de Serviço

O Maps Code Assist está sujeito aos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos do serviço. Esta seção descreve outros requisitos de uso do serviço para o Maps Code Assist, incluindo LLMs compatíveis e requisitos de atribuição de origem.

Requisitos para LLMs compatíveis

Só é possível usar o Maps Code Assist com um LLM que esteja em conformidade com os Termos de Serviço da Plataforma Google Maps.

Por exemplo, você é responsável por garantir que o conteúdo do Google Maps não seja armazenado em cache, armazenado ou usado para melhorar o LLM escolhido. Antes de usar o Maps Code Assist, revise os Termos de Serviço de qualquer modelo que você pretende usar com ele. Não use o Maps Code Assist com modelos que usam os dados inseridos no modelo para treinamento de modelo ou melhoria. Você é responsável por garantir que o uso do modelo esteja totalmente em conformidade com as restrições de conteúdo do Google Maps nos Termos de Serviço da Plataforma Google Maps, incluindo os termos específicos do serviço.

Requisitos de atribuição para fontes do Google Maps

Ao apresentar resultados que usam ferramentas fornecidas pelo Maps Code Assist, inclua as fontes associadas do Google Maps.

Configurar LLMs para acessar o servidor MCP do Maps Code Assist

É possível configurar LLMs para acessar o servidor MCP seguindo a documentação de configuração do MCP correspondente e usando o endpoint do servidor MCP do Code Assist: https://mapscodeassist.googleapis.com/mcp.

O servidor MCP do Maps Code Assist usa o transporte HTTP transmissível. Para mais informações, consulte Configurar o MCP em um aplicativo de IA.

Exemplos de casos de uso

Depois de configurado, você pode fazer perguntas ao LLM sobre a Plataforma Google Maps. Veja alguns comandos de exemplo:

  • Como faço para adicionar um mapa ao meu app Android?
  • "Qual é a melhor maneira de acessar a localização atual do usuário em um mapa no iOS?"
  • "Forneça um exemplo de uso do serviço Directions na API Maps JavaScript."

Ferramentas disponíveis

Para conferir detalhes das ferramentas MCP disponíveis e as descrições delas para o servidor MCP do Maps Code Assist, consulte a referência do MCP do Maps Code Assist.

Listar ferramentas com uma solicitação HTTP

Para verificar se o servidor está funcionando e conferir uma lista de ferramentas disponíveis, envie uma solicitação HTTP tools/list diretamente para o servidor MCP remoto do Maps Code Assist. O método tools/list não exige autenticação.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": "1"
  }' \
  https://mapscodeassist.googleapis.com/mcp

Compartilhar feedback

Para compartilhar feedback sobre o Maps Code Assist, use os seguintes formulários: