NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Perigon connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 Perigon actions, such as "Get News Articles", "Get Companies" and "Get Journalists". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Perigon, with input parameters and output schema.
PERIGON_GET_ARTICLESTool to retrieve a list of news articles based on filters. Use when keywords, sources, or date ranges are specified.
Input parameters
Search query term or phrase
Newest date for articles (YYYY-MM-DD or ISO8601)
Oldest date for articles (YYYY-MM-DD or ISO8601)
Page number (1-indexed)
Order to sort articles
2-letter country code to filter news sources
Comma-separated list of domain names to include
Comma-separated list of source IDs
Article category, e.g., technology, sports
2-letter language code, e.g., 'en'
Number of results per page (1-100)
Comma-separated list of domain names to exclude
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_COMPANIESTool to retrieve information on companies in Perigon’s entity database. Use when you need a full list of companies. Use after confirming a valid API key is present.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_JOURNALISTSTool to retrieve journalist profiles including title, Twitter handle, bio, and location. Use when you need detailed journalist info to enrich content with author metadata.
Input parameters
Number of items to return (default: 10, max: 100)
Search string for journalist name
Number of items to skip for pagination
Filter journalists by outlet name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_SOURCESTool to retrieve a list of media sources with filtering options. Use when you need to list sources by domain, country, category, or traffic metrics.
Input parameters
Page number for pagination (default: 1)
Filter by domain of the source (e.g., cnn.com)
Filter by country code (ISO-3166-1 alpha-2, e.g., US)
Filter by category of the source
Filter by language code (ISO-639-1, e.g., en)
Results per page (default: 10, max: 100)
Filter for sources with maximum stories per month
Filter for sources with a maximum SimilarWeb global rank
Filter for sources with minimum stories per month
Filter for sources with a minimum SimilarWeb global rank
Comma-separated list of domains to exclude
Comma-separated list of domains to include
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_STORIESTool to retrieve clusters of related articles covering the same event or topic with aggregate metrics. Use when you need to fetch filtered and sorted story clusters after configuring query parameters.
Input parameters
Search query keywords or phrases
Comma-separated story IDs
Page number for pagination
Story type, e.g., 'story', 'opinion', 'analysis'
Only stories with images
Only stories with videos
Comma-separated domains to filter by
Sort method for story results (default: createdAt)
Only show stories in a given cluster
Country code, e.g., 'us'
Exclude comma-separated story IDs
Only paywalled or non-paywalled content
Comma-separated source IDs to filter by
End date for filtering stories in ISO 8601 format
News category, e.g., 'sports'
Language code, e.g., 'en'
Start date for filtering stories in ISO 8601 format
Maximum Perigon story score
Minimum Perigon story score
Filter by sentiment
Minimum clustering score
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_TOPICSTool to retrieve all available Perigon news topics. Returns a list of topics that can be used to filter articles or stories. Each topic includes an ID, name, and labels (category/subcategory).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_GET_WIKIPEDIATool to search and filter Wikipedia pages. Use when you have a search query ready and want to retrieve relevant Wikipedia articles.
Input parameters
Search query for the Wikipedia articles
Page number for pagination (default: 1)
Number of results per page (default: 10, maximum: 100)
Two-letter Wikipedia language code (e.g., 'en', 'es')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_VECTOR_SEARCH_ARTICLESTool to perform a vector search on Perigon’s real-time news database. Use when you need to retrieve semantically similar news articles given a natural language query.
Input parameters
Natural language search text to vectorize and find similar articles
Number of top results to return, must be >=1
Optional filters to narrow down results (source, category, language)
Advanced vector search options like model override
Whether to include article vectors in response
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PERIGON_VECTOR_SEARCH_WIKIPEDIATool to perform semantic retrieval of Wikipedia pages using vector search. Use after obtaining a search query to find relevant Wikipedia articles.
Input parameters
Maximum number of results to return (default: 10)
Search query for Wikipedia pages
Whether to include context passages in the response
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 9 Perigon actions on Nagent, including "Get News Articles", "Get Companies" and "Get Journalists". Get News Articles: Retrieve a list of news articles based on filters. Each action is listed on this page with its input parameters and its output.
Perigon connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 12 optional inputs: q, to, from, page, sortBy, country, domains, sources, category, language, pageSize and excludeDomains. It returns data, error and successful.