/agents
Get Agent Metadata
/datastores
/datastores/{id}/documents
/agents
/agents/{id}/query
/agents/{id}/evaluate
/agents/{id}/datasets/evaluate
/agents/{id}/datasets/tune
/agents/{id}/tune
/lmunit
/generate
/rerank
/agents
Get Agent Metadata
Get metadata and configuration of a given Agent
.
GET
/
agents
/
{agent_id}
/
metadata
curl --request GET \
--url https://api.contextual.ai/v1/agents/{agent_id}/metadata \
--header 'Authorization: Bearer <token>'
{
"name": "<string>",
"description": "<string>",
"datastore_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"system_prompt": "<string>",
"filter_prompt": "<string>",
"no_retrieval_system_prompt": "<string>",
"llm_model_id": "<string>",
"suggested_queries": [
"<string>"
],
"agent_configs": {
"retrieval_config": {
"top_k_retrieved_chunks": 123,
"lexical_alpha": 123,
"semantic_alpha": 123
},
"filter_and_rerank_config": {
"top_k_reranked_chunks": 123,
"reranker_score_filter_threshold": 0,
"rerank_instructions": "<string>"
},
"generate_response_config": {
"max_new_tokens": 123,
"temperature": 123,
"top_p": 123,
"frequency_penalty": 123,
"seed": 123,
"calculate_groundedness": true,
"avoid_commentary": false
},
"global_config": {
"enable_rerank": true,
"enable_filter": true,
"enable_multi_turn": true,
"should_check_retrieval_need": true
}
},
"agent_usages_and_limits": {
"query": [
"<any>"
],
"tune": [
"<any>"
],
"eval": [
"<any>"
]
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
ID of the agent for which to retrieve details
Response
200
application/json
Successful Response
Response to GET Agent request
Response to GET Agent request
Response to GET Agent request
Was this page helpful?
curl --request GET \
--url https://api.contextual.ai/v1/agents/{agent_id}/metadata \
--header 'Authorization: Bearer <token>'
{
"name": "<string>",
"description": "<string>",
"datastore_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"system_prompt": "<string>",
"filter_prompt": "<string>",
"no_retrieval_system_prompt": "<string>",
"llm_model_id": "<string>",
"suggested_queries": [
"<string>"
],
"agent_configs": {
"retrieval_config": {
"top_k_retrieved_chunks": 123,
"lexical_alpha": 123,
"semantic_alpha": 123
},
"filter_and_rerank_config": {
"top_k_reranked_chunks": 123,
"reranker_score_filter_threshold": 0,
"rerank_instructions": "<string>"
},
"generate_response_config": {
"max_new_tokens": 123,
"temperature": 123,
"top_p": 123,
"frequency_penalty": 123,
"seed": 123,
"calculate_groundedness": true,
"avoid_commentary": false
},
"global_config": {
"enable_rerank": true,
"enable_filter": true,
"enable_multi_turn": true,
"should_check_retrieval_need": true
}
},
"agent_usages_and_limits": {
"query": [
"<any>"
],
"tune": [
"<any>"
],
"eval": [
"<any>"
]
}
}