Skip to main content
This glossary aligns Agent-to-Agent (A2A) vocabulary with what you see in Graph Studio, Agent Registry, and the gateway. For protocol details beyond Phinite, see the official A2A protocol specification.

Industry terminology map

Industry / A2A termPhinite UI / APIMeaning
Agent CardAgent Card (wizard step 3)Public identity: name, description, skills, tags, visibility
Agent RegistryAgent Registry sidebarWorkspace catalog of registered A2A agents
A2A endpoint / Hosted agent URL/api/v1/ai/a2a/{flowId} or .../{registryId}Callable agent over the Agent-to-Agent protocol
SkillsSkills in wizardCallable capabilities with input/output MIME modes
Discoverability tagsDiscoverability TagsMetadata for search and Discovery filters
Deployment statusTest / Live badgestest = validation build; live = production (one live per flow per workspace)
VisibilityPublic / Organisationpublic = any A2A client with a valid API key; organization = same organisation only
Promote to LiveAgent Cards / promote actionPUT .../promote-live — demotes other live builds for the same flow
Browse modeBrowse tab on agent nodeMaster agent calls a specific registry agent
Discovery modeDiscovery tab on agent nodeMaster agent auto-selects agents matching saved filters at runtime
Agent GraphFlowThe workflow backing the registered agent

Phinite Connector (Claude)

Terms used when calling registry agents from Claude via the Phinite Connector:
TermMeaning
Phinite ConnectorClaude plugin that authenticates to Phinite and exposes registry tools
list_agentsReturns up to 50 published agents in your organisation (unfiltered browse)
discover_agentsNatural-language search over agent name, description, and skills; optional status (live / test) and limit
call_agentSends a message to an agent by registry_id; optional task_id for multi-turn context
task_idA2A task identifier returned on first call_agent response; pass on follow-ups to continue the same conversation
Credential setup linkURL to /public/agent-config when an agent needs integration credentials before running

UI labels vs documentation terms

Product UI labelPreferred docs termWhere it appears
Agent BlockAgent NodeBrowse / Discovery panel when attaching registry agents on the canvas
FlowAgent GraphProject and Studio navigation (same underlying workflow)
OrganisationOrganisationRegistry filters and Agent Card visibility (British spelling in UI)
When writing integrations or internal runbooks, prefer Agent Node and Agent Graph for consistency with Graph Studio agent nodes documentation.

MIME input and output modes

Skills and registry filters declare which content types an agent accepts and returns. Phinite supports the following MIME types in Agent Registry filters and skill configuration:
MIME typeTypical use
text/plainPlain text messages
text/markdownMarkdown-formatted text
text/htmlHTML content
application/jsonStructured JSON payloads
application/pdfPDF documents
application/octet-streamBinary or opaque payloads
image/png, image/jpeg, image/webpImage inputs or outputs
video/mp4Video content
audio/mpeg, audio/wav, audio/ogg, audio/aac, audio/mp4Audio content
Input modes describe what callers may send to a skill; output modes describe what the agent may return. Discovery mode on an agent node can filter registry agents by matching input and output MIME modes at runtime.

Invoke from Claude

Install the connector, discover agents, and manage credentials.

Overview

End-to-end Agent Registry concepts and workflow.

Endpoints & lifecycle

Hosted URL patterns, test vs live, and promotion.

Registry agent nodes

Browse vs Discovery on the canvas.

Platform glossary

Broader Phinite terminology (assistants, builds, tools).