# Receba uma solicitação de um AgentCore gateway
Para obter um prompt específico, faça uma solicitação POST para o endpoint MCP do gateway e especifique `prompts/get` como método no corpo da solicitação, nome do prompt e os argumentos:
```
POST /mcp HTTP/1.1
Host: ${GatewayEndpoint}
Content-Type: application/json
Authorization: ${Authorization header}
${RequestBody}
```
Substitua os valores a seguir:
+ `${GatewayEndpoint}`— O URL do gateway, conforme fornecido na resposta da [CreateGateway](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateGateway.html)API.
+ `${Authorization header}`— As credenciais de autorização do provedor de identidade quando você configura a autorização de [entrada](gateway-inbound-auth.md).
+ `${RequestBody}`— A carga JSON do corpo da solicitação, conforme especificado em [Obter um prompt](https://modelcontextprotocol.io/specification/2025-06-18/server/prompts#getting-a-prompt) no [Model Context Protocol (MCP](https://modelcontextprotocol.io/docs/getting-started/intro)). Inclua `prompts/get` como `method` e inclua o `name` do prompt e seu`arguments`.
A resposta retorna o prompt renderizado como uma matriz de mensagens, cada uma com uma função e um conteúdo.
**nota**
A `prompts/get` operação envia por proxy a solicitação ao vivo para o servidor MCP downstream. O nome do prompt deve incluir o prefixo de destino (por exemplo,`myTarget___myPrompt`).
## Exemplos de código para obter um prompt
Para ver exemplos de como receber um prompt do gateway, selecione um dos seguintes métodos:
**Example**
1. A solicitação curl a seguir mostra um exemplo de solicitação para receber um prompt chamado `myTarget___code_review` por meio de um gateway com o ID`mygateway-abcdefghij`.
```
curl -X POST \
https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
"jsonrpc": "2.0",
"id": "get-prompt-request",
"method": "prompts/get",
"params": {
"name": "myTarget___code_review",
"arguments": {
"language": "python",
"code": "print(\"hello\")"
}
}
}'
```
1.
```
import requests
import json
def get_prompt(gateway_url, access_token, prompt_name, arguments):
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {access_token}"
}
payload = {
"jsonrpc": "2.0",
"id": "get-prompt-request",
"method": "prompts/get",
"params": {
"name": prompt_name,
"arguments": arguments
}
}
response = requests.post(gateway_url, headers=headers, json=payload)
return response.json()
# Example usage
gateway_url = "https://${GatewayEndpoint}/mcp" # Replace with your actual gateway endpoint
access_token = "${AccessToken}" # Replace with your actual access token
result = get_prompt(
gateway_url,
access_token,
"myTarget___code_review", # Replace with {targetName}___{promptName}
{"language": "python", "code": "print('hello')"}
)
print(json.dumps(result, indent=2))
```
1.
```
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
import asyncio
async def execute_mcp(
url,
token,
prompt_name,
prompt_arguments,
headers=None
):
default_headers = {
"Authorization": f"Bearer {token}"
}
headers = {**default_headers, **(headers or {})}
async with streamablehttp_client(
url=url,
headers=headers,
) as (
read_stream,
write_stream,
callA,
):
async with ClientSession(read_stream, write_stream) as session:
# 1. Perform initialization handshake
print("Initializing MCP...")
_init_response = await session.initialize()
print(f"MCP Server Initialize successful! - {_init_response}")
# 2. Get specific prompt
print(f"Getting prompt: {prompt_name}")
prompt_response = await session.get_prompt(
name=prompt_name,
arguments=prompt_arguments
)
print(f"Prompt response: {prompt_response}")
return prompt_response
async def main():
url = "https://${GatewayEndpoint}/mcp"
token = "your_bearer_token_here"
prompt_name = "myTarget___code_review"
prompt_arguments = {
"language": "python",
"code": "print('hello')"
}
await execute_mcp(
url=url,
token=token,
prompt_name=prompt_name,
prompt_arguments=prompt_arguments
)
if __name__ == "__main__":
asyncio.run(main())
```
1. NOTA: O suporte imediato do adaptador LangGraph MCP pode variar. Use a abordagem MCP Client acima para obter a `prompts/get` implementação mais confiável.
```
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async def get_prompt(url, token, prompt_name, arguments):
headers = {"Authorization": f"Bearer {token}"}
async with streamablehttp_client(url=url, headers=headers) as (
read_stream, write_stream, callA
):
async with ClientSession(read_stream, write_stream) as session:
await session.initialize()
response = await session.get_prompt(
name=prompt_name,
arguments=arguments
)
for message in response.messages:
print(f"{message.role}: {message.content}")
asyncio.run(get_prompt(
"https://${GatewayEndpoint}/mcp",
"${AccessToken}",
"myTarget___code_review",
{"language": "python", "code": "print('hello')"}
))
```
## Erros
A `prompts/get` operação pode retornar os seguintes tipos de erros:
+ Erros retornados como parte do código de status HTTP:
**AuthenticationError**
A solicitação falhou devido a credenciais de autenticação inválidas.
**Código de status HTTP**: 401
**AuthorizationError**
O chamador não tem permissão para receber a solicitação.
**Código de status HTTP**: 403
**ResourceNotFoundError**
O prompt especificado não existe.
**Código de status HTTP**: 404
**ValidationError**
Os argumentos fornecidos não satisfazem os argumentos exigidos do prompt.
**Código de status HTTP**: 400
**InternalServerError**
Ocorreu um erro interno do servidor.
**Código de status HTTP**: 500
+ Erros de MCP. Para obter mais informações sobre esses tipos de erros, consulte [Solicitações na documentação](https://modelcontextprotocol.io/specification/2025-06-18/server/prompts) do [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro).